Skip to content

Commit

Permalink
adjust self-hosted hard stop documentation (#11146)
Browse files Browse the repository at this point in the history
- add `24.8.0` as a pre-squash hard stop (for commits similar to: getsentry/sentry#76507 )
- change hard stops to a list so they don't need a scroll back
- add an example upgrade
  • Loading branch information
asottile-sentry committed Aug 26, 2024
1 parent 58ff6df commit 1867a86
Showing 1 changed file with 15 additions and 4 deletions.
19 changes: 15 additions & 4 deletions develop-docs/self-hosted/releases.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -41,15 +41,26 @@ Finally, to upgrade, just run `./install.sh`.

### Hard Stops

These are the hard stops that you need to go through in order to pick up significant database changes:
When upgrading one must upgrade to **each** hard stop to pick up significant database changes.

```
<your.sentry.version> -> 9.1.2 -> 21.5.0 -> 21.6.3 -> 23.6.2 -> 23.11.0 -> latest
```
These are the hard stops that one needs to go through:

- 9.1.2
- 21.5.0
- 21.6.3
- 23.6.2
- 23.11.0
- 24.8.0

Versions to avoid upgrading to:
- `23.7.0` (issues around database migrations and the Django 3 upgrade)

As an example if one wants to go from `22.8.0` to `24.2.0` one needs the following upgrade path:

```
# example
(initial: 22.8.0) -> 23.6.2 -> 23.11.0 -> 24.2.0
```

## Nightly Builds

Expand Down

0 comments on commit 1867a86

Please sign in to comment.