Architecture
Designed for deterministic recovery
Runner host
- Windows service for consistent execution.
- Separation between orchestration and execution.
- Local logs for host-level diagnostics.
Workflow layer
- Manual dispatch, schedules, and issue triggers.
- Explicit approvals and audit trails.
- Safe rollbacks and idempotent steps.
Agent runtime
- Python execution with reproducible environments.
- Structured logging and artifacts.
- Designed for reliable remediation.
Operations
Runbooks built for busy teams
cd C:\actions-runner
$serviceName = Get-Content .\.service
Restart-Service -Name $serviceName
See docs/operations.md for upgrade, rotation, and health checks.
Security
Least-privilege by default
Token scopes
- Required: repo, workflow, read:org.
- Optional: admin:org based on policy.
- Always fetch short-lived tokens.
Auditability
- GitHub Actions logs are authoritative.
- Host logs retained for forensics.
- Explicit approvals for sensitive tasks.
Reference