build

Documentation

Index

• func CreateBuildArgsFromArtifacts(deps []*latest.ArtifactDependency, r ArtifactResolver, missingIsFatal bool) map[string]*string
• func DependenciesForArtifact(ctx context.Context, a *latest.Artifact, cfg docker.Config, r ArtifactResolver) ([]string, error)
• func TagWithDigest(tag, digest string) string
• func TagWithImageID(ctx context.Context, tag string, imageID string, ...) (string, error)
• type Artifact
  • func InOrder(ctx context.Context, out io.Writer, tags tag.ImageTags, ...) ([]Artifact, error)
  • func MergeWithPreviousBuilds(builds, previous []Artifact) []Artifact
• type ArtifactBuilder
  • func WithLogFile(builder ArtifactBuilder, muted Muted) ArtifactBuilder
• type ArtifactGraph
  • func ToArtifactGraph(artifacts []*latest.Artifact) ArtifactGraph
  • func (g ArtifactGraph) Dependencies(a *latest.Artifact) []*latest.Artifact
• type ArtifactResolver
• type ArtifactStore
  • func NewArtifactStore() ArtifactStore
• type Builder
• type ErrSyncMapNotSupported
  • func (ErrSyncMapNotSupported) Error() string
• type Muted

Functions

func CreateBuildArgsFromArtifacts

func CreateBuildArgsFromArtifacts(deps []*latest.ArtifactDependency, r ArtifactResolver, missingIsFatal bool) map[string]*string

CreateBuildArgsFromArtifacts creates docker build args for an artifact from its required artifacts slice. If `missingIsFatal` is false then it is permissive of missing entries in the ArtifactResolver and returns nil for those entries.

func DependenciesForArtifact

func DependenciesForArtifact(ctx context.Context, a *latest.Artifact, cfg docker.Config, r ArtifactResolver) ([]string, error)

DependenciesForArtifact returns the dependencies for a given artifact.

func TagWithDigest

func TagWithDigest(tag, digest string) string

func TagWithImageID

func TagWithImageID(ctx context.Context, tag string, imageID string, localDocker docker.LocalDaemon) (string, error)

Types

type Artifact

type Artifact struct {
	ImageName string `json:"imageName"`
	Tag       string `json:"tag"`
}

Artifact is the result corresponding to each successful build.

func InOrder

func InOrder(ctx context.Context, out io.Writer, tags tag.ImageTags, artifacts []*latest.Artifact, artifactBuilder ArtifactBuilder, concurrency int, store ArtifactStore) ([]Artifact, error)

InOrder builds a list of artifacts in dependency order.

func MergeWithPreviousBuilds

func MergeWithPreviousBuilds(builds, previous []Artifact) []Artifact

MergeWithPreviousBuilds merges previous or prebuilt build artifacts with builds. If an artifact is already present in builds, the same artifact from previous will be replaced at the same position.

type ArtifactBuilder

type ArtifactBuilder func(ctx context.Context, out io.Writer, artifact *latest.Artifact, tag string) (string, error)

func WithLogFile

func WithLogFile(builder ArtifactBuilder, muted Muted) ArtifactBuilder

WithLogFile wraps an `artifactBuilder` so that it optionally outputs its logs to a file.

type ArtifactGraph

type ArtifactGraph map[string]*latest.Artifact

ArtifactGraph is a map of [artifact image : artifact definition]

func ToArtifactGraph

func ToArtifactGraph(artifacts []*latest.Artifact) ArtifactGraph

ToArtifactGraph creates an instance of `ArtifactGraph` from `[]*latest.Artifact`

func (ArtifactGraph) Dependencies

func (g ArtifactGraph) Dependencies(a *latest.Artifact) []*latest.Artifact

Dependencies returns the de-referenced slice of required artifacts for a given artifact

type ArtifactResolver

type ArtifactResolver interface {
	GetImageTag(imageName string) (string, bool)
}

ArtifactResolver provides an interface to resolve built artifact tags by image name.

type ArtifactStore

type ArtifactStore interface {
	Record(a *latest.Artifact, tag string)
	GetImageTag(imageName string) (tag string, found bool)
	GetArtifacts(s []*latest.Artifact) ([]Artifact, error)
}

ArtifactStore stores the results of each artifact build.

func NewArtifactStore

func NewArtifactStore() ArtifactStore

type Builder

type Builder interface {
	Build(ctx context.Context, out io.Writer, tags tag.ImageTags, artifacts []*latest.Artifact) ([]Artifact, error)

	// Prune removes images built with Skaffold
	Prune(context.Context, io.Writer) error
}

Builder is an interface to the Build API of Skaffold. It must build and make the resulting image accessible to the cluster. This could include pushing to a authorized repository or loading the nodes with the image. If artifacts is supplied, the builder should only rebuild those artifacts.

type ErrSyncMapNotSupported

type ErrSyncMapNotSupported struct{}

func (ErrSyncMapNotSupported) Error

func (ErrSyncMapNotSupported) Error() string

type Muted

type Muted interface {
	MuteBuild() bool
}