buildpack

package
v0.30.0-rc1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Aug 5, 2023 License: Apache-2.0 Imports: 36 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	KindBuildpack = "buildpack"
	KindExtension = "extension"
)
View Source 
const (
	FlattenMaxDepth = -1
	FlattenNone     = 0
)
View Source 
const MetadataLabel = "io.buildpacks.buildpackage.metadata"

TODO: Move to dist

Variables

This section is empty.

Functions

func BuildpacksFromOCILayoutBlob 

func BuildpacksFromOCILayoutBlob(blob Blob) (mainBP BuildModule, dependencies []BuildModule, err error)

BuildpacksFromOCILayoutBlob constructs buildpacks from a blob in OCI layout format.

func ConfigFromOCILayoutBlob 

func ConfigFromOCILayoutBlob(blob Blob) (config v1.ImageConfig, err error)

func HasDockerLocator 

func HasDockerLocator(locator string) bool

func IsOCILayoutBlob 

func IsOCILayoutBlob(blob blob2.Blob) (bool, error)

IsOCILayoutBlob checks whether a blob is in OCI layout format.

func NewDownloader 

func NewDownloader(logger Logger, imageFetcher ImageFetcher, downloader Downloader, registryResolver RegistryResolver) *buildpackDownloader

func ParseIDLocator 

func ParseIDLocator(locator string) (id string, version string)

ParseIDLocator parses a buildpack locator in the following formats into its ID and version.

  • <id>[@<version>]
  • urn:cnb:builder:<id>[@<version>]
  • urn:cnb:registry:<id>[@<version>]
  • from=builder:<id>[@<version>] (deprecated)

If version is omitted, the version returned will be empty. Any "from=builder:" or "urn:cnb" prefix will be ignored.

func ParsePackageLocator 

func ParsePackageLocator(locator string) (imageName string)

ParsePackageLocator parses a locator (in format `[docker://][<host>/]<path>[:<tag>⏐@<digest>]`) to image name (`[<host>/]<path>[:<tag>⏐@<digest>]`)

func ParseRegistryID 

func ParseRegistryID(registryID string) (namespace string, name string, version string, err error)

ParseRegistryID parses a registry id (ie. `<namespace>/<name>@<version>`) into namespace, name and version components.

Supported formats:

  • <ns>/<name>[@<version>]
  • urn:cnb:registry:<ns>/<name>[@<version>]

func Set added in v0.30.0 

func Set(exclude []string) map[string]struct{}

Set returns a set of the given string slice.

func ToLayerTar 

func ToLayerTar(dest string, module BuildModule) (string, error)

Types

type Blob 

type Blob interface {
	// Open returns a io.ReadCloser for the contents of the Blob in tar format.
	Open() (io.ReadCloser, error)
}

type BuildModule added in v0.28.0 

type BuildModule interface {
	// Open returns a reader to a tar with contents structured as per the distribution spec
	// (currently '/cnb/buildpacks/{ID}/{version}/*', all entries with a zeroed-out
	// timestamp and root UID/GID).
	Open() (io.ReadCloser, error)
	Descriptor() Descriptor
}

func ExtensionsFromOCILayoutBlob added in v0.28.0 

func ExtensionsFromOCILayoutBlob(blob Blob) (mainExt BuildModule, err error)

ExtensionsFromOCILayoutBlob constructs extensions from a blob in OCI layout format.

func FromBlob 

func FromBlob(descriptor Descriptor, blob Blob) BuildModule

FromBlob constructs a buildpack or extension from a blob. It is assumed that the buildpack contents are structured as per the distribution spec (currently '/cnb/buildpacks/{ID}/{version}/*' or '/cnb/extensions/{ID}/{version}/*').

func FromBuildpackRootBlob added in v0.28.0 

func FromBuildpackRootBlob(blob Blob, layerWriterFactory archive.TarWriterFactory) (BuildModule, error)

