layers

Documentation

Index

• Constants
• func CopyDirectory(srcDir, destDir string) error
• func CopyFile(source, destFile string) error
• func ExtractTarGz(tarFile, destDir string, stripComponents int) error
• func ExtractZip(zipfile, destDir string, stripComponents int) error
• func FileExists(file string) (bool, error)
• func FromTomlFile(file string, v interface{}) error
• func WriteToFile(source io.Reader, destFile string, mode os.FileMode) error
• type DependencyLayer
  • func (l DependencyLayer) ArtifactName() string
  • func (l DependencyLayer) Contribute(contributor DependencyLayerContributor, flags ...Flag) error
  • func (l DependencyLayer) String() string
• type DependencyLayerContributor
• type DownloadLayer
  • func (l DownloadLayer) Artifact() (string, error)
  • func (l DownloadLayer) String() string
• type Flag
• type Layer
  • func (l Layer) AppendBuildEnv(name string, format string, args ...interface{}) error
  • func (l Layer) AppendLaunchEnv(name string, format string, args ...interface{}) error
  • func (l Layer) AppendPathBuildEnv(name string, format string, args ...interface{}) error
  • func (l Layer) AppendPathLaunchEnv(name string, format string, args ...interface{}) error
  • func (l Layer) AppendPathSharedEnv(name string, format string, args ...interface{}) error
  • func (l Layer) AppendSharedEnv(name string, format string, args ...interface{}) error
  • func (l Layer) Contribute(expected logger.Identifiable, contributor LayerContributor, flags ...Flag) error
  • func (l Layer) MetadataMatches(expected interface{}) (bool, error)
  • func (l Layer) OverrideBuildEnv(name string, format string, args ...interface{}) error
  • func (l Layer) OverrideLaunchEnv(name string, format string, args ...interface{}) error
  • func (l Layer) OverrideSharedEnv(name string, format string, args ...interface{}) error
  • func (l Layer) String() string
  • func (l Layer) WriteProfile(file string, format string, args ...interface{}) error
• type LayerContributor
• type Layers
  • func (l Layers) DependencyLayer(dependency buildpack.Dependency) DependencyLayer
  • func (l Layers) DownloadLayer(dependency buildpack.Dependency) DownloadLayer
  • func (l Layers) Layer(name string) Layer
  • func (l Layers) String() string
  • func (l Layers) WriteMetadata(metadata Metadata) error
• type Metadata
• type Process
• type Processes

Constants

const (
	// Build indicates that a layer should be used for builds
	Build = layers.Build

	// Cache indicates that a layer should be cached
	Cache = layers.Cache

	// Launch indicates that a layer should be used for launch
	Launch = layers.Launch
)

Functions

func CopyDirectory

func CopyDirectory(srcDir, destDir string) error

CopyDirectory copies srcDir to destDir

func CopyFile

func CopyFile(source, destFile string) error

CopyFile copies source file to destFile, creating all intermediate directories in destFile

func ExtractTarGz

func ExtractTarGz(tarFile, destDir string, stripComponents int) error

ExtractTarGz extracts tarfile to destDir

func ExtractZip

func ExtractZip(zipfile, destDir string, stripComponents int) error

ExtractZip extracts zipfile to destDir

func FileExists

func FileExists(file string) (bool, error)

FileExists returns true if a file exists, otherwise false.

func FromTomlFile

func FromTomlFile(file string, v interface{}) error

FromTomlFile decodes a TOML file into a struct.

func WriteToFile

func WriteToFile(source io.Reader, destFile string, mode os.FileMode) error

WriteToFile writes the contents of an io.Reader to a file.

Types

type DependencyLayer

type DependencyLayer struct {
	Layer

	// Dependency is the dependency provided by this layer
	Dependency buildpack.Dependency

	// Logger is used to write debug and info to the console.
	Logger logger.Logger
	// contains filtered or unexported fields
}

DependencyLayer is an extension to Layer that is unique to a dependency.

func (DependencyLayer) ArtifactName

func (l DependencyLayer) ArtifactName() string

ArtifactName returns the name portion of the download path for the dependency.

func (DependencyLayer) Contribute

func (l DependencyLayer) Contribute(contributor DependencyLayerContributor, flags ...Flag) error

Contribute facilitates custom contribution of an artifact to a layer. If the artifact has already been contributed, the contribution is validated and the contributor is not called.

func (DependencyLayer) String

func (l DependencyLayer) String() string

String makes DependencyLayer satisfy the Stringer interface.

type DependencyLayerContributor

type DependencyLayerContributor func(artifact string, layer DependencyLayer) error

DependencyLayerContributor defines a callback function that is called when a dependency needs to be contributed.

type DownloadLayer

type DownloadLayer struct {
	Layer
	// contains filtered or unexported fields
}

