cnbutils

Documentation

Overview

Package cnbutils provides utility functions to interact with Buildpacks

Index

• Constants
• func CnbUserInfo() (int, int, error)
• func CopyProject(source, target string, include, exclude *ignore.GitIgnore, utils BuildUtils, ...) error
• func CreateEnvFiles(utils BuildUtils, platformPath string, env map[string]interface{}) error
• func CreateVersionSymlinks(basePath, buildpackDir string, utils BuildUtils) error
• func DigestFromReport(utils BuildUtils) (string, error)
• func DownloadBuildpacks(path string, bpacks []string, dockerCreds string, utils BuildUtils) error
• type BuildPackMetadata
  • func GetMetadata(bpacks []string, utils BuildUtils) ([]BuildPackMetadata, error)
• type BuildSummary
  • func NewBuildSummary(builder string, utils BuildUtils) *BuildSummary
  • func (bs *BuildSummary) Print()
• type BuildUtils
• type DockerKeychain
  • func ParseDockerConfig(config string, utils BuildUtils) (*DockerKeychain, error)
  • func (dk *DockerKeychain) AuthExistsForImage(image string) bool
  • func (dk *DockerKeychain) ToCNBString() (string, error)
• type ImageSummary
  • func (is *ImageSummary) AddEnv(env map[string]interface{})
  • func (is *ImageSummary) Print()
• type License
• type MockUtils
  • func (c *MockUtils) GetFileUtils() piperutils.FileUtils
• type Order
  • func CreateOrder(bpacks, preBpacks, postBpacks []string, dockerCreds string, utils BuildUtils) (Order, error)
  • func (o Order) Save(path string) error
• type OrderEntry
• type TargetImage
  • func GetTargetImage(imageRegistry, imageName, imageTag, projectID, envRootPath string) (*TargetImage, error)

Constants

const DefaultOrderPath = "/cnb/order.toml"

Functions

func CnbUserInfo

func CnbUserInfo() (int, int, error)

func CopyProject

func CopyProject(source, target string, include, exclude *ignore.GitIgnore, utils BuildUtils, follow bool) error

func CreateEnvFiles

func CreateEnvFiles(utils BuildUtils, platformPath string, env map[string]interface{}) error

func CreateVersionSymlinks

func CreateVersionSymlinks(basePath, buildpackDir string, utils BuildUtils) error

func DigestFromReport

func DigestFromReport(utils BuildUtils) (string, error)

func DownloadBuildpacks

func DownloadBuildpacks(path string, bpacks []string, dockerCreds string, utils BuildUtils) error

Types

type BuildPackMetadata

type BuildPackMetadata struct {
	ID          string    `toml:"id,omitempty" json:"id,omitempty" yaml:"id,omitempty"`
	Name        string    `toml:"name,omitempty" json:"name,omitempty" yaml:"name,omitempty"`
	Version     string    `toml:"version,omitempty" json:"version,omitempty" yaml:"version,omitempty"`
	Description string    `toml:"description,omitempty" json:"description,omitempty" yaml:"description,omitempty"`
	Homepage    string    `toml:"homepage,omitempty" json:"homepage,omitempty" yaml:"homepage,omitempty"`
	Keywords    []string  `toml:"keywords,omitempty" json:"keywords,omitempty" yaml:"keywords,omitempty"`
	Licenses    []License `toml:"licenses,omitempty" json:"licenses,omitempty" yaml:"licenses,omitempty"`
}

func GetMetadata

func GetMetadata(bpacks []string, utils BuildUtils) ([]BuildPackMetadata, error)

type BuildSummary

type BuildSummary struct {
	Builder          string
	LifecycleVersion string

	Images []*ImageSummary
}

func NewBuildSummary

func NewBuildSummary(builder string, utils BuildUtils) *BuildSummary

func (*BuildSummary) Print

func (bs *BuildSummary) Print()

type BuildUtils

type BuildUtils interface {
	command.ExecRunner
	piperutils.FileUtils
	docker.Download
}

type DockerKeychain

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

func ParseDockerConfig

func ParseDockerConfig(config string, utils BuildUtils) (*DockerKeychain, error)

func (*DockerKeychain) AuthExistsForImage

func (dk *DockerKeychain) AuthExistsForImage(image string) bool

func (*DockerKeychain) ToCNBString

func (dk *DockerKeychain) ToCNBString() (string, error)

type ImageSummary

type ImageSummary struct {
	ImageRef          string
	ProjectDescriptor string
	Buildpacks        []string
	EnvVars           []string
}

func (*ImageSummary) AddEnv

func (is *ImageSummary) AddEnv(env map[string]interface{})

func (*ImageSummary) Print

func (is *ImageSummary) Print()

type License

type License struct {
	Type string `toml:"type" json:"type"`
	URI  string `toml:"uri" json:"uri"`
}

type MockUtils

type MockUtils struct {
	*mock.ExecMockRunner
	*mock.FilesMock
	*mock.DownloadMock
}

func (*MockUtils) GetFileUtils

func (c *MockUtils) GetFileUtils() piperutils.FileUtils

type Order

type Order struct {
	Order []OrderEntry `toml:"order"`
	Utils BuildUtils   `toml:"-"`
}

func CreateOrder

func CreateOrder(bpacks, preBpacks, postBpacks []string, dockerCreds string, utils BuildUtils) (Order, error)

func (Order) Save

func (o Order) Save(path string) error

type OrderEntry

type OrderEntry struct {
	Group []BuildPackMetadata `toml:"group" json:"group"`
}

type TargetImage

type TargetImage struct {
	ContainerImageName string
	ContainerImageTag  string
	ContainerRegistry  *url.URL
}

func GetTargetImage

func GetTargetImage(imageRegistry, imageName, imageTag, projectID, envRootPath string) (*TargetImage, error)