Skip to main content

Feature: Production Promotion

Purpose​

  • Feature name: Production promotion
  • Why this feature exists: Ensure production deploys only after required checks pass.

Scope​

In scope​

  • required GitHub checks
  • Vercel deployment checks
  • production domain promotion

Out of scope​

  • rollback procedures
  • staging validation

Prereqs / Inputs​

  • required checks configured in GitHub rulesets
  • Vercel deployment checks enabled

Procedure / Content​

Feature summary​

  • Feature name: Production promotion
  • Feature group: CI/CD and environment promotion
  • Technical summary: Production deployment is gated by CI checks and deployment checks.
  • Low-tech summary: Only verified builds can reach production.

Feature in action​

  • Where to see it working: Merge to main with required checks passing.

Confirmation Process​

Manual​

  • Steps: Merge a PR to main, verify checks pass, confirm deployment status.
  • What to look for: Required checks satisfied, Vercel marks deployment ready.
  • Artifacts or reports to inspect: GitHub checks, Vercel deployment status.

Tests​

Potential behavior if broken or misconfigured​

  • Production deploys without required checks.
  • Checks fail but deployment still proceeds.

Long-term maintenance notes​

  • Keep required check names stable.
  • Reconfirm deployment checks after CI changes.

Dependencies, libraries, tools​

  • GitHub Actions
  • Vercel

Source code references (GitHub URLs)​

ADRs​

Runbooks​

Additional internal references​

Validation / Expected outcomes​

  • Production promotion only occurs after checks pass.

Failure modes / Troubleshooting​

  • Checks bypassed: update rulesets and deployment checks.

References​

  • None.