セルフコンパイルインストール用パッチバージョンのユニバーサルアップデートガイド

インストールするバージョンの選択

インストールしたいGitLabのタグ(バージョン)からこのアップデートガイドを見てください。ほとんどの場合、これは一番番号の高いプロダクションタグ(rc が入っていない)であるべきです。GitLabの左上(メニューバーの下)にあるバージョンのドロップダウンリストでタグを選択できます。

0.バックアップ

万が一に備えてバックアップを取っておきましょう。インストール方法によって、バックアップのコマンドは異なります。GitLabのバックアップとリストアのドキュメントを参照してください。

1.サーバーの停止

# For systems running systemd
sudo systemctl stop gitlab.target

# For systems running SysV init
sudo service gitlab stop

2.安定版ブランチの最新コードを取得

以下のコマンドでは、LATEST_TAG を更新したい最新の GitLab タグに置き換えてください。たとえばv8.0.3 。すべてのタグの一覧を見るにはgit tag -l 'v*.[0-9]' --sort='v:refname' を使います。パッチバージョンのみを更新するようにしてください (cat VERSIONで現在のバージョンを確認してください)。

cd /home/git/gitlab

sudo -u git -H git fetch --all
sudo -u git -H git checkout -- Gemfile.lock db/structure.sql locale
sudo -u git -H git checkout LATEST_TAG -b LATEST_TAG

3.ライブラリやマイグレーションなどのインストール

cd /home/git/gitlab

# If you haven't done so during installation or a previous upgrade already
sudo -u git -H bundle config set --local deployment 'true'
sudo -u git -H bundle config set --local without 'development test mysql aws kerberos'

# Update gems
sudo -u git -H bundle install

# Optional: clean up old gems
sudo -u git -H bundle clean

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

# Clean up assets and cache
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"

4.GitLab Workhorseを対応するバージョンにアップデートします。

cd /home/git/gitlab

sudo -u git -H bundle exec rake "gitlab:workhorse:install[/home/git/gitlab-workhorse]" RAILS_ENV=production

5.Gitalyを対応するバージョンにアップデートしてください。

cd /home/git/gitlab

sudo -u git -H bundle exec rake "gitlab:gitaly:install[/home/git/gitaly,/home/git/repositories]" RAILS_ENV=production

6.GitLab Shellを対応するバージョンにアップデートしてください。

cd /home/git/gitlab-shell

sudo -u git -H git fetch --all --tags
sudo -u git -H git checkout v$(</home/git/gitlab/GITLAB_SHELL_VERSION) -b v$(</home/git/gitlab/GITLAB_SHELL_VERSION)
sudo -u git -H make build

7.GitLab Pagesを対応するバージョンにアップデート(Pagesを使用していない場合はスキップしてください)

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

8.gitlab-elasticsearch-indexer をインストール/更新してください。

インストールの指示に従ってください。

9.アプリケーションの起動

# For systems running systemd
sudo systemctl start gitlab.target
sudo systemctl restart nginx.service

# For systems running SysV init
sudo service gitlab start
sudo service nginx restart

10.申込状況の確認

GitLabとその環境が正しく設定されているかを確認します:

cd /home/git/gitlab

sudo -u git -H bundle exec rake gitlab:env:info RAILS_ENV=production

見落としがないか、さらに詳しくチェックしましょう:

sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production

すべての項目が緑色になっていれば、アップグレード完了です!

11.バックグラウンドマイグレーションが終了していることを確認してください。

バックグラウンドマイグレーションのステータスを確認し、終了していることを確認します。