BigW Consortium Gitlab

patch_versions.md 2.65 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 v`cat /home/git/gitlab/GITLAB_WORKHORSE_VERSION` -b v`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
sudo -u git -H bundle install --without development test mysql --deployment
61

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

65
# Optional: clean up old gems
66
sudo -u git -H bundle clean
67 68

# Run database migrations
69
sudo -u git -H bundle exec rake db:migrate RAILS_ENV=production
70 71

# Clean up assets and cache
72
sudo -u git -H bundle exec rake assets:clean assets:precompile cache:clear RAILS_ENV=production
73 74
```

75
### 6. Start application
76

77 78 79 80
```bash
sudo service gitlab start
sudo service nginx restart
```
81

82
### 7. Check application status
83 84 85

Check if GitLab and its environment are configured correctly:

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

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

92 93 94
```bash
sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production
```
95 96

If all items are green, then congratulations upgrade complete!