Processes
Release Management
How we stage and ship releases.
Purpose
Ensure releases are predictable, observable, and reversible.
Inputs
- Approved change(s)
- Verified test results
Procedure
- Ensure service tests pass (
uv run pytestor service-specific tests). - Merge to
mainto trigger automated builds and dev deployments (no additional approvals). - Use Cloud Deploy to promote to production (approval required for prod).
- Monitor Cloud Run logs and error rates after rollout.
- Roll back via Cloud Deploy if regressions appear.
Notes
- There is no standard release note or changelog requirement.
- Use feature flags (Statsig) for risky changes and default them to off.
Last updated on