docs(local): document docker-container driver for buildx builders

This commit is contained in:
Patrick Schratz 2026-06-14 11:12:33 +02:00
commit c8412dcdb1
Signed by: pat-s
GPG key ID: 3C6318841EF78925

View file

@ -7,9 +7,11 @@
# refreshed so the result is immediately servable.
#
# Prerequisites:
# - buildx builders named `artemis` (amd64) and `gaia` (arm64), e.g.
# docker buildx create --name artemis --node artemis ssh://<host-amd64>
# docker buildx create --name gaia --node gaia ssh://<host-arm64>
# - buildx builders named `artemis` (amd64) and `gaia` (arm64), created with the
# docker-container driver (runs BuildKit on the remote host's docker daemon over
# SSH). The default `remote` driver does NOT work with an ssh:// docker host.
# docker buildx create --name artemis --driver docker-container ssh://<user@host-amd64>
# docker buildx create --name gaia --driver docker-container ssh://<user@host-arm64>
# - exported secrets: B2_S3_ACCESS_KEY, B2_S3_SECRET_KEY, PGPASS (GITHUB_PAT optional)
#
# Overridable (env or `just VAR=… rebuild …`):