build

package
v0.23.2 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 3, 2021 License: Apache-2.0 Imports: 46 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	// Label for all image builds created with Tilt.
	//
	// It's the responsibility of ImageBuilder to ensure
	// that all images built with Tilt have an appropriate BuildMode label.
	BuildMode dockerfile.Label = "tilt.buildMode"

	// Label when an image is created by a test.
	TestImage dockerfile.Label = "tilt.test"

	// Label when an image is for path caching.
	CacheImage dockerfile.Label = "tilt.cache"
)
View Source 
const (
	BuildModeScratch dockerfile.LabelValue = "scratch"
)
View Source 
const DockerfileName = "Dockerfile"
View Source 
const TaskKillExitCode = 137

https://success.docker.com/article/what-causes-a-container-to-exit-with-code-137

Variables

View Source 
var ImageTagPrefix = "tilt-"

The image tag prefix can be customized.

This allows our integration tests to customize the prefix so that they can write to a public registry without interfering with each other.

Functions

func BoilRuns added in v0.7.11 

func BoilRuns(runs []model.Run, pathMappings []PathMapping) ([]model.Cmd, error)

func FilterByLabel 

func FilterByLabel(label dockerfile.Label) filters.KeyValuePair

func FilterByLabelValue 

func FilterByLabelValue(label dockerfile.Label, val dockerfile.LabelValue) filters.KeyValuePair

func FilterByRefName 

func FilterByRefName(ref reference.Named) filters.KeyValuePair

func IsRunStepFailure added in v0.9.7 

func IsRunStepFailure(err error) bool

func NewDockerImageBuilder 

func NewDockerImageBuilder(dCli docker.Client, extraLabels dockerfile.Labels) *dockerImageBuilder

func Options 

func Options(archive io.Reader, spec v1alpha1.DockerImageSpec) docker.BuildOptions

func PathMappingsToContainerPaths 

func PathMappingsToContainerPaths(mappings []PathMapping) []string

func PathMappingsToLocalPaths added in v0.7.11 

func PathMappingsToLocalPaths(mappings []PathMapping) []string

func TarArchiveForPaths added in v0.10.0 

func TarArchiveForPaths(ctx context.Context, toArchive []PathMapping, filter model.PathMatcher) io.Reader

func TarDfOnly added in v0.9.1 

func TarDfOnly(ctx context.Context, writer io.Writer, df dockerfile.Dockerfile) error

func TarPath added in v0.9.3 

func TarPath(ctx context.Context, writer io.Writer, path string) error

func WrapCodeExitError added in v0.10.0 

func WrapCodeExitError(err error, cID container.ID, cmd model.Cmd) error

func WrapContainerExecError added in v0.5.1 

func WrapContainerExecError(err error, cID container.ID, cmd model.Cmd) error

Convert a Docker exec error into our own internal error type.

Types

type ArchiveBuilder 

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

func NewArchiveBuilder 

func NewArchiveBuilder(writer io.Writer, filter model.PathMatcher) *ArchiveBuilder

func (*ArchiveBuilder) ArchivePathsIfExist 

func (a *ArchiveBuilder) ArchivePathsIfExist(ctx context.Context, paths []PathMapping) error

ArchivePathsIfExist creates a tar archive of all local files in `paths`. It quietly skips any paths that don't exist.

func (*ArchiveBuilder) Close added in v0.9.4 

func (a *ArchiveBuilder) Close() error

func (*ArchiveBuilder) Paths added in v0.7.11 

func (a *ArchiveBuilder) Paths() []string

Local paths that were archived

type Clock added in v0.5.0 

type Clock interface {
	Now() time.Time
}

func ProvideClock added in v0.5.0 

func ProvideClock() Clock

type CustomBuilder added in v0.7.11 

type CustomBuilder interface {
	Build(ctx context.Context, refs container.RefSet, cb model.CustomBuild) (container.TaggedRefs, error)
}

type DockerBuilder added in v0.14.1 

type DockerBuilder interface {
	DockerKubeConnection

	BuildImage(ctx context.Context, ps *PipelineState, refs container.RefSet, spec v1alpha1.DockerImageSpec, filter model.PathMatcher) (container.TaggedRefs, []v1alpha1.DockerImageStageStatus, error)
	DumpImageDeployRef(ctx context.Context, ref string) (reference.NamedTagged, error)
	PushImage(ctx context.Context, name reference.NamedTagged) error
	TagRefs(ctx context.Context, refs container.RefSet, dig digest.Digest) (container.TaggedRefs, error)
	ImageExists(ctx context.Context, ref reference.NamedTagged) (bool, error)
}

func DefaultDockerBuilder added in v0.14.1 

func DefaultDockerBuilder(b *dockerImageBuilder) DockerBuilder

type DockerKubeConnection added in v0.20.9 

type DockerKubeConnection interface {
	// Returns whether this docker builder is going to build to the given kubernetes context.
	WillBuildToKubeContext(kctx k8s.KubeContext) bool
}

