Skill: Deployment Checklist

Skill: Deployment Checklist

To Staging (automatic)

Merge MR to develop branch. GitLab CI/CD:

  1. Runs full CI pipeline
  2. Builds Docker image
  3. Deploys to staging server
  4. Runs smoke test

To Production

  1. Ensure staging has been tested
  2. Create a release tag from main:
    git checkout main
    git pull
    git tag v1.x.x
    git push origin v1.x.x
  3. GitLab CI/CD:
    • Builds production Docker image
    • Runs migration
    • Deploys to production
    • Pushes OTA update (if JS-only change)
    • Generates changelog

Pre-deployment Checklist

  • All tests pass on develop
  • Staging tested and verified
  • Database migrations reviewed
  • No breaking API changes (or documented and versioned)
  • Environment variables added to production (if new)
  • Feature flags configured (if applicable)

Rollback

  • Revert the tag or deploy previous Docker image
  • If migration was destructive: restore from backup