Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

OCI images and builds

Messages below show representative example values (paths, targets, names); the real message carries yours.

ATC-E0412

no cached OCI image for artifact "backend": run `atc oci import acme/backend:1.4`
  • exit code: 3
  • fix: atc oci import acme/backend:1.4

ATC-E0428

OCI daemon unavailable (podman): socket refused
  • exit code: 3
  • fix: systemctl status podman # or start the podman daemon

ATC-E0429

multi-arch image at name=app tag=latest resolved to multiple digests; re-run with an explicit digest. candidates: ["sha256:aaa", "sha256:bbb"]
  • exit code: 3
  • fix: atc oci inspect app@<digest>

ATC-E0430

multi-arch image at name=app tag=latest resolved to multiple platforms; re-run with --platform <os/arch> (e.g. --platform linux/amd64). available platforms: ["linux/amd64", "linux/arm64"]
  • exit code: 3
  • fix: atc oci import app:latest --platform <os/arch>

ATC-E0431

OCI layout invalid at /tmp/layout: missing index.json
  • exit code: 3
  • fix: atc oci gc # or re-import the image

ATC-E0432

OCI blob corrupt: digest sha256:aaa, observed sha256:bbb
  • exit code: 3
  • fix: atc oci gc # or re-import the image

ATC-E0433

could not resolve laptop cache root: no XDG_DATA_HOME
  • exit code: 3
  • fix: export XDG_DATA_HOME=<writable-dir>

ATC-E0434

OCI artifact requires a writable laptop cache (XDG_DATA_HOME); got: read-only fs
  • exit code: 3
  • fix: export XDG_DATA_HOME=<writable-dir>

ATC-E0435

OCI artifact not in laptop cache: name=app ref_or_digest=v1
  • exit code: 3
  • fix: atc oci import app:v1

ATC-E0437

no build engine on PATH (tried: ["buildah", "docker"]). install buildah (https://github.com/containers/buildah) or enable docker buildx.
  • exit code: 3
  • fix: brew install buildah # or: docker buildx install

ATC-E0438

buildah build failed (exit 1); stderr tail:
syntax error
  • exit code: 3
  • fix: atc oci build <reference> --verbose-build

ATC-E0439

build output invalid: empty layer list
  • exit code: 3
  • fix: atc oci build <reference> --verbose-build

ATC-E0445

skopeo not found; run `atc upgrade` to provision the bundled skopeo, or install one: https://github.com/containers/skopeo/blob/main/install.md
  • exit code: 3
  • fix: atc upgrade # provisions the bundled skopeo

ATC-E0446

podman not found on PATH; see https://podman.io/docs/installation
  • exit code: 3
  • fix: brew install podman # or: sudo apt install podman

ATC-E0447

push to registry.example.com/app failed (exit 1): auth failed
  • exit code: 3
  • fix: atc oci push <reference> registry.example.com/app

ATC-E0448

short digest prefix "abc123" is ambiguous; candidates: ["abc123def", "abc123fed"]
  • exit code: 3
  • fix: atc oci inspect <full-digest-or-longer-prefix>

ATC-E0449

bare name "app" has multiple tags; specify one of: ["app:v1", "app:v2"]
  • exit code: 3
  • fix: atc oci inspect app:<tag>

ATC-E0450

tag "app:v1" already points at "sha256:aaa"; pass --force to overwrite
  • exit code: 3
  • fix: atc oci tag <src> app:v1 --force

ATC-E0458

registry authentication failed (registry.gitlab.com): unauthorized: HTTP Basic: Access denied
  • exit code: 3
  • fix: docker login registry.gitlab.com # or: podman login / skopeo login

ATC-E0459

OCI import failed (skopeo): manifest unknown
  • exit code: 3

ATC-E0462

cannot read containerfile /home/dev/app/Containerfile: No such file or directory (os error 2)
--file app/Containerfile is relative to the current directory (/home/dev), not to the build context
  • exit code: 3
  • fix: atc oci build <reference> --file <containerfile> --context <dir>

ATC-E0464

local docker image registry.example.com/org/app:v1 is incomplete: skopeo copy failed: determining manifest MIME type for docker-daemon:registry.example.com/org/app:v1: loading tar component "blobs/sha256/5f4d0288d52e": file does not exist
the docker export names a blob docker does not have; re-pull or rebuild the image in docker, or import it from its registry if it came from one
  • exit code: 3
  • fix: atc oci import registry.example.com/org/app:v1 # pull from the registry, without --docker

ATC-E0471

"db" matches the image ["db:1"] and the digest prefix of ["sha256:db99"]. Pass one listed digest as sha256:<hex>, or one listed image as db:<tag>
  • exit code: 3
  • fix: atc oci inspect sha256:<hex> # or: atc oci inspect db:<tag>

ATC-E0475

a running atcd owns the store at /var/atc. atc does not open it, because a change there skips the daemon's hooks and gates. To remove a channel on this device, run `atc ota rm --socket <atcd-socket> <channel> --purge`. For a laptop cache, set ATC_DATA_HOME to another directory.
  • exit code: 3