cnb

Documentation

Index

• Constants
• func CompressBuildMetadata(metadata *BuildMetadata) ([]byte, error)
• func ProcessProjectDescriptor(appDir, descriptorPath, platformDir string, logger *log.Logger) error
• func SetupPlatformEnvVars(dir string) error
• type APISet
• type APIVersions
• type BuildMetadata
  • func DecompressBuildMetadata(compressedMetadata string) (*BuildMetadata, error)
• type BuilderImageMetadata
• type BuildpackLayerInfo
• type BuildpackLayerMetadata
• type BuildpackRepository
• type BuildpackageMetadata
• type CreatorMetadata
• type DescriptiveBuildpackInfo
• type ImageFetcher
• type LifecycleAPI
• type LifecycleAPIs
• type LifecycleDescriptor
• type LifecycleInfo
• type LifecycleMetadata
• type LifecycleProvider
• type NewBuildpackRepository
• type RegistryClient
• type RemoteBuilderCreator
  • func (r *RemoteBuilderCreator) CreateBuilder(keychain authn.Keychain, clusterStore *buildapi.ClusterStore, ...) (buildapi.BuilderRecord, error)
• type RemoteBuildpackInfo
  • func (i RemoteBuildpackInfo) Optional(optional bool) RemoteBuildpackRef
• type RemoteBuildpackRef
• type RemoteMetadataRetriever
  • func (r *RemoteMetadataRetriever) GetBuildMetadata(builtImageRef, cacheTag string, keychain authn.Keychain) (*BuildMetadata, error)
• type RemoteStackReader
  • func (r *RemoteStackReader) Read(keychain authn.Keychain, clusterStackSpec buildapi.ClusterStackSpec) (buildapi.ResolvedClusterStack, error)
• type RemoteStoreReader
  • func (r *RemoteStoreReader) Read(keychain authn.Keychain, storeImages []corev1alpha1.StoreImage) ([]corev1alpha1.StoreBuildpack, error)
• type RunImageAppMetadata
• type RunImageMetadata
• type Stack
• type StackMetadata
• type StoreBuildpackRepository
  • func (s *StoreBuildpackRepository) FindByIdAndVersion(id, version string) (RemoteBuildpackInfo, error)

Constants

const (
	MixinsLabel = "io.buildpacks.stack.mixins"
	StackLabel  = "io.buildpacks.stack.id"
)

Functions

func CompressBuildMetadata

func CompressBuildMetadata(metadata *BuildMetadata) ([]byte, error)

func ProcessProjectDescriptor

func ProcessProjectDescriptor(appDir, descriptorPath, platformDir string, logger *log.Logger) error

func SetupPlatformEnvVars

func SetupPlatformEnvVars(dir string) error

Types

type APISet

type APISet []string

type APIVersions

type APIVersions struct {
	Deprecated APISet `toml:"deprecated" json:"deprecated"`
	Supported  APISet `toml:"supported" json:"supported"`
}

type BuildMetadata

type BuildMetadata struct {
	BuildpackMetadata corev1alpha1.BuildpackMetadataList `json:"buildpackMetadata"`
	LatestCacheImage  string                             `json:"latestCacheImage"`
	LatestImage       string                             `json:"latestImage"`
	StackID           string                             `json:"stackID"`
	StackRunImage     string                             `json:"stackRunImage"`
}

func DecompressBuildMetadata

func DecompressBuildMetadata(compressedMetadata string) (*BuildMetadata, error)

type BuilderImageMetadata

type BuilderImageMetadata struct {
	Description string                     `json:"description"`
	Stack       StackMetadata              `json:"stack"`
	Lifecycle   LifecycleMetadata          `json:"lifecycle"`
	CreatedBy   CreatorMetadata            `json:"createdBy"`
	Buildpacks  []DescriptiveBuildpackInfo `json:"buildpacks"`
}

type BuildpackLayerInfo

type BuildpackLayerInfo struct {
	API         string                        `json:"api"`
	LayerDiffID string                        `json:"layerDiffID"`
	Order       corev1alpha1.Order            `json:"order,omitempty"`
	Stacks      []corev1alpha1.BuildpackStack `json:"stacks,omitempty"`
	Homepage    string                        `json:"homepage,omitempty"`
}

type BuildpackLayerMetadata

type BuildpackLayerMetadata map[string]map[string]BuildpackLayerInfo

type BuildpackRepository

type BuildpackRepository interface {
	FindByIdAndVersion(id, version string) (RemoteBuildpackInfo, error)
}

type BuildpackageMetadata

type BuildpackageMetadata struct {
	Id       string `json:"id"`
	Version  string `json:"version"`
	Homepage string `json:"homepage"`
}

type CreatorMetadata

type CreatorMetadata struct {
	Name    string `json:"name"`
	Version string `json:"version"`
}

type DescriptiveBuildpackInfo

type DescriptiveBuildpackInfo struct {
	corev1alpha1.BuildpackInfo
	Homepage string `json:"homepage,omitempty"`
}

type ImageFetcher

type ImageFetcher interface {
	Fetch(keychain authn.Keychain, repoName string) (ggcrv1.Image, string, error)
}

type LifecycleAPI

type LifecycleAPI struct {
	BuildpackVersion string `toml:"buildpack" json:"buildpack,omitempty"`
	PlatformVersion  string `toml:"platform" json:"platform,omitempty"`
}

type LifecycleAPIs

type LifecycleAPIs struct {
	Buildpack APIVersions `toml:"buildpack" json:"buildpack"`
	Platform  APIVersions `toml:"platform" json:"platform"`
}

type LifecycleDescriptor

type LifecycleDescriptor struct {
	Info LifecycleInfo `toml:"lifecycle"`

	// Deprecated: Use `LifecycleAPIs` instead
	API  LifecycleAPI  `toml:"api" json:"api,omitempty"`
	APIs LifecycleAPIs `toml:"apis" json:"apis,omitempty"`
}

type LifecycleInfo

type LifecycleInfo struct {
	Version string `toml:"version" json:"version"`
}

type LifecycleMetadata

type LifecycleMetadata struct {
	LifecycleInfo

	// Deprecated: Use `LifecycleAPIs` instead
	API  LifecycleAPI  `json:"api,omitempty"`
	APIs LifecycleAPIs `json:"apis,omitempty"`
}

type LifecycleProvider

type LifecycleProvider interface {
	LayerForOS(os string) (v1.Layer, LifecycleMetadata, error)
}

type NewBuildpackRepository

type NewBuildpackRepository func(clusterStore *buildapi.ClusterStore) BuildpackRepository

type RegistryClient

type RegistryClient interface {
	Fetch(keychain authn.Keychain, repoName string) (v1.Image, string, error)
	Save(keychain authn.Keychain, tag string, image v1.Image) (string, error)
}

type RemoteBuilderCreator

type RemoteBuilderCreator struct {
	RegistryClient         RegistryClient
	NewBuildpackRepository NewBuildpackRepository
	LifecycleProvider      LifecycleProvider
	KpackVersion           string
}

func (*RemoteBuilderCreator) CreateBuilder

func (r *RemoteBuilderCreator) CreateBuilder(keychain authn.Keychain, clusterStore *buildapi.ClusterStore, clusterStack *buildapi.ClusterStack, spec buildapi.BuilderSpec) (buildapi.BuilderRecord, error)

type RemoteBuildpackInfo

type RemoteBuildpackInfo struct {
	BuildpackInfo DescriptiveBuildpackInfo
	Layers        []buildpackLayer
}

func (RemoteBuildpackInfo) Optional

func (i RemoteBuildpackInfo) Optional(optional bool) RemoteBuildpackRef

type RemoteBuildpackRef

type RemoteBuildpackRef struct {
	DescriptiveBuildpackInfo DescriptiveBuildpackInfo
	Optional                 bool
	Layers                   []buildpackLayer
}

type RemoteMetadataRetriever

type RemoteMetadataRetriever struct {
	ImageFetcher ImageFetcher
}

func (*RemoteMetadataRetriever) GetBuildMetadata

func (r *RemoteMetadataRetriever) GetBuildMetadata(builtImageRef, cacheTag string, keychain authn.Keychain) (*BuildMetadata, error)

type RemoteStackReader

type RemoteStackReader struct {
	RegistryClient RegistryClient
}

func (*RemoteStackReader) Read

func (r *RemoteStackReader) Read(keychain authn.Keychain, clusterStackSpec buildapi.ClusterStackSpec) (buildapi.ResolvedClusterStack, error)

type RemoteStoreReader

type RemoteStoreReader struct {
	RegistryClient RegistryClient
}

func (*RemoteStoreReader) Read

func (r *RemoteStoreReader) Read(keychain authn.Keychain, storeImages []corev1alpha1.StoreImage) ([]corev1alpha1.StoreBuildpack, error)

type RunImageAppMetadata

type RunImageAppMetadata struct {
	TopLayer  string `json:"topLayer" toml:"top-layer"`
	Reference string `json:"reference" toml:"reference"`
}

type RunImageMetadata

type RunImageMetadata struct {
	Image   string   `json:"image" toml:"image"`
	Mirrors []string `json:"mirrors" toml:"mirrors"`
}

type Stack

type Stack struct {
	ID     string   `json:"id"`
	Mixins []string `json:"mixins,omitempty"`
}

type StackMetadata

type StackMetadata struct {
	RunImage RunImageMetadata `json:"runImage" toml:"run-image"`
}

type StoreBuildpackRepository

type StoreBuildpackRepository struct {
	Keychain authn.Keychain

	ClusterStore *buildapi.ClusterStore
}

func (*StoreBuildpackRepository) FindByIdAndVersion

func (s *StoreBuildpackRepository) FindByIdAndVersion(id, version string) (RemoteBuildpackInfo, error)