Configuration
Config is environment variables (optional .env via Viper). Highlights from the project:
Orchestrator
Section titled “Orchestrator”| Variable | Role |
|---|---|
ORCHESTRATOR_GITHUB_WEBHOOK_SECRET |
GitHub webhook HMAC |
ORCHESTRATOR_GITHUB_ACCESS_TOKEN |
GitHub API (files, comments) |
ORCHESTRATOR_AGENT_PING_INTERVAL |
Agent WS ping interval (default 30s) |
ORCHESTRATOR_AGENT_PONG_TIMEOUT |
Wait for pong after ping (default 3s) |
ORCHESTRATOR_AGENT_MISSED_HEARTBEATS |
Consecutive missed pongs before disconnect (default 2) |
DATABASE_URL / DATABASE_DRIVER |
Job/lock persistence |
SHARED_AUTH_TOKEN |
Orchestrator ↔ agent auth |
| Variable | Role |
|---|---|
AGENT_ID |
Must match agent: in terraplane.yaml |
AGENT_ORCHESTRATOR_URL |
WebSocket URL (ws://…/ws) |
AGENT_SCM_SSH_KEY_PATH |
Deploy key for clone |
SHARED_AUTH_TOKEN |
Must match the orchestrator |
See .env-example in the repository for the full set as it evolves.