docs(AGENTS): document Actions build delegation pattern
Python package / build (3.12.3) (pull_request) Failing after 2m15s
Python package / build (3.13) (pull_request) Failing after 2m1s
Python package / build (3.14) (pull_request) Failing after 1m59s

This commit is contained in:
2026-09-17 19:27:42 +02:00
parent 0196bcda30
commit 2229acc7f2
+12
View File
@@ -97,3 +97,15 @@ When you add a stack, also:
- Add the stack id to the `PROFILES` env var in the brencher stack
compose (`docker_stack` / Swarm declarative) so it gets picked up on
next rollout. The admin overlay is where this lives.
## Build delegation pattern (Actions)
Brencher does not run docker build or docker push itself. It dispatches a Gitea
Actions workflow via `POST /api/v1/repos/{owner}/{repo}/actions/workflows/{file}/dispatches`,
waits for the run to complete, then `docker compose pull` + `docker stack deploy`.
Use `steps.actions.GiteaActionsTrigger` and `steps.actions.GiteaActionsAwait`
in the stack config, set `buildDocker=None` on `DockerSwarmDeploy`, and add
`DockerComposePull` before deploy. Credentials come from brencher env
(`GITEA_TOKEN`) and the compose image must point to a registry the runner can
push to (e.g. Gitea Container Registry `gitea.rudolf.keenetic.link/<owner>/<repo>`).