Update-sentry

Context: This procedure was written at the time of Sentry 25.10.0, 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. Until we use Podman, Sentry finally lowers the docker-compose version requirement, or until the below steps stop working:
   1. In file install/dc-detect-version.sh need to modify the dcr variable (short for docker compose run, is boilerplate) command to remove the --pull flag
   2. In file install/_min-requirements.sh lower the min required version to at most 2.26.1 (or what version is currently installed)
8. Run `./install.sh`
9. 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