GitLab Helmチャート9.0アップグレードノート

GitLab 18.0のリリースに伴い、GitLab Helmチャートのバージョン9.0をリリースしました。

主な変更点の概要

データベース診断関連のタスクに使用する新しい拡張機能amcheckを追加しています。

そのため、既存のGitLabインスタンスをアップグレードする場合は、この拡張機能をPostgreSQLデータベース上に手動で作成する必要があります。amcheck拡張機能を手動でインストールするには、ドキュメントに従ってください。

cert-managerサブチャートが1.12.xから最新リリースにアップグレードされます。これらの新しいcert-managerリリースでは、Helmスキーマの検証を実装しており、チャートの値の構造を検証します。

現在certmanager.install値を設定している場合は、installCertmanagerに移行してください。バージョン9.0以降でこの新しいパラメータを使用できますが、旧パラメータを使用し続けると、バージョン9.3へのアップグレード時にアップグレードチェックが失敗します。

バンドルされているcert-managerを使用する場合は、以下のcert-managerリリースノートを参照し、その他の重要な変更がないか確認してください:

GitLab 18.0のリリースに伴い、PostgreSQL 14および15のサポートは非推奨になりました。バンドルされているPostgreSQLサブチャートはPostgreSQL 16にアップグレードされ、デフォルトで使用するようになりました。必ずデータベースをアップグレードしてください。

バンドルされているPostgreSQLデータベースをアップグレードする手順については、アップグレード手順を参照してください。

GitLabチャートにバンドルされているPrometheusサブチャートを使用していない場合は、このセクションをスキップできます。

バンドルされているPrometheusサブチャートが15.3から27.11に更新され、Prometheus 2.xではなくPrometheus 3がバンドルされるようになりました。使用している機能に影響がある場合は、Prometheus 3移行ガイドを確認してください。

ここでは特に重要と思われる情報を抜粋していますが、変更の完全な一覧については、アップストリームのPrometheusチャートのアップグレードドキュメントを参照してください。

Prometheusチャートは、HelmおよびKubernetesのラベル付けのベストプラクティスに合わせて、いくつかの（セレクター）ラベルを更新します。アップグレードの前に、古いワークロードを削除する必要があります。
```
kubectl delete deployment  -l app=prometheus,heritage=Helm,release=<release name>
kubectl delete statefulset -l app=prometheus,heritage=Helm,release=<release name>
kubectl delete daemonset   -l app=prometheus,heritage=Helm,release=<release name>
```
Prometheusリソースのラベルに依存する他のサービスがある場合は、必要に応じてそれらも更新してください。
バンドルされているkube-state-metrics、alertmananger、ノードexporter、またはpushgatewayを有効にしている場合は、アップストリームのアップグレードの変更履歴に従って値を更新する必要があります:
- 16.0の変更。
- 17.0の変更。
- 18.0の変更。
- 19.0の変更。
configmapReload.prometheus.extraArgsは、20.0へのアップグレードに伴い互換性がなくなりました。

GitLab NGINXチャートを使用しており、独自のNGINX RBACルールを設定している場合は、新しいNGINXコントローラーイメージバージョンで必要となる新しいルールを含めるように更新する必要があります。

詳細については、8.6アップグレードノートを参照してください。