Describes how a docker instance connects to kubernetes instances.

type ExecCustomBuilder added in v0.7.11 

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

func NewExecCustomBuilder added in v0.7.11 

func NewExecCustomBuilder(dCli docker.Client, clock Clock) *ExecCustomBuilder

func (*ExecCustomBuilder) Build added in v0.7.11 

func (b *ExecCustomBuilder) Build(ctx context.Context, refs container.RefSet, cb model.CustomBuild) (container.TaggedRefs, error)

type ImageReaper 

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

func NewImageReaper 

func NewImageReaper(docker docker.Client) ImageReaper

func (ImageReaper) RemoveTiltImages 

func (r ImageReaper) RemoveTiltImages(ctx context.Context, createdBefore time.Time, force bool, extraFilters ...filters.KeyValuePair) error

Delete all Tilt builds

For safety reasons, we only delete images with the tilt.buildMode label, but we let the caller set additional filters.

type PathMapping added in v0.5.0 

type PathMapping struct {
	LocalPath     string
	ContainerPath string
}

PathMapping represents a mapping from the local path to the tarball path

To send a local file into a container, we copy it into a tarball, send the tarball to docker, and then run a sequence of steps to unpack the tarball in the container file system.

That means every file has 3 paths: 1) LocalPath 2) TarballPath 3) ContainerPath

In incremental builds, TarballPath and ContainerPath are always the same, so it was correct to use TarballPath and ContainerPath interchangeably.

In DockerBuilds, this is no longer the case.

TODO(nick): Do a pass on renaming all the path types

func FilesToPathMappings 

func FilesToPathMappings(files []string, syncs []model.Sync) ([]PathMapping, []string, error)

FilesToPathMappings converts a list of absolute local filepaths into pathMappings (i.e. associates local filepaths with their syncs and destination paths), returning those that it cannot associate with a sync.

func FilterMappings 

func FilterMappings(mappings []PathMapping, matcher model.PathMatcher) ([]PathMapping, error)

func MissingLocalPaths 

func MissingLocalPaths(ctx context.Context, mappings []PathMapping) (missing, rest []PathMapping, err error)

Return all the path mappings for local paths that do not exist.

func SyncsToPathMappings added in v0.7.11 

func SyncsToPathMappings(syncs []model.Sync) []PathMapping

func (PathMapping) Filter added in v0.5.0 

func (m PathMapping) Filter(matcher model.PathMatcher) ([]PathMapping, error)

func (PathMapping) PrettyStr added in v0.7.12 

func (m PathMapping) PrettyStr() string

type PipelineState 

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

func NewPipelineState 

func NewPipelineState(ctx context.Context, totalStepCount int, c Clock) *PipelineState

func (*PipelineState) AttachLogger added in v0.14.0 

func (ps *PipelineState) AttachLogger(ctx context.Context) context.Context

func (*PipelineState) End 

func (ps *PipelineState) End(ctx context.Context, err error)

NOTE(maia): this func should always be deferred in a closure, so that the `err` arg is bound at the time of calling rather than at the time of deferring. I.e., do: 

defer func() { ps.End(ctx, err) }()

and NOT: 

defer ps.End(ctx, err)

func (*PipelineState) EndPipelineStep 

func (ps *PipelineState) EndPipelineStep(ctx context.Context)

func (*PipelineState) Printf 

func (ps *PipelineState) Printf(ctx context.Context, format string, a ...interface{})

func (*PipelineState) StartBuildStep 

func (ps *PipelineState) StartBuildStep(ctx context.Context, format string, a ...interface{})

func (*PipelineState) StartPipelineStep 

func (ps *PipelineState) StartPipelineStep(ctx context.Context, format string, a ...interface{})

type PipelineStep added in v0.19.3 

type PipelineStep struct {
	Name      string // for logging
	StartTime time.Time
	Duration  time.Duration // not populated until end of the step
}

type ProgressWriter added in v0.23.0 

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

A little utility class that tracks how many bytes we've written, to the Docker context.

func NewProgressWriter added in v0.23.0 

func NewProgressWriter(ctx context.Context, w io.Writer) *ProgressWriter

func (*ProgressWriter) Close added in v0.23.0 

func (w *ProgressWriter) Close()

func (*ProgressWriter) Init added in v0.23.0 

func (w *ProgressWriter) Init()

func (*ProgressWriter) Write added in v0.23.0 

func (w *ProgressWriter) Write(b []byte) (int, error)

type RunStepFailure added in v0.9.7 

type RunStepFailure struct {
	Cmd      model.Cmd
	ExitCode int
}

Indicates that the update failed because one of the user's Runs failed (i.e. exited non-zero) -- as opposed to an infrastructure issue.

func MaybeRunStepFailure added in v0.10.0 

func MaybeRunStepFailure(err error) (RunStepFailure, bool)

func (RunStepFailure) Empty added in v0.10.0 

func (e RunStepFailure) Empty() bool

func (RunStepFailure) Error added in v0.9.7 

func (e RunStepFailure) Error() string

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.