Update-sentry

Context: This procedure was written at the time of Sentry 25.5.1, and applies to upgrades performed on the sentry server.

Important Notes

• It is possible to skip version while upgrading, except for Hard-Stops, which you need to install before updating to newer releases, see Sentry docs on hard stops
• Always consult the official Sentry upgrade documentation first.

Pre-upgrade Steps

1. Read the release notes and prepare accordingly if some specific actions need to be taken
2. Schedule and announce the maintenance window
3. Create a maintenance period in Zabbix
4. Create a backup and/or snapshot

Upgrade Procedure

1. Navigate to `/opt/sentry`
2. Run `git fetch --tags`
3. Run `git checkout <tag of release you want to update to>`
4. Compare `./sentry/config.yml` with `./sentry/config.example.yml`, amend where necessary
5. Compare `.sentry/sentry.conf.py` with `./sentry/sentry.conf.example.py`, amend where necessary
6. Compare `./.env.delftsolutions` with `./.env` , amend where necessary
7. Run `./install.sh`
8. Run `docker compose --env-file .env.delftsolutions up -d`

Post-upgrade Steps

1. Go to Issues > Alerts
2. Pick an alert rule (the kaboom-api rule is suggested), go to the alert edit page
3. On the page, click the button "Send Test Notification", announce the notifications were as expected when they come in
4. Once you've made sure everything is running as expected remove the snapshot and maintenance period