build

type Assembler ¶

type Assembler interface {
	Assemble(*types.Bundle, string) error
}

Assembler is responsible for assembling an image from a bundle. For example a bundle may be holding multiple file systems intended to be separate partitions within a SIF image. The assembler would need to detect these directories and make sure it properly assembles the SIF with them as partitions.

type Build ¶

type Build struct {

	// Conf contains cross stage build configuration.
	Conf Config
	// contains filtered or unexported fields
}

Build is an abstracted way to look at the entire build process. For example calling NewBuild() will return this object. From there we can call Full() on this build object, which will:

• Call Bundle() to obtain all data needed to execute the specified build locally on the machine
• Execute all of a definition using AllSections()
• And finally call Assemble() to create our container image

func New(defs []types.Definition, conf Config) (*Build, error)

func NewBuild(spec string, conf Config) (*Build, error)

func (b *Build) Full(ctx context.Context) error

type Config ¶

type Config struct {
	// Dest is the location for container after build is complete.
	Dest string
	// Format is the format of built container, e.g. SIF, sandbox.
	Format string
	// NoCleanUp allows a user to prevent a bundle from being cleaned
	// up after a failed build, useful for debugging.
	NoCleanUp bool
	// Opts for bundles.
	Opts types.Options
}

Config defines how build is executed, including things like where final image is written.

type Conveyor ¶

type Conveyor interface {
	Get(context.Context, *types.Bundle) error
}

Conveyor is responsible for downloading from remote sources (library, shub, docker...).

type ConveyorPacker ¶

type ConveyorPacker interface {
	Conveyor
	Packer
}

ConveyorPacker describes an interface that a ConveyorPacker type must implement.

type Packer ¶

type Packer interface {
	Pack(context.Context) (*types.Bundle, error)
}

Packer is the type which is responsible for installing the chroot directory, metadata directory, and potentially other files/directories within the Bundle.