Operations Runbooks

This folder holds operator-facing procedures for recurring BFDev maintenance, platform, and CI tasks.

Use these pages for practical execution steps, safety checks, cleanup actions, and references to the underlying implementation.

Current Runbooks

• Manage Staging Release Validation: validate the weekly BetterFleet Manage staging release candidate using the MR validation query, deployment identity checks, core operational smoke checks for load management and charger state, release-specific add-ons, monitoring, and a per-release Linear validation issue.
• Staging Hotfix Release: promote a merged hotfix into release, start the guided deploy-release-branch-to-staging action for one target project, and validate the result in staging without invoking bring-all-code-to-release-branch.
• Production Hotfix Release: restore release to the last known production state, cherry-pick only the approved hotfix, and start the guided release-branch pipeline for one target project before the downstream manual production promotion and incident evidence.
• Terraform Plan Dry Runs: safely expose protected variables and runners to a merge request pipeline long enough to validate IaC changes before merge, without enabling release, image publish, or deploy side effects.