debian-mirror-gitlab/doc/update/patch_versions.md

125 lines
3.6 KiB
Markdown
Raw Normal View History

2018-03-17 18:26:18 +05:30
---
comments: false
---
2014-09-02 18:07:02 +05:30
# Universal update guide for patch versions
2017-08-17 22:00:37 +05:30
## Select Version to Install
2019-12-04 20:38:33 +05:30
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.
2017-08-17 22:00:37 +05:30
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).
2014-09-02 18:07:02 +05:30
### 0. Backup
2020-01-01 13:55:28 +05:30
It's useful to make a backup just in case things go south. Depending on the installation method, backup commands vary, see the [backing up and restoring GitLab](../raketasks/backup_restore.md#creating-a-backup-of-the-gitlab-system) documentation.
2014-09-02 18:07:02 +05:30
### 1. Stop server
2020-03-13 15:44:24 +05:30
```shell
2015-12-23 02:04:40 +05:30
sudo service gitlab stop
```
2014-09-02 18:07:02 +05:30
### 2. Get latest code for the stable branch
2015-12-23 02:04:40 +05:30
In the commands below, replace `LATEST_TAG` with the latest GitLab tag you want
to update to, for example `v8.0.3`. Use `git tag -l 'v*.[0-9]' --sort='v:refname'`
to see a list of all tags. Make sure to update patch versions only (check your
current version with `cat VERSION`).
2020-03-13 15:44:24 +05:30
```shell
2014-09-02 18:07:02 +05:30
cd /home/git/gitlab
2017-08-17 22:00:37 +05:30
2014-09-02 18:07:02 +05:30
sudo -u git -H git fetch --all
2020-04-22 19:07:51 +05:30
sudo -u git -H git checkout -- Gemfile.lock db/structure.sql locale
2015-10-24 18:46:33 +05:30
sudo -u git -H git checkout LATEST_TAG -b LATEST_TAG
2014-09-02 18:07:02 +05:30
```
2019-12-04 20:38:33 +05:30
### 3. Install libs, migrations, etc
2014-09-02 18:07:02 +05:30
2020-03-13 15:44:24 +05:30
```shell
2014-09-02 18:07:02 +05:30
cd /home/git/gitlab
sudo -u git -H bundle install --without development test mysql --deployment
2016-06-02 11:05:42 +05:30
# Optional: clean up old gems
sudo -u git -H bundle clean
# Run database migrations
2014-09-02 18:07:02 +05:30
sudo -u git -H bundle exec rake db:migrate RAILS_ENV=production
2016-06-02 11:05:42 +05:30
2018-03-17 18:26:18 +05:30
# Compile GetText PO files
# Internationalization was added in `v9.2.0` so these commands are only
# required for versions equal or major to it.
sudo -u git -H bundle exec rake gettext:pack RAILS_ENV=production
sudo -u git -H bundle exec rake gettext:po_to_json RAILS_ENV=production
2016-06-02 11:05:42 +05:30
# Clean up assets and cache
2019-09-04 21:01:54 +05:30
sudo -u git -H bundle exec rake yarn:install gitlab:assets:clean gitlab:assets:compile cache:clear RAILS_ENV=production NODE_ENV=production NODE_OPTIONS="--max_old_space_size=4096"
2017-08-17 22:00:37 +05:30
```
2019-12-04 20:38:33 +05:30
### 4. Update GitLab Workhorse to the corresponding version
2017-08-17 22:00:37 +05:30
2020-03-13 15:44:24 +05:30
```shell
2017-08-17 22:00:37 +05:30
cd /home/git/gitlab
sudo -u git -H bundle exec rake "gitlab:workhorse:install[/home/git/gitlab-workhorse]" RAILS_ENV=production
```
2019-12-21 20:55:43 +05:30
### 5. Update Gitaly to the corresponding version
2018-03-17 18:26:18 +05:30
2020-03-13 15:44:24 +05:30
```shell
2018-03-17 18:26:18 +05:30
cd /home/git/gitlab
2018-12-13 13:39:08 +05:30
sudo -u git -H bundle exec rake "gitlab:gitaly:install[/home/git/gitaly,/home/git/repositories]" RAILS_ENV=production
2018-03-17 18:26:18 +05:30
```
2019-12-04 20:38:33 +05:30
### 6. Update GitLab Shell to the corresponding version
2017-08-17 22:00:37 +05:30
2020-03-13 15:44:24 +05:30
```shell
2017-08-17 22:00:37 +05:30
cd /home/git/gitlab-shell
sudo -u git -H git fetch --all --tags
2018-11-18 11:00:15 +05:30
sudo -u git -H git checkout v$(</home/git/gitlab/GITLAB_SHELL_VERSION) -b v$(</home/git/gitlab/GITLAB_SHELL_VERSION)
2019-12-21 20:55:43 +05:30
sudo -u git -H make build
2014-09-02 18:07:02 +05:30
```
2019-12-04 20:38:33 +05:30
### 7. Update GitLab Pages to the corresponding version (skip if not using pages)
2018-11-18 11:00:15 +05:30
2020-03-13 15:44:24 +05:30
```shell
2018-11-18 11:00:15 +05:30
cd /home/git/gitlab-pages
sudo -u git -H git fetch --all --tags
sudo -u git -H git checkout v$(</home/git/gitlab/GITLAB_PAGES_VERSION)
sudo -u git -H make
```
2020-03-13 15:44:24 +05:30
### 8. Install/Update `gitlab-elasticsearch-indexer` **(STARTER ONLY)**
2019-07-31 22:56:46 +05:30
2020-04-08 14:13:33 +05:30
Please follow the [install instruction](../integration/elasticsearch.md#installing-elasticsearch).
2019-07-31 22:56:46 +05:30
### 9. Start application
2014-09-02 18:07:02 +05:30
2020-03-13 15:44:24 +05:30
```shell
2015-12-23 02:04:40 +05:30
sudo service gitlab start
sudo service nginx restart
```
2014-09-02 18:07:02 +05:30
2019-07-31 22:56:46 +05:30
### 10. Check application status
2014-09-02 18:07:02 +05:30
Check if GitLab and its environment are configured correctly:
2020-03-13 15:44:24 +05:30
```shell
2017-08-17 22:00:37 +05:30
cd /home/git/gitlab
2015-12-23 02:04:40 +05:30
sudo -u git -H bundle exec rake gitlab:env:info RAILS_ENV=production
```
2014-09-02 18:07:02 +05:30
To make sure you didn't miss anything run a more thorough check with:
2020-03-13 15:44:24 +05:30
```shell
2015-12-23 02:04:40 +05:30
sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production
```
2014-09-02 18:07:02 +05:30
If all items are green, then congratulations upgrade complete!