FromBuildpackRootBlob constructs a buildpack from a blob. It is assumed that the buildpack contents reside at the root of the blob. The constructed buildpack contents will be structured as per the distribution spec (currently a tar with contents under '/cnb/buildpacks/{ID}/{version}/*').

func FromExtensionRootBlob added in v0.28.0 

func FromExtensionRootBlob(blob Blob, layerWriterFactory archive.TarWriterFactory) (BuildModule, error)

FromExtensionRootBlob constructs an extension from a blob. It is assumed that the extension contents reside at the root of the blob. The constructed extension contents will be structured as per the distribution spec (currently a tar with contents under '/cnb/extensions/{ID}/{version}/*').

type BuildModuleWriter added in v0.30.0 

type BuildModuleWriter struct {
	// contains filtered or unexported fields
}

func NewBuildModuleWriter added in v0.30.0 

func NewBuildModuleWriter(logger logging.Logger, factory archive.TarWriterFactory) *BuildModuleWriter

NewBuildModuleWriter creates a BuildModule writer

func (*BuildModuleWriter) NToLayerTar added in v0.30.0 

func (b *BuildModuleWriter) NToLayerTar(tarPath, filename string, modules []BuildModule, exclude map[string]struct{}) (string, []BuildModule, error)

NToLayerTar creates a tar file containing the all the Buildpacks given, but excluding the ones which FullName() is in the exclude list. It returns the path to the tar file, the list of Buildpacks that were excluded, and any error

type Descriptor added in v0.28.0 

type Descriptor interface {
	API() *api.Version
	EnsureStackSupport(stackID string, providedMixins []string, validateRunStageMixins bool) error
	EnsureTargetSupport(os, arch, distroName, distroVersion string) error
	EscapedID() string
	Info() dist.ModuleInfo
	Kind() string
	Order() dist.Order
	Stacks() []dist.Stack
	Targets() []dist.Target
}

type DownloadOptions 

type DownloadOptions struct {
	// Buildpack registry name. Defines where all registry buildpacks will be pulled from.
	RegistryName string

	// The base directory to use to resolve relative assets
	RelativeBaseDir string

	// The OS of the builder image
	ImageOS string

	// Deprecated: the older alternative to buildpack URI
	ImageName string

	// The kind of module to download (valid values: "buildpack", "extension"). Defaults to "buildpack".
	ModuleKind string

	Daemon bool

	PullPolicy image.PullPolicy
}

type Downloader 

type Downloader interface {
	Download(ctx context.Context, pathOrURI string) (blob.Blob, error)
}

type ImageFactory 

type ImageFactory interface {
	NewImage(repoName string, local bool, imageOS string) (imgutil.Image, error)
}

type ImageFetcher 

type ImageFetcher interface {
	Fetch(ctx context.Context, name string, options image.FetchOptions) (imgutil.Image, error)
}

type LocatorType 

type LocatorType int
const (
	InvalidLocator LocatorType = iota
	FromBuilderLocator
	URILocator
	IDLocator
	PackageLocator
	RegistryLocator
)

func GetLocatorType 

func GetLocatorType(locator string, relativeBaseDir string, buildpacksFromBuilder []dist.ModuleInfo) (LocatorType, error)

GetLocatorType determines which type of locator is designated by the given input. If a type cannot be determined, `INVALID_LOCATOR` will be returned. If an error is encountered, it will be returned.

func (LocatorType) String 

func (l LocatorType) String() string

type Logger 

type Logger interface {
	Debug(msg string)
	Debugf(fmt string, v ...interface{})
	Info(msg string)
	Infof(fmt string, v ...interface{})
	Warn(msg string)
	Warnf(fmt string, v ...interface{})
	Error(msg string)
	Errorf(fmt string, v ...interface{})
}

type ManagedCollection added in v0.30.0 

type ManagedCollection struct {
	// contains filtered or unexported fields
}

func NewModuleManager added in v0.30.0 

func NewModuleManager(flatten bool, maxDepth int) *ManagedCollection

func (*ManagedCollection) AddModules added in v0.30.0 

func (f *ManagedCollection) AddModules(main BuildModule, deps ...BuildModule)

AddModules determines whether the explodedModules must be added as flattened or not. It uses flatten and maxDepth configuration given during initialization of the manager.

func (*ManagedCollection) AllModules added in v0.30.0 

func (f *ManagedCollection) AllModules() []BuildModule

AllModules returns all explodedModules handle by the manager

func (*ManagedCollection) ExplodedModules added in v0.30.0 

func (f *ManagedCollection) ExplodedModules() []BuildModule

ExplodedModules returns all modules that will be added to the output artifact as a single layer containing a single module.

func (*ManagedCollection) FlattenedModules added in v0.30.0 

func (f *ManagedCollection) FlattenedModules() [][]BuildModule

FlattenedModules returns all modules that will be added to the output artifact as a single layer containing multiple modules.

func (*ManagedCollection) ShouldFlatten added in v0.30.0 

func (f *ManagedCollection) ShouldFlatten(module BuildModule) bool

ShouldFlatten returns true if the given module is flattened.

type Metadata 

type Metadata struct {
	dist.ModuleInfo
	Stacks []dist.Stack `toml:"stacks" json:"stacks"`
}

type ModuleTar added in v0.30.0 

type ModuleTar interface {
	Info() dist.ModuleInfo
	Path() string
}

func ToNLayerTar added in v0.30.0 

func ToNLayerTar(dest string, module BuildModule) ([]ModuleTar, error)

type Package 

type Package interface {
	Label(name string) (value string, err error)
	GetLayer(diffID string) (io.ReadCloser, error)
}

type PackageBuilder 

type PackageBuilder struct {
	// contains filtered or unexported fields
}

func NewBuilder 

func NewBuilder(imageFactory ImageFactory, ops ...PackageBuilderOption) *PackageBuilder

TODO: Rename to PackageBuilder

func (*PackageBuilder) AddDependencies added in v0.30.0 

func (b *PackageBuilder) AddDependencies(main BuildModule, dependencies []BuildModule)

func (*PackageBuilder) AddDependency 

func (b *PackageBuilder) AddDependency(buildpack BuildModule)

func (*PackageBuilder) AllModules added in v0.30.0 

func (b *PackageBuilder) AllModules() []BuildModule

func (*PackageBuilder) FlattenedModules added in v0.30.0 

func (b *PackageBuilder) FlattenedModules() [][]BuildModule

func (*PackageBuilder) SaveAsFile 

func (b *PackageBuilder) SaveAsFile(path, imageOS string) error

func (*PackageBuilder) SaveAsImage 

func (b *PackageBuilder) SaveAsImage(repoName string, publish bool, imageOS string) (imgutil.Image, error)

func (*PackageBuilder) SetBuildpack 

func (b *PackageBuilder) SetBuildpack(buildpack BuildModule)

func (*PackageBuilder) SetExtension added in v0.30.0 

func (b *PackageBuilder) SetExtension(extension BuildModule)

func (*PackageBuilder) ShouldFlatten added in v0.30.0 

func (b *PackageBuilder) ShouldFlatten(module BuildModule) bool

type PackageBuilderOption added in v0.30.0 

type PackageBuilderOption func(*options) error

func WithFlatten added in v0.30.0 

func WithFlatten(depth int, exclude []string) PackageBuilderOption

func WithLayerWriterFactory added in v0.30.0 

func WithLayerWriterFactory(factory archive.TarWriterFactory) PackageBuilderOption

func WithLogger added in v0.30.0 

func WithLogger(logger logging.Logger) PackageBuilderOption

type RegistryResolver 

type RegistryResolver interface {
	Resolve(registryName, bpURI string) (string, error)
}

type WorkableImage 

type WorkableImage interface {
	SetLabel(string, string) error
	AddLayerWithDiffID(path, diffID string) error
}

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.