imagelabel

package
v0.7.35 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 8, 2026 License: MIT Imports: 2 Imported by: 0

Documentation

Overview

Package imagelabel names the label every image the runner builds carries: org.agentry.image=<kind>. A build's tag is content-keyed, so a new CLI, runner content, exec catalogue or pin builds a new tag and leaves the old image behind, and the classic builder leaves a multi-stage build's earlier stages behind untagged. Neither can be found by name; both can by this label, which is what the desktop's Docker images list and removal select by.

The label is written into each Dockerfile, in every stage that runs an instruction, rather than passed as `docker build --label`: the flag labels the final image only, and an earlier stage the classic builder leaves dangling would carry nothing.

The key is deliberately none of the run's own (agentry.run, agentry.gateway.run, agentry.owner.*): a container inherits its image's labels, so an image key the run sweep or the socket filter read would make every container of that image look like one run's. No run id is put on an image either: every build is shared by later runs.

Index

Constants

View Source
const (
	// Runner is the runner image (runnerimage/Dockerfile) and its build stage.
	Runner = "runner"
	// Exec is a per-QuickAgent exec image built on the runner image.
	Exec = "exec"
	// UnsafeExec is an Unsafe Mode exec image built on the unsafe base.
	UnsafeExec = "unsafe-exec"
	// CoderExec is the Coding agent's exec image built on its toolchain image.
	CoderExec = "coder-exec"
	// Decode is the decode step's image built on the files image.
	Decode = "decode"
	// HostLink is the host link's image built on the hostlink image.
	HostLink = "hostlink"
	// ClaudeCode is the Claude Code harness image and its unpack stage.
	ClaudeCode = "claude-code"
	// Copilot is the Copilot CLI harness image and its unpack stage.
	Copilot = "copilot"
	// Codex is the Codex harness image built from Codex's newest release.
	Codex = "codex"
)

The kinds, the label's values: one per image the runner builds.

View Source
const Filter = "label=" + Key

Filter is the `docker image ls --filter` argument that selects every image the runner built, of any kind.

View Source
const Key = "org.agentry.image"

Key is the label every image the runner builds carries.

Variables

This section is empty.

Functions

func Check

func Check(dockerfile, kind string) error

Check reports the first stage of dockerfile that runs an instruction and does not carry Line(kind). A stage that is only a FROM (and ARGs) makes no image of its own and needs no label. It reads the Dockerfiles the runner generates line by line and is no Dockerfile parser: a heredoc, or the label written any other way (lower case, with another label on the line), reads as unlabelled, so it fails closed. The builders' tests run it.

func Line

func Line(kind string) string

Line is the Dockerfile instruction that labels a stage with kind, newline-terminated.

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL