GitLab Helmチャートインスタンスのアップグレード

GitLab Helmチャートインスタンスを、以降のバージョンのGitLabにアップグレードします。

前提要件

GitLab Helmチャートインスタンスをアップグレードする前に:

1. アップグレード前に必要な情報を確認してください。
2. GitLab Helmチャートのバージョンは、GitLabのバージョンと同じ番号付けに従っていないため、必要なGitLab Helmチャートのバージョンを見つけるには、マッピングを参照してください。
3. アップグレード先の特定リリースに対応する変更履歴を参照してください。
4. 8.x以前のバージョンのGitLab Helmチャートからアップグレードする場合は、GitLabドキュメントアーカイブを参照して、ドキュメントの古いバージョンにアクセスしてください。
5. バックアップを実行します。

GitLab Helmチャートインスタンスのアップグレード

GitLab Helmチャートインスタンスをアップグレードするには:

1. ワークフローを中断しないように、アップグレード中にメンテナンスモードをオンにすることを検討し、ユーザーによる書き込み操作を制限します。

2. ターゲットのGitLabバージョンと同じバージョンにGitLab Runnerをアップグレードしてください。

3. デプロイドキュメントにステップごとに従ってください。

4. 以前に提供された値を抽出します:

   helm get values gitlab > gitlab.yaml

5. アップグレード時に引き継ぐ必要のあるすべての値を決定します。明示的に設定する最小限の値のセットのみを保持し、アップグレードプロセス中にそれらを渡す必要があります。そうでない場合は、GitLabのデフォルト値に依存する必要があります。

6. 以前のステップで抽出およびレビューした値を使用して、アップグレードを実行します:

   helm upgrade gitlab gitlab/gitlab \
     --version <new version> \
     -f gitlab.yaml \
     --set gitlab.migrations.enabled=true \
     --set ...

   主要なデータベースのアップグレード中は、gitlab.migrations.enabledをfalseに設定する必要があります。将来のアップデートのために、明示的にtrueに戻してください。

アップグレード後:

1. 有効になっている場合は、メンテナンスモードをオフにします。
2. アップグレードヘルスチェックを実行します。

バンドルされているPostgreSQLのアップグレード

postgresql.installがtrueの場合、これらの手順はバンドルされているPostgreSQLチャートを使用している場合にのみ実行してください。

バンドルされているPostgreSQLをアップグレードするには:

1. アップグレード先のPostgreSQLのバージョンを決定します。
2. 既存のデータベースを準備します。
3. 既存のPostgreSQLデータを削除します。
4. postgresql.image.tagの値を必要なバージョンのPostgreSQLに更新し、チャートを再インストールして、新しいPostgreSQLデータベースを作成します。
5. データベースを復元する。