# 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. |