Skip to main content

Deploy and Runbooks

Workflow Structure​

All deploy workflows follow:

  1. config job sets app-specific outputs
  2. test job validates package
  3. deploy jobs execute by app pattern

See .github/workflows/README.md for reusable workflow details.

Main Patterns​

  • PB + CF Pages
  • PB + Docker
  • CF Pages
  • CF Worker
  • Docker

Each pattern has explicit dev -> prod ordering and promotion gates.

Incident Triage​

Deployment Did Not Promote To Prod​

  1. Check dev deploy job result.
  2. Verify gate conditions in workflow if: expressions.
  3. Confirm config outputs match expected app names.

Build Succeeds Locally, Fails In CI​

  1. Ensure generated files are deterministic.
  2. Verify env-specific variables in workflow build-env.
  3. Check package filter scope in reusable test job.