docker #
registry #
images are published to atcr.io — an OCI-compliant container registry built on AT Protocol. source: evan.jarrett.net/at-container-registry.
atcr.io/zzstoatzz.io/prefect-server:latest
publishing #
just docker-publish # push :latest
just docker-publish v0.1.0 # push specific tag
requires the docker-credential-atcr helper and the active account set to
zzstoatzz.io:
# install via the official script (defaults to /usr/local/bin; override with
# INSTALL_DIR if you can't write there)
INSTALL_DIR=/opt/homebrew/bin curl -fsSL https://atcr.io/static/install.sh | INSTALL_DIR=/opt/homebrew/bin bash
# wire it into docker
jq '. + {credHelpers: (.credHelpers // {} | . + {"atcr.io": "atcr"})}' ~/.docker/config.json \
> ~/.docker/config.json.new && mv ~/.docker/config.json{.new,}
# authenticate (device flow — prints a URL + code, opens browser)
docker-credential-atcr login
# verify active account
docker-credential-atcr status # zzstoatzz.io should be marked with `*`
# push (the helper authenticates automatically)
docker push atcr.io/zzstoatzz.io/prefect-server:latest
multiple accounts (e.g. zat.dev + zzstoatzz.io) coexist — switch
with docker-credential-atcr switch <handle> before publishing.
CI #
.tangled/workflows/publish-image.yml builds + pushes via kaniko on every
main push (and on manual trigger). pattern adapted from
tranquil-pds/.tangled/workflows/publish-image.yml.
two destinations per build:
atcr.io/zzstoatzz.io/prefect-server:latestatcr.io/zzstoatzz.io/prefect-server:$TANGLED_COMMIT_SHA
one-time setup — a single tangled CI secret on this repo:
ATCR_APP_PASSWORD— your raw ATProto app-password (the hyphenated 4×4-char token from https://bsky.app/settings/app-passwords or your PDS). The workflow composes<handle>:<password>and base64s it before handing it to kaniko, so you paste the password as-is.
the workflow exits cleanly (no failure) when the secret is unset, so the workflow file can land before the secret is configured.
open questions (atcr.io is young):
- DPoP/OAuth refresh-token lifetime in CI — re-set the secret if pushes start failing with 401
- whether atcr.io will add CI-specific auth (app passwords / service tokens) on top of the per-user device flow
image details #
- base:
alpine:3.20 - size: ~47MB
- healthcheck:
curl -f http://localhost:4200/api/health - published image: amd64. Docker on an arm64 host may run it under emulation and report a platform mismatch.