layer

Documentation

Index

• type Cache
• type DefaultMetadataRestorer
  • func NewDefaultMetadataRestorer(layersDir string, skipLayers bool, logger log.Logger) *DefaultMetadataRestorer
  • func (r *DefaultMetadataRestorer) Restore(buildpacks []buildpack.GroupElement, appMeta files.LayersMetadata, ...) error
• type DefaultSBOMRestorer
  • func (r *DefaultSBOMRestorer) RestoreFromCache(cache Cache, layerDigest string) error
  • func (r *DefaultSBOMRestorer) RestoreFromPrevious(image imgutil.Image, layerDigest string) error
  • func (r *DefaultSBOMRestorer) RestoreToBuildpackLayers(detectedBps []buildpack.GroupElement) error
• type MetadataRestorer
• type NopMetadataRestorer
  • func (r *NopMetadataRestorer) Restore(_ []buildpack.GroupElement, _ files.LayersMetadata, _ platform.CacheMetadata, ...) error
• type NopSBOMRestorer
  • func (r *NopSBOMRestorer) RestoreFromCache(_ Cache, _ string) error
  • func (r *NopSBOMRestorer) RestoreFromPrevious(_ imgutil.Image, _ string) error
  • func (r *NopSBOMRestorer) RestoreToBuildpackLayers(_ []buildpack.GroupElement) error
• type SBOMRestorer
  • func NewSBOMRestorer(opts SBOMRestorerOpts, platformAPI *api.Version) SBOMRestorer
• type SBOMRestorerOpts
• type SHAStore
  • func NewSHAStore() SHAStore

Types

type Cache

type Cache interface {
	RetrieveLayer(sha string) (io.ReadCloser, error)
}

type DefaultMetadataRestorer

type DefaultMetadataRestorer struct {
	LayersDir  string
	SkipLayers bool
	Logger     log.Logger
}

func NewDefaultMetadataRestorer

func NewDefaultMetadataRestorer(layersDir string, skipLayers bool, logger log.Logger) *DefaultMetadataRestorer

func (*DefaultMetadataRestorer) Restore

func (r *DefaultMetadataRestorer) Restore(buildpacks []buildpack.GroupElement, appMeta files.LayersMetadata, cacheMeta platform.CacheMetadata, layerSHAStore SHAStore) error

type DefaultSBOMRestorer

type DefaultSBOMRestorer struct {
	LayersDir string
	Logger    log.Logger
}

func (*DefaultSBOMRestorer) RestoreFromCache

func (r *DefaultSBOMRestorer) RestoreFromCache(cache Cache, layerDigest string) error

func (*DefaultSBOMRestorer) RestoreFromPrevious

func (r *DefaultSBOMRestorer) RestoreFromPrevious(image imgutil.Image, layerDigest string) error

func (*DefaultSBOMRestorer) RestoreToBuildpackLayers

func (r *DefaultSBOMRestorer) RestoreToBuildpackLayers(detectedBps []buildpack.GroupElement) error

type MetadataRestorer

type MetadataRestorer interface {
	Restore(buildpacks []buildpack.GroupElement, appMeta files.LayersMetadata, cacheMeta platform.CacheMetadata, layerSHAStore SHAStore) error
}

MetadataRestorer given a group of buildpacks and metadata from the previous image and cache, will create `<layers>/<buildpack-id>/<layer>.toml` files containing `metadata` that the buildpack previously wrote. Note that layer `types` information is not persisted, as the buildpack must opt in to layer re-use by editing the provided `<layer>.toml` to configure the desired layer type.

type NopMetadataRestorer

type NopMetadataRestorer struct{}

func (*NopMetadataRestorer) Restore

func (r *NopMetadataRestorer) Restore(_ []buildpack.GroupElement, _ files.LayersMetadata, _ platform.CacheMetadata, _ SHAStore) error

type NopSBOMRestorer

type NopSBOMRestorer struct{}

func (*NopSBOMRestorer) RestoreFromCache

func (r *NopSBOMRestorer) RestoreFromCache(_ Cache, _ string) error

func (*NopSBOMRestorer) RestoreFromPrevious

func (r *NopSBOMRestorer) RestoreFromPrevious(_ imgutil.Image, _ string) error

func (*NopSBOMRestorer) RestoreToBuildpackLayers

func (r *NopSBOMRestorer) RestoreToBuildpackLayers(_ []buildpack.GroupElement) error

type SBOMRestorer

type SBOMRestorer interface {
	RestoreFromPrevious(image imgutil.Image, layerDigest string) error
	RestoreFromCache(cache Cache, layerDigest string) error
	RestoreToBuildpackLayers(detectedBps []buildpack.GroupElement) error
}

SBOMRestorer handles the restoration of SBOM layer data. Given a previous image or cache, it will extract the SBOM layer to the local filesystem. Given a group of buildpacks and a `<layers>/sbom/<cache|launch>` directory, it will copy the relevant SBOM files to `<layers>/<buildpack-id>/ so that they can be used in the current build.

func NewSBOMRestorer

func NewSBOMRestorer(opts SBOMRestorerOpts, platformAPI *api.Version) SBOMRestorer

type SBOMRestorerOpts

type SBOMRestorerOpts struct {
	LayersDir string
	Logger    log.Logger
	Nop       bool
}

type SHAStore

type SHAStore interface {
	Get(buildpackID string, layer buildpack.Layer) (string, error)
	// contains filtered or unexported methods
}

func NewSHAStore

func NewSHAStore() SHAStore

NewSHAStore returns a new SHAStore for mapping buildpack IDs to layer names and their SHAs.