builder

Documentation

Overview

Package builder implement local build process.

Index

• type Builder
  • func New() (*Builder, error)
  • func (b *Builder) Build(ctx context.Context, m *manifest.Manifest) (*fileset.Set, error)
  • func (b *Builder) Close() error

Types

type Builder

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

Builder executes build steps specified via "build" field in the manifest.

func New

func New() (*Builder, error)

New initializes a builder, allocating a temp directory for it.

func (*Builder) Build

func (b *Builder) Build(ctx context.Context, m *manifest.Manifest) (*fileset.Set, error)

Build executes all local builds steps specified in the manifest.

The result of this process is a fileset.Set with m.ContextDir and outputs of all build steps. Note that Builder is oblivious of Dockerfile or any other docker specifics. It just executes local steps specified via "build" field in the manifest.

The returned fileset should not outlive Builder, since it may reference temporary files owned by Builder.

func (*Builder) Close

func (b *Builder) Close() error

Close removes all temporary files held by this Builder.

Closing the builder invalidates all outputs it ever produced, thus this should be done only after outputs are processed.

Idempotent.