buildcontrol

Documentation

Index

• Variables
• func EarliestPendingAutoTriggerTarget(targets []*store.ManifestTarget) *store.ManifestTarget
• func FindDeployOnlyK8sManifestTargets(targets []*store.ManifestTarget) []*store.ManifestTarget
• func FindLocalTargets(targets []*store.ManifestTarget) []*store.ManifestTarget
• func FindTargetsNeedingInitialBuild(targets []*store.ManifestTarget) []*store.ManifestTarget
• func FindUnresourcedYAML(targets []*store.ManifestTarget) *store.ManifestTarget
• func IsDontFallBackError(err error) bool
• func IsFatalError(err error) bool
• func NextManifestNameToBuild(state store.EngineState) model.ManifestName
• func NextTargetToBuild(state store.EngineState) *store.ManifestTarget
• func NextUnbuiltTargetToBuild(unbuilt []*store.ManifestTarget) *store.ManifestTarget
• func RemoveTargetsWaitingOnDependencies(state store.EngineState, mts []*store.ManifestTarget) []*store.ManifestTarget
• func ShouldFallBackForErr(err error) bool
• func WrapDontFallBackError(err error) error
• type BuildCompleteAction
  • func NewBuildCompleteAction(result store.BuildResultSet, err error) BuildCompleteAction
  • func (BuildCompleteAction) Action()
• type BuildLogAction
  • func (BuildLogAction) Action()
• type BuildStartedAction
  • func (BuildStartedAction) Action()
• type DontFallBackError
  • func DontFallBackErrorf(msg string, a ...interface{}) DontFallBackError
• type RedirectToNextBuilder
  • func RedirectToNextBuilderInfof(msg string, a ...interface{}) RedirectToNextBuilder
  • func SilentRedirectToNextBuilderf(msg string, a ...interface{}) RedirectToNextBuilder
  • func WrapRedirectToNextBuilder(err error, level logger.Level) RedirectToNextBuilder
• type UpdateMode
  • func ProvideUpdateMode(flag UpdateModeFlag, env k8s.Env, runtime container.Runtime) (UpdateMode, error)
• type UpdateModeFlag

Variables

var AllUpdateModes = []UpdateMode{
	UpdateModeAuto,
	UpdateModeImage,
	UpdateModeNaive,
	UpdateModeSynclet,
	UpdateModeContainer,
	UpdateModeKubectlExec,
}

Functions

func EarliestPendingAutoTriggerTarget

func EarliestPendingAutoTriggerTarget(targets []*store.ManifestTarget) *store.ManifestTarget

Go through all the manifests, and check: 1) all pending file changes, and 2) all pending manifest changes The earliest one is the one we want.

If no targets are pending, return nil

func FindDeployOnlyK8sManifestTargets

func FindDeployOnlyK8sManifestTargets(targets []*store.ManifestTarget) []*store.ManifestTarget

func FindLocalTargets

func FindLocalTargets(targets []*store.ManifestTarget) []*store.ManifestTarget

func FindTargetsNeedingInitialBuild

func FindTargetsNeedingInitialBuild(targets []*store.ManifestTarget) []*store.ManifestTarget

func FindUnresourcedYAML

func FindUnresourcedYAML(targets []*store.ManifestTarget) *store.ManifestTarget

func IsDontFallBackError

func IsDontFallBackError(err error) bool

func IsFatalError

func IsFatalError(err error) bool

A permanent error indicates that the whole build pipeline needs to stop. It will never recover, even on subsequent rebuilds.

func NextManifestNameToBuild

func NextManifestNameToBuild(state store.EngineState) model.ManifestName

func NextTargetToBuild

func NextTargetToBuild(state store.EngineState) *store.ManifestTarget

Algorithm to choose a manifest to build next.

func NextUnbuiltTargetToBuild

func NextUnbuiltTargetToBuild(unbuilt []*store.ManifestTarget) *store.ManifestTarget

Helper function for ordering targets that have never been built before.

func RemoveTargetsWaitingOnDependencies

func RemoveTargetsWaitingOnDependencies(state store.EngineState, mts []*store.ManifestTarget) []*store.ManifestTarget

func ShouldFallBackForErr

func ShouldFallBackForErr(err error) bool

func WrapDontFallBackError

func WrapDontFallBackError(err error) error

Types

type BuildCompleteAction

type BuildCompleteAction struct {
	Result store.BuildResultSet
	Error  error
}

func NewBuildCompleteAction

func NewBuildCompleteAction(result store.BuildResultSet, err error) BuildCompleteAction

func (BuildCompleteAction) Action

func (BuildCompleteAction) Action()

type BuildLogAction

type BuildLogAction struct {
	store.LogEvent
}

func (BuildLogAction) Action

func (BuildLogAction) Action()

type BuildStartedAction

type BuildStartedAction struct {
	ManifestName model.ManifestName
	StartTime    time.Time
	FilesChanged []string
	Reason       model.BuildReason
	SpanID       logstore.SpanID
}

func (BuildStartedAction) Action

func (BuildStartedAction) Action()

type DontFallBackError

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

Something is wrong enough that we shouldn't bother falling back to other BaD's -- they won't work.

func DontFallBackErrorf

func DontFallBackErrorf(msg string, a ...interface{}) DontFallBackError

type RedirectToNextBuilder

type RedirectToNextBuilder struct {
	Level logger.Level
	// contains filtered or unexported fields
}

Nothing is on fire, this is an expected case like a container builder being passed a build with no attached container. `level` indicates at what log level this error should be shown to the user

func RedirectToNextBuilderInfof

func RedirectToNextBuilderInfof(msg string, a ...interface{}) RedirectToNextBuilder

func SilentRedirectToNextBuilderf

func SilentRedirectToNextBuilderf(msg string, a ...interface{}) RedirectToNextBuilder

func WrapRedirectToNextBuilder

func WrapRedirectToNextBuilder(err error, level logger.Level) RedirectToNextBuilder

type UpdateMode

type UpdateMode string

var (
	// Auto-pick the build mode based on
	UpdateModeAuto UpdateMode = "auto"

	// Only do image builds
	UpdateModeImage UpdateMode = "image"

	// Only do image builds from scratch
	UpdateModeNaive UpdateMode = "naive"

	// Deploy a synclet to make container updates faster
	UpdateModeSynclet UpdateMode = "synclet"

	// Update containers in-place. This mode only works with DockerForDesktop and Minikube.
	// If you try to use this mode with a different K8s cluster type, we will return an error
	UpdateModeContainer UpdateMode = "container"

	// Use `kubectl exec`
	UpdateModeKubectlExec UpdateMode = "exec"
)

func ProvideUpdateMode

func ProvideUpdateMode(flag UpdateModeFlag, env k8s.Env, runtime container.Runtime) (UpdateMode, error)

type UpdateModeFlag

type UpdateModeFlag UpdateMode

A type to bind to flag values that need validation.