Download as
Browse Code »

Commit f299301cfe73496ae47575840033edf97d110b95

Authored by Dmitriy Zaporozhets
1 parent 840e98ba
Exists in spb-stable and in 2 other branches 7-0-stable, 7-0-stable-spb

Update guide from 6.9 to 7.0 

Signed-off-by: Dmitriy Zaporozhets <dmitriy.zaporozhets@gmail.com>
Showing 1 changed file with 102 additions and 0 deletions   Show diff stats
doc/update/6.9-to-7.0.md 0 → 100644
  Diff comments   View file @f299301
... ... @@ -0,0 +1,102 @@
  1 +# From 6.9 to 7.0
  2 +
  3 +### 0. Backup
  4 +
  5 +```bash
  6 +cd /home/git/gitlab
  7 +sudo -u git -H bundle exec rake gitlab:backup:create RAILS_ENV=production
  8 +```
  9 +
  10 +### 1. Stop server
  11 +
  12 +```bash
  13 +sudo service gitlab stop
  14 +```
  15 +
  16 +### 2. Get latest code
  17 +
  18 +```bash
  19 +cd /home/git/gitlab
  20 +sudo -u git -H git fetch --all
  21 +```
  22 +
  23 +For Gitlab Community Edition:
  24 +
  25 +```bash
  26 +sudo -u git -H git checkout 7-0-stable
  27 +```
  28 +
  29 +OR
  30 +
  31 +For GitLab Enterprise Edition:
  32 +
  33 +```bash
  34 +sudo -u git -H git checkout 7-0-stable-ee
  35 +```
  36 +
  37 +### 3. Update gitlab-shell (and its config)
  38 +
  39 +```bash
  40 +cd /home/git/gitlab-shell
  41 +sudo -u git -H git fetch
  42 +sudo -u git -H git checkout v1.9.6
  43 +```
  44 +
  45 +### 4. Install libs, migrations, etc.
  46 +
  47 +```bash
  48 +cd /home/git/gitlab
  49 +
  50 +# MySQL installations (note: the line below states '--without ... postgres')
  51 +sudo -u git -H bundle install --without development test postgres --deployment
  52 +
  53 +# PostgreSQL installations (note: the line below states '--without ... mysql')
  54 +sudo -u git -H bundle install --without development test mysql --deployment
  55 +
  56 +# Run database migrations
  57 +sudo -u git -H bundle exec rake db:migrate RAILS_ENV=production
  58 +
  59 +# Clean up assets and cache
  60 +sudo -u git -H bundle exec rake assets:clean assets:precompile cache:clear RAILS_ENV=production
  61 +```
  62 +
  63 +### 5. Update config files
  64 +
  65 +#### New configuration options for gitlab.yml
  66 +
  67 +There are new configuration options available for gitlab.yml. View them with the command below and apply them to your current gitlab.yml if desired.
  68 +
  69 +```
  70 +git diff 6-9-stable:config/gitlab.yml.example 7-0-stable:config/gitlab.yml.example
  71 +```
  72 +
  73 +### 6. Start application
  74 +
  75 + sudo service gitlab start
  76 + sudo service nginx restart
  77 +
  78 +### 7. Check application status
  79 +
  80 +Check if GitLab and its environment are configured correctly:
  81 +
  82 + sudo -u git -H bundle exec rake gitlab:env:info RAILS_ENV=production
  83 +
  84 +To make sure you didn't miss anything run a more thorough check with:
  85 +
  86 + sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production
  87 +
  88 +If all items are green, then congratulations upgrade is complete!
  89 +
  90 +## Things went south? Revert to previous version (6.9)
  91 +
  92 +### 1. Revert the code to the previous version
  93 +Follow the [`upgrade guide from 6.8 to 6.9`](6.8-to-6.9.md), except for the database migration
  94 +(The backup is already migrated to the previous version)
  95 +
  96 +### 2. Restore from the backup:
  97 +
  98 +```bash
  99 +cd /home/git/gitlab
  100 +sudo -u git -H bundle exec rake gitlab:backup:restore RAILS_ENV=production
  101 +```
  102 +If you have more than one backup *.tar file(s) please add `BACKUP=timestamp_of_backup` to the command above.
... ...