sti

Documentation

Index

• func CreateBuildEnvironment(sourcePath string, cfgEnv api.EnvironmentList) []string
• type STI
  • func New(client dockerpkg.Client, config *api.Config, fs fs.FileSystem, ...) (*STI, error)
  • func (builder *STI) Build(config *api.Config) (*api.Result, error)
  • func (builder *STI) Execute(command string, user string, config *api.Config) error
  • func (builder *STI) Exists(config *api.Config) bool
  • func (builder *STI) PostExecute(containerID, destination string) error
  • func (builder *STI) Prepare(config *api.Config) error
  • func (builder *STI) Save(config *api.Config) (err error)
  • func (builder *STI) SetScripts(required, optional []string)
• type Usage
  • func NewUsage(client docker.Client, config *api.Config) (*Usage, error)
  • func (u *Usage) Show() error

Functions

func CreateBuildEnvironment

func CreateBuildEnvironment(sourcePath string, cfgEnv api.EnvironmentList) []string

CreateBuildEnvironment constructs the environment variables to be provided to the assemble script and committed in the new image.

Types

type STI

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

STI strategy executes the S2I build. For more details about S2I, visit https://github.com/openshift/source-to-image

func New

func New(client dockerpkg.Client, config *api.Config, fs fs.FileSystem, overrides build.Overrides) (*STI, error)

New returns the instance of STI builder strategy for the given config. If the layeredBuilder parameter is specified, then the builder provided will be used for the case that the base Docker image does not have 'tar' or 'bash' installed.

func (*STI) Build

func (builder *STI) Build(config *api.Config) (*api.Result, error)

Build processes a Request and returns a *api.Result and an error. An error represents a failure performing the build rather than a failure of the build itself. Callers should check the Success field of the result to determine whether a build succeeded or not.

func (*STI) Execute

func (builder *STI) Execute(command string, user string, config *api.Config) error

Execute runs the specified STI script in the builder image.

func (*STI) Exists

func (builder *STI) Exists(config *api.Config) bool

Exists determines if the current build supports incremental workflow. It checks if the previous image exists in the system and if so, then it verifies that the save-artifacts script is present.

func (*STI) PostExecute

func (builder *STI) PostExecute(containerID, destination string) error

PostExecute allows to execute post-build actions after the Docker container execution finishes.

func (*STI) Prepare

func (builder *STI) Prepare(config *api.Config) error

Prepare prepares the source code and tar for build. NOTE: this func serves both the sti and onbuild strategies, as the OnBuild struct Build func leverages the STI struct Prepare func directly below.

func (*STI) Save

func (builder *STI) Save(config *api.Config) (err error)

Save extracts and restores the build artifacts from the previous build to the current build.

func (*STI) SetScripts

func (builder *STI) SetScripts(required, optional []string)

SetScripts allows to override default required and optional scripts

type Usage

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

Usage display usage information about a particular build image

func NewUsage

func NewUsage(client docker.Client, config *api.Config) (*Usage, error)

NewUsage creates a new instance of the default Usage implementation

func (*Usage) Show

func (u *Usage) Show() error

Show starts the builder container and invokes the usage script on it to print usage information for the script.