diff options
Diffstat (limited to 'doc/update')
| -rw-r--r-- | doc/update/README.md | 1 | ||||
| -rw-r--r-- | doc/update/index.md | 20 | ||||
| -rw-r--r-- | doc/update/mysql_to_postgresql.md | 8 | ||||
| -rw-r--r-- | doc/update/patch_versions.md | 2 | ||||
| -rw-r--r-- | doc/update/upgrading_from_ce_to_ee.md | 2 | ||||
| -rw-r--r-- | doc/update/upgrading_from_source.md | 20 | ||||
| -rw-r--r-- | doc/update/upgrading_postgresql_using_slony.md | 2 |
7 files changed, 31 insertions, 24 deletions
diff --git a/doc/update/README.md b/doc/update/README.md index c815842480c..488d86f129d 100644 --- a/doc/update/README.md +++ b/doc/update/README.md @@ -1,5 +1,6 @@ --- redirect_to: 'index.md' +remove_date: '2021-05-11' --- This document was moved to [another location](index.md). diff --git a/doc/update/index.md b/doc/update/index.md index 4c4dfe79d03..2ac22631289 100644 --- a/doc/update/index.md +++ b/doc/update/index.md @@ -53,7 +53,7 @@ have since switched to using a single document. The old upgrading guidelines can still be found in the Git repository: - [Old upgrading guidelines for Community Edition](https://gitlab.com/gitlab-org/gitlab-foss/tree/11-8-stable/doc/update) -- [Old upgrading guidelines for Enterprise Edition](https://gitlab.com/gitlab-org/gitlab/tree/11-8-stable-ee/doc/update) +- [Old upgrading guidelines for Enterprise Edition](https://gitlab.com/gitlab-org/gitlab/-/tree/11-8-stable-ee/doc/update) ### Installation using Docker @@ -194,7 +194,7 @@ Find where your version sits in the upgrade path below, and upgrade GitLab accordingly, while also consulting the [version-specific upgrade instructions](#version-specific-upgrading-instructions): -`8.11.Z` -> `8.12.0` -> `8.17.7` -> `9.5.10` -> `10.8.7` -> `11.11.8` -> `12.0.12` -> `12.1.17` -> `12.10.14` -> `13.0.14` -> `13.1.11` -> [latest `13.Y.Z`](https://about.gitlab.com/releases/categories/releases/) +`8.11.Z` -> `8.12.0` -> `8.17.7` -> `9.5.10` -> `10.8.7` -> `11.11.8` -> `12.0.12` -> `12.1.17` -> `12.10.14` -> `13.0.14` -> `13.1.11` -> [latest `13.12.Z`](https://about.gitlab.com/releases/categories/releases/) -> [latest `14.0.Z`](https://about.gitlab.com/releases/categories/releases/) The following table, while not exhaustive, shows some examples of the supported upgrade paths. @@ -342,10 +342,10 @@ possible. ## Version-specific upgrading instructions -Each month, a major or minor release of GitLab is published along with a +Each month, major, minor or patch releases of GitLab are published along with a [release post](https://about.gitlab.com/releases/categories/releases/). -You should check all the major and minor versions you're passing over. -At the end of those release posts, there are three sections to look for: +You should read the release posts for all versions you're passing over. +At the end of major and minor release posts, there are three sections to look for specifically: - Deprecations - Removals @@ -369,6 +369,16 @@ NOTE: Specific information that follow related to Ruby and Git versions do not apply to [Omnibus installations](https://docs.gitlab.com/omnibus/) and [Helm Chart deployments](https://docs.gitlab.com/charts/). They come with appropriate Ruby and Git versions and are not using system binaries for Ruby and Git. There is no need to install Ruby or Git when utilizing these two approaches. +### 14.0.0 + +In GitLab 13.3 some [pipeline processing methods were deprecated](https://gitlab.com/gitlab-org/gitlab/-/issues/218536) +and this code was completely removed in GitLab 14.0. If you plan to upgrade from +**GitLab 13.2 or older** directly to 14.0, you should not have any pipelines running +when you upgrade. The pipelines might report the wrong status when the upgrade completes. +You should shut down GitLab and wait for all pipelines on runners to complete, then upgrade +GitLab to 14.0. Alternatively, you can first upgrade GitLab to a version between 13.3 and +13.12, then upgrade to 14.0. + ### 13.11.0 Git 2.31.x and later is required. We recommend you use the diff --git a/doc/update/mysql_to_postgresql.md b/doc/update/mysql_to_postgresql.md index cbe2381e8db..92337f279d6 100644 --- a/doc/update/mysql_to_postgresql.md +++ b/doc/update/mysql_to_postgresql.md @@ -91,10 +91,10 @@ need to enable the bundled PostgreSQL: 1. [Reconfigure GitLab](../administration/restart_gitlab.md#omnibus-gitlab-reconfigure) for the changes to take effect. -1. Start Unicorn and PostgreSQL so that we can prepare the schema: +1. Start Puma and PostgreSQL so that we can prepare the schema: ```shell - sudo gitlab-ctl start unicorn + sudo gitlab-ctl start puma sudo gitlab-ctl start postgresql ``` @@ -104,10 +104,10 @@ need to enable the bundled PostgreSQL: sudo gitlab-rake db:create db:migrate ``` -1. Stop Unicorn to prevent other database access from interfering with the loading of data: +1. Stop Puma to prevent other database access from interfering with the loading of data: ```shell - sudo gitlab-ctl stop unicorn + sudo gitlab-ctl stop puma ``` After these steps, you have a fresh PostgreSQL database with up-to-date schema. diff --git a/doc/update/patch_versions.md b/doc/update/patch_versions.md index ce0ba46b518..e50bc1610ab 100644 --- a/doc/update/patch_versions.md +++ b/doc/update/patch_versions.md @@ -9,7 +9,7 @@ comments: false ## Select Version to Install -Make sure you view [this update guide](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/update/patch_versions.md) from the tag (version) of GitLab you would like to install. +Make sure you view [this update guide](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/update/patch_versions.md) from the tag (version) of GitLab you would like to install. In most cases this should be the highest numbered production tag (without `rc` in it). You can select the tag in the version dropdown in the top left corner of GitLab (below the menu bar). diff --git a/doc/update/upgrading_from_ce_to_ee.md b/doc/update/upgrading_from_ce_to_ee.md index 50d169917ba..93c9432f6d3 100644 --- a/doc/update/upgrading_from_ce_to_ee.md +++ b/doc/update/upgrading_from_ce_to_ee.md @@ -11,7 +11,7 @@ NOTE: In the past we used separate documents for upgrading from Community Edition to Enterprise Edition. These documents can be found in the [`doc/update` directory of Enterprise Edition's source -code](https://gitlab.com/gitlab-org/gitlab/tree/11-8-stable-ee/doc/update). +code](https://gitlab.com/gitlab-org/gitlab/-/tree/11-8-stable-ee/doc/update). If you want to upgrade the version only, for example 11.8 to 11.9, *without* changing the GitLab edition you are using (Community or Enterprise), see the diff --git a/doc/update/upgrading_from_source.md b/doc/update/upgrading_from_source.md index 93d2c2cb288..39e25fc11e7 100644 --- a/doc/update/upgrading_from_source.md +++ b/doc/update/upgrading_from_source.md @@ -82,7 +82,7 @@ sudo make install ### 4. Update Node.js -To check the minimum required Node.js version, see [Node.js versions](../install/requirements.md#nodejs-versions). +To check the minimum required Node.js version, see [Node.js versions](../install/installation.md#software-requirements). GitLab also requires the use of Yarn `>= v1.10.0` to manage JavaScript dependencies. @@ -99,7 +99,7 @@ More information can be found on the [Yarn website](https://classic.yarnpkg.com/ ### 5. Update Go -To check the minimum required Go version, see [Go versions](../install/requirements.md#go-versions). +To check the minimum required Go version, see [Go versions](../install/installation.md#software-requirements). You can check which version you are running with `go version`. @@ -119,12 +119,8 @@ rm go1.13.5.linux-amd64.tar.gz ### 6. Update Git -WARNING: -From GitLab 13.1, you must use at least Git v2.24 (previous minimum version was v2.22). -Git v2.28 is recommended. - To check you are running the minimum required Git version, see -[Git versions](../install/requirements.md#git-versions). +[Git versions](../install/installation.md#software-requirements). From GitLab 13.6, we recommend you use the [Git version provided by Gitaly](https://gitlab.com/gitlab-org/gitaly/-/issues/2729) @@ -153,7 +149,7 @@ Remember to set `git -> bin_path` to `/usr/local/bin/git` in `config/gitlab.yml` ### 7. Update PostgreSQL WARNING: -From GitLab 13.0, you must use at least PostgreSQL 11. +From GitLab 14.0, you must use at least PostgreSQL 12. The latest version of GitLab might depend on a more recent PostgreSQL version than what you're currently running. You may also need to enable some @@ -193,7 +189,7 @@ sudo -u git -H git checkout BRANCH-ee #### New configuration options for `gitlab.yml` -There might be configuration options available for [`gitlab.yml`](https://gitlab.com/gitlab-org/gitlab/blob/master/config/gitlab.yml.example)). +There might be configuration options available for [`gitlab.yml`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/config/gitlab.yml.example)). View them with the command below and apply them manually to your current `gitlab.yml`: ```shell @@ -223,7 +219,7 @@ longer handles setting it. If you are using Apache instead of NGINX see the updated [Apache templates](https://gitlab.com/gitlab-org/gitlab-recipes/tree/master/web-server/apache). Also note that because Apache does not support upstreams behind Unix sockets you must let GitLab Workhorse listen on a TCP port. You can do this -via [`/etc/default/gitlab`](https://gitlab.com/gitlab-org/gitlab/blob/master/lib/support/init.d/gitlab.default.example#L38). +via [`/etc/default/gitlab`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/support/init.d/gitlab.default.example#L38). #### SMTP configuration @@ -234,12 +230,12 @@ add the following line to `config/initializers/smtp_settings.rb`: ActionMailer::Base.delivery_method = :smtp ``` -See [`smtp_settings.rb.sample`](https://gitlab.com/gitlab-org/gitlab/blob/master/config/initializers/smtp_settings.rb.sample#L13) as an example. +See [`smtp_settings.rb.sample`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/config/initializers/smtp_settings.rb.sample#L13) as an example. #### Init script There might be new configuration options available for -[`gitlab.default.example`](https://gitlab.com/gitlab-org/gitlab/blob/master/lib/support/init.d/gitlab.default.example). +[`gitlab.default.example`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/support/init.d/gitlab.default.example). View them with the command below and apply them manually to your current `/etc/default/gitlab`: ```shell diff --git a/doc/update/upgrading_postgresql_using_slony.md b/doc/update/upgrading_postgresql_using_slony.md index 2cddaa5da8b..3e977749207 100644 --- a/doc/update/upgrading_postgresql_using_slony.md +++ b/doc/update/upgrading_postgresql_using_slony.md @@ -371,7 +371,7 @@ First, let's stop all of GitLab. Omnibus users can do so by running the following on their GitLab servers: ```shell -sudo gitlab-ctl stop unicorn +sudo gitlab-ctl stop puma sudo gitlab-ctl stop sidekiq sudo gitlab-ctl stop mailroom ``` |