BigW Consortium Gitlab

patch_versions.md 2.54 KB
Newer Older
1
# Universal update guide for patch versions
2
*Make sure you view this [upgrade guide](https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/update/patch_versions.md) from the `master` branch for the most up to date instructions.*
3

4
For example from 7.14.0 to 7.14.3, also see the [semantic versioning specification](http://semver.org/).
5 6 7 8

### 0. Backup

It's useful to make a backup just in case things go south:
9 10
(With MySQL, this may require granting "LOCK TABLES" privileges to the GitLab
user on the database version)
11 12 13 14 15 16 17 18

```bash
cd /home/git/gitlab
sudo -u git -H bundle exec rake gitlab:backup:create RAILS_ENV=production
```

### 1. Stop server

19 20 21
```bash
sudo service gitlab stop
```
22

dosire committed
23
### 2. Get latest code for the stable branch
24

25 26 27 28 29
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`).

30 31
```bash
cd /home/git/gitlab
32
sudo -u git -H git fetch --all
33
sudo -u git -H git checkout -- Gemfile.lock db/schema.rb
34
sudo -u git -H git checkout LATEST_TAG -b LATEST_TAG
35 36
```

37
### 3. Update gitlab-shell to the corresponding version
38 39 40 41

```bash
cd /home/git/gitlab-shell
sudo -u git -H git fetch
42
sudo -u git -H git checkout v`cat /home/git/gitlab/GITLAB_SHELL_VERSION` -b v`cat /home/git/gitlab/GITLAB_SHELL_VERSION`
43 44
```

45 46 47 48 49
### 4. Update gitlab-workhorse to the corresponding version

```bash
cd /home/git/gitlab-workhorse
sudo -u git -H git fetch
50
sudo -u git -H git checkout `cat /home/git/gitlab/GITLAB_WORKHORSE_VERSION` -b `cat /home/git/gitlab/GITLAB_WORKHORSE_VERSION`
51
sudo -u git -H make
52 53 54
```

### 5. Install libs, migrations, etc.
55 56 57 58

```bash
cd /home/git/gitlab

59
# PostgreSQL
60 61
sudo -u git -H bundle install --without development test mysql --deployment

62 63 64
# MySQL
sudo -u git -H bundle install --without development test postgres --deployment

65
sudo -u git -H bundle exec rake db:migrate RAILS_ENV=production
66
sudo -u git -H bundle exec rake assets:clean assets:precompile cache:clear RAILS_ENV=production
67 68
```

69
### 6. Start application
70

71 72 73 74
```bash
sudo service gitlab start
sudo service nginx restart
```
75

76
### 7. Check application status
77 78 79

Check if GitLab and its environment are configured correctly:

80 81 82
```bash
sudo -u git -H bundle exec rake gitlab:env:info RAILS_ENV=production
```
83 84 85

To make sure you didn't miss anything run a more thorough check with:

86 87 88
```bash
sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production
```
89 90

If all items are green, then congratulations upgrade complete!