summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorYorick Peterse <yorickpeterse@gmail.com>2019-06-18 13:57:10 +0200
committerYorick Peterse <yorickpeterse@gmail.com>2019-06-18 15:32:48 +0200
commite2aaa602e87badc11533b4c819714a608cc16909 (patch)
tree2eb85d7cc17ba8378a0d494808df18fc202c0218
parentd051d1f81dfc01d8d16f938fba81278301b29e51 (diff)
downloadgitlab-ce-e2aaa602e87badc11533b4c819714a608cc16909.tar.gz
Added source upgrade guides for 12.0.0docs/12-0-upgrade
-rw-r--r--doc/update/upgrading_from_source.md21
1 files changed, 21 insertions, 0 deletions
diff --git a/doc/update/upgrading_from_source.md b/doc/update/upgrading_from_source.md
index bc8e5fed774..5e18769f0f1 100644
--- a/doc/update/upgrading_from_source.md
+++ b/doc/update/upgrading_from_source.md
@@ -4,6 +4,10 @@ comments: false
# Upgrading Community Edition and Enterprise Edition from source
+NOTE: **Note:**
+Users wishing to upgrade to 12.0.0 will have to take some extra steps. See the
+version specific upgrade instructions for 12.0.0 for more details.
+
Make sure you view this update guide from the branch (version) of GitLab you
would like to install (e.g., `11.8`. You can select the version in the version
dropdown at the top left corner of GitLab (below the menu bar).
@@ -404,6 +408,23 @@ Example:
Additional instructions here.
-->
+### 12.0.0
+
+In 12.0.0 we made various database related changes. These changes require that
+users first upgrade to the latest 11.11 patch release. Once upgraded to 11.11.x,
+users can upgrade to 12.0.x. You **can not** upgrade from 11.11.x to 12.1.0 or a
+newer version, instead you **must** first upgrade to 12.0.0. Failure to do so
+may result in database migrations not being applied, which could lead to
+application errors.
+
+Example 1: you are currently using GitLab 11.11.3, which is the latest patch
+release for 11.11.x. To upgrade, first upgrade to 12.0.0, then upgrade to any
+future versions.
+
+Example 2: you are currently using a version of GitLab 10.x. To upgrade, first
+upgrade to 11.11.3. Once upgraded to 11.11.3 you can safely upgrade to 12.0.0,
+then upgrade to any future versions.
+
## Things went south? Revert to previous version
### 1. Revert the code to the previous version