docker

Documentation

Index

• Variables
• func AddTag(src, target string) error
• func BuildArtifact(ctx context.Context, out io.Writer, cli APIClient, workspace string, ...) error
• func CreateDockerTarContext(ctx context.Context, w io.Writer, workspace string, a *latest.DockerArtifact) error
• func CreateDockerTarGzContext(ctx context.Context, w io.Writer, workspace string, a *latest.DockerArtifact) error
• func Digest(ctx context.Context, cli APIClient, ref string) (string, error)
• func GetBuildArgs(a *latest.DockerArtifact) []string
• func GetDependencies(ctx context.Context, workspace string, a *latest.DockerArtifact) ([]string, error)
• func NormalizeDockerfilePath(context, dockerfile string) (string, error)
• func RemoteDigest(identifier string) (string, error)
• func RunPush(ctx context.Context, cli APIClient, ref string, out io.Writer) error
• func StreamDockerMessages(dst io.Writer, src io.Reader) error
• func UploadContextToGCS(ctx context.Context, workspace string, a *latest.DockerArtifact, ...) error
• func ValidateDockerfile(path string) bool
• type APIClient
  • func NewAPIClient() (APIClient, error)
• type AuthConfigHelper
• type ImageReference
  • func ParseReference(image string) (*ImageReference, error)

Variables

var RetrieveImage = retrieveImage

RetrieveImage is overridden for unit testing

Functions

func AddTag

func AddTag(src, target string) error

func BuildArtifact

func BuildArtifact(ctx context.Context, out io.Writer, cli APIClient, workspace string, a *latest.DockerArtifact, initialTag string) error

BuildArtifact performs a docker build and returns nothing

func CreateDockerTarContext

func CreateDockerTarContext(ctx context.Context, w io.Writer, workspace string, a *latest.DockerArtifact) error

func CreateDockerTarGzContext

func CreateDockerTarGzContext(ctx context.Context, w io.Writer, workspace string, a *latest.DockerArtifact) error

func Digest

func Digest(ctx context.Context, cli APIClient, ref string) (string, error)

Digest returns the image digest for a corresponding reference. The digest is of the form sha256:<image_id>

func GetBuildArgs

func GetBuildArgs(a *latest.DockerArtifact) []string

GetBuildArgs gives the build args flags for docker build.

func GetDependencies

func GetDependencies(ctx context.Context, workspace string, a *latest.DockerArtifact) ([]string, error)

GetDependencies finds the sources dependencies for the given docker artifact. All paths are relative to the workspace.

func NormalizeDockerfilePath

func NormalizeDockerfilePath(context, dockerfile string) (string, error)

NormalizeDockerfilePath returns the absolute path to the dockerfile.

func RemoteDigest

func RemoteDigest(identifier string) (string, error)

func RunPush

func RunPush(ctx context.Context, cli APIClient, ref string, out io.Writer) error

func StreamDockerMessages

func StreamDockerMessages(dst io.Writer, src io.Reader) error

StreamDockerMessages streams formatted json output from the docker daemon TODO(@r2d4): Make this output much better, this is the bare minimum

func UploadContextToGCS

func UploadContextToGCS(ctx context.Context, workspace string, a *latest.DockerArtifact, bucket, objectName string) error

func ValidateDockerfile

func ValidateDockerfile(path string) bool

Types

type APIClient

type APIClient interface {
	client.CommonAPIClient
}

func NewAPIClient

func NewAPIClient() (APIClient, error)

NewAPIClient guesses the docker client to use based on current kubernetes context.

type AuthConfigHelper

type AuthConfigHelper interface {
	GetAuthConfig(registry string) (types.AuthConfig, error)
	GetAllAuthConfigs() (map[string]types.AuthConfig, error)
}

AuthConfigHelper exists for testing purposes since GetAuthConfig shells out to native store helpers. Ideally this shouldn't be public, but the LocalBuilder needs to use it.

var (
	// DefaultAuthHelper is exposed so that other packages can override it for testing
	DefaultAuthHelper AuthConfigHelper
)

type ImageReference

type ImageReference struct {
	BaseName       string
	Tag            string
	FullyQualified bool
}

ImageReference is a parsed image name.

func ParseReference

func ParseReference(image string) (*ImageReference, error)

ParseReference parses an image name to a reference.