From 9042cb143b1dc89c4f3de28fb5a1d27ed8cb5afb Mon Sep 17 00:00:00 2001 From: Alexandru Macocian Date: Fri, 22 May 2026 14:42:18 +0200 Subject: [PATCH] docs(automation): note docker-buildx-plugin as build-host prerequisite 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> --- docs/automation.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/automation.md b/docs/automation.md index 4881b63..b8544e5 100644 --- a/docs/automation.md +++ b/docs/automation.md @@ -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`. |