Development and Deploy Runbook

Date: 2026-02-08 Status: Draft

Environment Modes

• Dev: fast iteration, nightly images, lower risk.
• Prod: gated deployment and stable tags only.

Key Workflows

• Main deployment pipeline: .github/workflows/deploy.yml
• Environment controls: .github/workflows/env-control.yml
• Terraform bootstrapping: .github/workflows/bootstrap-infra.yml

Dev vs Prod Deploy Flags

• In deploy workflow dispatch:
• deploy_prod=false for dev-only apply
• deploy_prod=true for prod promotion (requires gating)
• Terraform image tag conventions:
• Dev uses nightly
• Prod uses stable

Tenant Fleet Operations

• Deployments target tenant service sets in waves.
• Start with a canary tenant group before broad rollout.
• Rollback must support per-tenant targeting when issues are isolated.

Log-First Debug Loop

1. Identify service and environment.
2. Pull bounded logs for the time window.
3. Correlate by request/run/tenant/workspace IDs.
4. Confirm behavior against spec and contracts.
5. Update docs when behavior/decision changed.