GitLab システム管理者 - ハンズオンラボ: GitLab Omnibus のアップグレード
推定所要時間: 30 分
目的
このラボの目的は、GitLab インスタンスのアップグレード方法を示すことです。
タスク A. 現在の GitLab バージョンの確認
GitLab インスタンスに移動し、root ユーザーとしてサインインします。
左サイドバーで Help > Help を選択します。
ページの上部に、完全な GitLab バージョンが表示されます。このラボでは、
17.4.1-eeが表示されます。
タスク B. 利用可能な GitLab バージョンの確認
GitLab Omnibus のアップデートは、パッケージマネージャーを通じて、GitLab バージョンに対応する Omnibus パッケージをインストールすることで完了します。パッケージで利用可能な GitLab のバージョンを確認するには、インスタンスに SSH 接続し、パッケージマネージャーのパッケージバージョンを確認します。
GitLab インスタンスに SSH 接続します。
sudo apt-cache madison gitlab-eeコマンドを実行します。このラボでは、バージョン
17.5.0-ee.0を見つけます。このバージョンをメモしておきます。このバージョンの GitLab にアップグレードします。
タスク C. アップグレードの実行
ターゲットの GitLab バージョンが特定できたので、GitLab のアップグレードを実行できます。
まだ行っていない場合は、GitLab インスタンスに SSH 接続します。
sudo gitlab-backup createを使用してインスタンスのバックアップを取得します。https://gitlab-com.gitlab.io/support/toolbox/upgrade-path/に移動します。現在の GitLab バージョン（
17.4.1）とターゲットバージョン（17.5.0）を入力します。Edition が Enterprise に設定され、Distro が Ubuntu に設定されていることを確認します。
Go!を選択します。
アップグレードパスでは、17.5.0 をインストールするという 1 つのステップのみが必要であることがわかります。このプロセスを完了しましょう。
GitLab インスタンスで、
sudo apt-get install gitlab-ee=17.5.0-ee.0コマンドを実行します。インストールが完了するまで待ちます。完了したら、Web ブラウザーでインスタンスに移動します。
HTTP 502: Waiting for GitLab to boot というメッセージが表示されます。起動が完了して GitLab インスタンスに戻るまで、この画面で待機します。
タスク D. アップグレードの検証
この時点で、インスタンスのログインページにリダイレクトされています。アップグレードを検証するには、以下の手順を完了します。
root ユーザーとして GitLab インスタンスに認証します。
左サイドバーで Admin を選択します。
左サイドバーで Monitoring > Background migrations を選択します。
Queued セクションのマイグレーションについてテーブルを確認します。これらのマイグレーションは、追加のアップグレードを完了する前に完了する必要があります。完了すると、Finished タブに表示されます。
例として、このアップグレード後に
BackfillIssuesCorrectWorkItemTypeId: issuesマイグレーションが表示される場合があります。このマイグレーションを Queued または Finished タブで見つけてみてください。バージョンを検証するには、左サイドバーで Help を選択します。表示されるメニューに、バージョン
17.5が表示されているはずです。
ラボガイド完了
このラボ演習を完了しました。このコースの他のラボガイドを参照できます。
ご提案はありますか?
ラボに変更を加えたい場合は、マージリクエストを通じて変更内容を送信してください。
