Files
project-charlie/docs/runners.md
T
2026-06-13 17:26:49 +02:00

30 lines
1.6 KiB
Markdown

# Runners
| Area | Current state |
| ------------ | ------------------------------------------------------ |
| Stack repo | `Charlie/runners` |
| Image repo | `amacocian/gitea-runner` |
| Hosts | morgott, melina |
| Registration | instance-wide Gitea Actions runners |
| Storage | host-local `/var/lib/charlie/runner` |
| Deploy model | cross-deploy; each runner updates the other host first |
## Runtime model
| Item | State |
| ---------------- | ------------------------------------------- |
| Runner container | Stateless except registration credential. |
| Job routing | Any runner for normal stacks. |
| Target work | SSH to host as `sys-gitea-runner`. |
| SSH auth | short-lived step-ca cert. |
| Docker access | target host socket via `charlie-deploy`. |
| Repo access | `RUNNER_REPO_PAT` and host Git credentials. |
## Exceptions
| Exception | State |
| -------------------------- | -------------------------------------------------- |
| `Charlie/runners` workflow | Does not use `deploy-stack.yml`. |
| Precise runner labels | Used only for runner cross-deploy. |
| `@main` cache | Bust or tag when workflow/action contract changes. |