builder

Documentation

Overview

builder package implements the generic zbuild Builder, which is responsible of building specialized images from generic build definitions. It's also responsible of other generic operations involving specialized kind handlers.

Index

• type Builder
  • func (b Builder) Build(ctx context.Context, solver statesolver.StateSolver, c client.Client) (*client.Result, error)
  • func (b Builder) Debug(solver statesolver.StateSolver, file, stage string) (llb.State, error)
  • func (b Builder) DumpConfig(solver statesolver.StateSolver, file, stage string) ([]byte, error)
  • func (b Builder) UpdateLockFile(solver statesolver.StateSolver, opts builddef.UpdateLocksOpts) error
• type OutOfSyncLockfileError
  • func (err OutOfSyncLockfileError) Error() string

Types

type Builder

type Builder struct {
	Registry   *registry.KindRegistry
	PkgSolvers pkgsolver.PackageSolversMap
	Filesystem vfs.FS
}

Builder takes a KindRegistry, which contains all the specialized handlers supported by zbuild. It's used to execute generic operations for specialized build definitions, by calling the appropriate kind handlers' methods. It also contains a set of PackageSolvers and a filesystem abstraction, used during locking.

func (Builder) Build

func (b Builder) Build(
	ctx context.Context,
	solver statesolver.StateSolver,
	c client.Client,
) (*client.Result, error)

func (Builder) Debug

func (b Builder) Debug(
	solver statesolver.StateSolver,
	file,
	stage string,
) (llb.State, error)

func (Builder) DumpConfig

func (b Builder) DumpConfig(
	solver statesolver.StateSolver,
	file,
	stage string,
) ([]byte, error)

func (Builder) UpdateLockFile

func (b Builder) UpdateLockFile(
	solver statesolver.StateSolver,
	opts builddef.UpdateLocksOpts,
) error

type OutOfSyncLockfileError

type OutOfSyncLockfileError struct{}

OutOfSyncLockfileError is returned by Builder.Build() when the hash of the original BuildDef used to generate the lockfile does not match the hash of the current BuildDef.

func (OutOfSyncLockfileError) Error

func (err OutOfSyncLockfileError) Error() string