Charlie/project-charlie
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(automation): note docker-buildx-plugin as build-host prerequisite

Browse Source 
DOCKER_BUILDKIT=1 in the build workflow only works if the host has
the buildx CLI plugin installed. Bare docker-ce sometimes ships
without it (Debian/Ubuntu separate packaging). Document the install
so future hosts onboarding to be build targets don't hit the same
'BuildKit is enabled but the buildx component is missing' error.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
Alexandru Macocian
2026-05-22 14:42:18 +02:00
parent 8697048196
commit 9042cb143b
1 changed files with 1 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/automation.md
+1
View File
@@ -285,6 +285,7 @@ Requirements are a strict subset of the regular deploy-target prerequisites
| `sys-gitea-runner` resolvable via LDAP + member of `charlie-deploy` | SSH session + docker socket access. |
| sshd trusts the step-ca SSH user CA | Runner-issued user certs are accepted. |
| `/var/run/docker.sock` is `root:charlie-deploy` | `docker build` / `push` work without sudo. |
| `docker buildx` plugin installed (`docker-buildx-plugin` / `docker-cli-buildx`) | The workflow exports `DOCKER_BUILDKIT=1` so Dockerfiles can use `RUN --mount=type=cache` etc. Without buildx, `docker build` errors with "BuildKit is enabled but the buildx component is missing". Verify with `docker buildx version`. |
| `git` available on the host | Cloning the caller source into the scratch workdir. |
| Outbound HTTPS to `gitea.alexandru.macocian.me` | `docker push` + `git clone`. |