Skip to main content
Unlisted page
This page is unlisted. Search engines will not index it, and only users having a direct link can access it.

Upgrades and migrations

This page describes how to approach upgrades safely.

Principles​

  • Upgrade in staging before production.
  • Keep a rollback path for application deployments.
  • Treat database migrations as a controlled change with verification.
  1. Read release notes and migration notes (if available): Changelog.
  2. Backup the database and validate restore readiness.
  3. Apply migrations in a controlled window.
  4. Deploy the new application version.
  5. Run smoke checks:
    • health
    • token issue
    • authorize and commit
  6. Monitor error rates and backlog for a stability window.

Next​