Vera

CI Runners - Pool vs Host-Pinned

Which runner executes which job, and why some jobs can only run on one box.

CI Runners - Pool vs Host-Pinned (v2026-08-28T093439Z-747172b178) 2026-08-28 | Which runner executes which job, and why some jobs can only run on one box. 1 - CI Runner Pool - Job Assignment Gitea GET /api/v1/repos/spw1/antigravity/actions/runs POST /api/v1/repos/spw1/antigravity/actions/runs GET /api/v1/repos/spw1/antigravity/actions/jobs runner_sweep.py daemon/src/runner_sweep.py Gitea Actions Database jobs table runs table networks table job data orphan networks 2 - CI Runner Configuration Vera Runner deploy/vera/act-runner/config.yaml ubuntu-latest:docker://catthehacker/ubuntu:act-22.04 vera-box:docker://catthehacker/ubuntu:act-22.04 Orion Runner deploy/orion/act-runner/config.yaml ubuntu-latest:docker://catthehacker/ubuntu:act-22.04 vera-box:docker://catthehacker/ubuntu:act-22.04 Kevin Runner deploy/kevin/act-runner/config.yaml kevin-box:docker://catthehacker/ubuntu:act-22.04 runner config runner labels 1. Gitea fetches job data 2. runner_sweep.py checks orph… 3. runner_sweep.py checks job… 4. Gitea updates job status 5. Runners fetch new jobs 6. Runners execute jobs Gitea Job Data job_id: 12345 workflow_id: 67890 status: in_progress started_at: 2023-10-01T12:00:00Z Runner Configuration capacity: 3 labels: ubuntu-latest, vera-box docker_host: - The runner configuration specifies which jobs each runner can execute based on labels. The runner_sweep.py script checks for orphaned Docker networks and jobs with zero timestamps to identify broken runners. Legend actor = initiates work · process = code path · store = state on disk · bus = durable queue · dashed = separate process cyan = request flow · pink = state read/write · dashed green = pull / return path · red = refusal As of 2026-08-28 11:16 UTC, from commit 68470f5

Provenance

This drawing is generated, not drawn. It is rebuilt from the source files below, so when they change the picture changes — a diagram here cannot quietly describe a system that no longer works this way.

Owner
Vera
Slug
ci-runner-pool
Rendered
2026-08-28T093439Z
From commit
747172b178
Updated
28 Aug 2026, 11:16 UTC
Sources at
68470f5
Watches
5 paths
  • .gitea/workflows
  • deploy/vera/act-runner
  • deploy/kevin/act-runner
  • deploy/orion/act-runner
  • daemon/src/runner_sweep.py