DownloadLayer is an extension to Layer that is unique to a dependency download.

func (DownloadLayer) Artifact

func (l DownloadLayer) Artifact() (string, error)

Artifact returns the path to an artifact cached in the layer. If the artifact has already been downloaded, the cache will be validated and used directly.

func (DownloadLayer) String

func (l DownloadLayer) String() string

String makes DownloadLayer satisfy the Stringer interface.

type Flag

type Flag = layers.Flag

type Layer

type Layer struct {
	layers.Layer

	// Logger is used to write debug and info to the console.
	Logger logger.Logger
}

LaunchLayer is an extension to libbuildpack.LaunchLayer that allows additional functionality to be added

func (Layer) AppendBuildEnv

func (l Layer) AppendBuildEnv(name string, format string, args ...interface{}) error

AppendBuildEnv appends the value of this environment variable to any previous declarations of the value without any delimitation. If delimitation is important during concatenation, callers are required to add it.

func (Layer) AppendLaunchEnv

func (l Layer) AppendLaunchEnv(name string, format string, args ...interface{}) error

AppendLaunchEnv appends the value of this environment variable to any previous declarations of the value without any delimitation. If delimitation is important during concatenation, callers are required to add it.

func (Layer) AppendPathBuildEnv

func (l Layer) AppendPathBuildEnv(name string, format string, args ...interface{}) error

AppendPathBuildEnv appends the value of this environment variable to any previous declarations of the value using the OS path delimiter.

func (Layer) AppendPathLaunchEnv

func (l Layer) AppendPathLaunchEnv(name string, format string, args ...interface{}) error

AppendPathLaunchEnv appends the value of this environment variable to any previous declarations of the value using the OS path delimiter.

func (Layer) AppendPathSharedEnv

func (l Layer) AppendPathSharedEnv(name string, format string, args ...interface{}) error

AppendPathSharedEnv appends the value of this environment variable to any previous declarations of the value using the OS path delimiter.

func (Layer) AppendSharedEnv

func (l Layer) AppendSharedEnv(name string, format string, args ...interface{}) error

AppendSharedEnv appends the value of this environment variable to any previous declarations of the value without any delimitation. If delimitation is important during concatenation, callers are required to add it.

func (Layer) Contribute

func (l Layer) Contribute(expected logger.Identifiable, contributor LayerContributor, flags ...Flag) error

Contribute facilitates custom contribution of a layer. If the layer has already been contributed, the contribution is validated and the contributor is not called.

func (Layer) MetadataMatches

func (l Layer) MetadataMatches(expected interface{}) (bool, error)

MetadataMatches compares the expected metadata for the actual metadata of this layer.

func (Layer) OverrideBuildEnv

func (l Layer) OverrideBuildEnv(name string, format string, args ...interface{}) error

OverrideBuildEnv overrides any existing value for an environment variable with this value.

func (Layer) OverrideLaunchEnv

func (l Layer) OverrideLaunchEnv(name string, format string, args ...interface{}) error

OverrideLaunchEnv overrides any existing value for an environment variable with this value.

func (Layer) OverrideSharedEnv

func (l Layer) OverrideSharedEnv(name string, format string, args ...interface{}) error

OverrideSharedEnv overrides any existing value for an environment variable with this value.

func (Layer) String

func (l Layer) String() string

String makes Layer satisfy the Stringer interface.

func (Layer) WriteProfile

func (l Layer) WriteProfile(file string, format string, args ...interface{}) error

WriteProfile writes a file to profile.d with this value.

type LayerContributor

type LayerContributor func(layer Layer) error

LayerContributor defines a callback function that is called when a layer needs to be contributed.

type Layers

type Layers struct {
	layers.Layers

	// BuildpackCacheRoot is the root of the cache of dependencies in the buildpack.
	BuildpackCache layers.Layers

	// Logger logger is used to write debug and info to the console.
	Logger logger.Logger
}

Layers is an extension allows additional functionality to be added.

func (Layers) DependencyLayer

func (l Layers) DependencyLayer(dependency buildpack.Dependency) DependencyLayer

DependencyLayer returns a DependencyLayer unique to a dependency.

func (Layers) DownloadLayer

func (l Layers) DownloadLayer(dependency buildpack.Dependency) DownloadLayer

DownloadLayer returns a DownloadLayer unique to a dependency.

func (Layers) Layer

func (l Layers) Layer(name string) Layer

Layer creates a Layer with a specified name.

func (Layers) String

func (l Layers) String() string

String makes Layers satisfy the Stringer interface.

func (Layers) WriteMetadata

func (l Layers) WriteMetadata(metadata Metadata) error

WriteMetadata writes Launch metadata to the filesystem.

type Metadata

type Metadata = layers.Metadata

type Process

type Process = layers.Process

type Processes

type Processes = layers.Processes