prefect server in zig

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:latest
  • atcr.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.