image

Documentation

Overview

Package image lazily builds the embedded sandbox base image on first use.

Index

• func Build(ctx context.Context, dockerBin, ref string) error
• func Ref() string
• func Register(d *runtime.DockerCLI)

Functions

func Build

func Build(ctx context.Context, dockerBin, ref string) error

Build builds ref from the embedded Dockerfile. The build context is a temp dir containing only the Dockerfile (the image needs no local files). Progress streams to stderr.

func Ref

func Ref() string

Ref is the reference of the base image this build produces:

sandbox-base:<generation>-<short hash of the embedded Dockerfile>

The hash makes the tag content-addressed, so editing assets/Dockerfile always yields a new tag. EnsureImage then sees the image as absent and rebuilds it. Relying on a hand-bumped version instead let four image changes ship under one tag, leaving stale images that silently lacked the egress entrypoint and the pre-created cache directories.

func Register

func Register(d *runtime.DockerCLI)

Register wires the image builder into a DockerCLI runtime so EnsureImage can build a missing base image. Call this once at startup.