Commit 33ab9605 authored by Dan Jensen's avatar Dan Jensen Committed by Achilleas Pipinellis

Clarify zero-downtime upgrade docs

The documentation was not sufficiently clear that skip-version
upgrades are discouraged for zero-downtime upgrades. This adds some
clarification.
parent c6833727
...@@ -169,7 +169,8 @@ migration](../integration/elasticsearch.md#retry-a-halted-migration). ...@@ -169,7 +169,8 @@ migration](../integration/elasticsearch.md#retry-a-halted-migration).
## Upgrade paths ## Upgrade paths
Although you can generally upgrade through multiple GitLab versions in one go, You can generally upgrade through multiple GitLab versions in one go,
although this is discouraged for [zero downtime upgrades](#upgrading-without-downtime) and
sometimes this can cause issues. sometimes this can cause issues.
Find where your version sits in the upgrade path below, and upgrade GitLab Find where your version sits in the upgrade path below, and upgrade GitLab
...@@ -228,7 +229,8 @@ patch version of GitLab without having to take your GitLab instance offline. ...@@ -228,7 +229,8 @@ patch version of GitLab without having to take your GitLab instance offline.
However, for this to work there are the following requirements: However, for this to work there are the following requirements:
- You can only upgrade 1 minor release at a time. So from 9.1 to 9.2, not to - You can only upgrade 1 minor release at a time. So from 9.1 to 9.2, not to
9.3. 9.3. If you skip releases, database modifications may be run in the wrong
sequence [and leave the database schema in a broken state](https://gitlab.com/gitlab-org/gitlab/-/issues/321542).
- You have to use [post-deployment - You have to use [post-deployment
migrations](../development/post_deployment_migrations.md) (included in migrations](../development/post_deployment_migrations.md) (included in
[zero downtime update steps below](#steps)). [zero downtime update steps below](#steps)).
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment