build

Documentation

Overview

Package build defines methods for building a v1.Image reference from a Go binary reference.

Index

• type Caching
  • func NewCaching(inner Interface) (*Caching, error)
  • func (c *Caching) Build(ip string) (v1.Image, error)
  • func (c *Caching) Invalidate(ip string)
  • func (c *Caching) IsSupportedReference(ip string) bool
• type GetBase
• type Interface
  • func NewGo(options ...Option) (Interface, error)
• type Option
  • func WithBaseImages(gb GetBase) Option
  • func WithCreationTime(t v1.Time) Option
  • func WithDisabledOptimizations() Option
• type Recorder
  • func (r *Recorder) Build(ip string) (v1.Image, error)
  • func (r *Recorder) IsSupportedReference(ip string) bool

Types

type Caching

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

Caching wraps a builder implementation in a layer that shares build results for the same inputs using a simple "future" implementation. Cached results may be invalidated by calling Invalidate with the same input passed to Build.

func NewCaching

func NewCaching(inner Interface) (*Caching, error)

NewCaching wraps the provided build.Interface in an implementation that shares build results for a given path until the result has been invalidated.

func (*Caching) Build

func (c *Caching) Build(ip string) (v1.Image, error)

Build implements Interface

func (*Caching) Invalidate

func (c *Caching) Invalidate(ip string)

Invalidate removes an import path's cached results.

func (*Caching) IsSupportedReference

func (c *Caching) IsSupportedReference(ip string) bool

IsSupportedReference implements Interface

type GetBase

type GetBase func(string) (v1.Image, error)

GetBase takes an importpath and returns a base v1.Image.

type Interface

type Interface interface {
	// IsSupportedReference determines whether the given reference is to an importpath reference
	// that Ko supports building.
	// TODO(mattmoor): Verify that some base repo: foo.io/bar can be suffixed with this reference and parsed.
	IsSupportedReference(string) bool

	// Build turns the given importpath reference into a v1.Image containing the Go binary.
	Build(string) (v1.Image, error)
}

Interface abstracts different methods for turning a supported importpath reference into a v1.Image.

func NewGo

func NewGo(options ...Option) (Interface, error)

NewGo returns a build.Interface implementation that:

1. builds go binaries named by importpath,
2. containerizes the binary on a suitable base,

type Option

type Option func(*gobuildOpener) error

Option is a functional option for NewGo.

func WithBaseImages

func WithBaseImages(gb GetBase) Option

WithBaseImages is a functional option for overriding the base images that are used for different images.

func WithCreationTime

func WithCreationTime(t v1.Time) Option

WithCreationTime is a functional option for overriding the creation time given to images.

func WithDisabledOptimizations

func WithDisabledOptimizations() Option

WithDisabledOptimizations is a functional option for disabling optimizations when compiling.

type Recorder

type Recorder struct {
	ImportPaths []string
	Builder     Interface
	// contains filtered or unexported fields
}

Recorder composes with another Interface to record the built import paths.

func (*Recorder) Build

func (r *Recorder) Build(ip string) (v1.Image, error)

Build implements Interface

func (*Recorder) IsSupportedReference

func (r *Recorder) IsSupportedReference(ip string) bool

IsSupportedReference implements Interface