GitLab Helmチャート5.0

GitLab の14.0 リリースに伴い、チャートのバージョンを5.0に上げました。

主な変更点のまとめ

4.xからのアップグレードパス

5.0 バージョンの Chart にアップグレードするには、まず、Chart の最新リリース4.12.x にアップグレードする必要があります。最新のパッチについては、バージョン・マッピングの詳細を確認してください。

最新の4.12.x パッチにアップグレードしないと、次のようなエラーが表示されます。helm upgrade

Error: UPGRADE FAILED: Job failed: BackoffLimitExceeded

gitlab-upgrade-check 」というテキストが名前に含まれるエラーのポッドを探すことで、この状況にあることを確認できます。

それらのポッドのログをチェックすると、バージョンアップのエラーメッセージが表示されます：

It seems you are upgrading the GitLab Helm chart from X (GitLab X) to 5.0.0 (GitLab 14.0.0).
It is required to upgrade to the latest 4.12.x version first before proceeding.
Please follow the upgrade documentation at https://docs.gitlab.com/charts/releases/5_0.html
and upgrade to GitLab Helm chart version 4.12.x before upgrading to 5.0.0.

4.12.xからのアップグレード

5.0リリースのアップグレード手順に従ってください。

主な変更点

PostgreSQL

このChartの5.0.0 リリースの一環として、PostgreSQLのバージョンを11.9 から12.7 にアップグレードしました。 これはドロップインで置き換えるものではありません。データベースをアップグレードするには、手動で手順を実行する必要があります。

5.0のアップグレード手順には、アップグレード時に必要な手動手順が含まれています。

note
PostgreSQL 12はGitLab 14.0(2021年6月)で最低限必要なPostgreSQLバージョンです。PostgreSQL 11はGitLab 14.0以降ではサポートされなくなりました。

Unicornウェブサーバー

Chartのバージョン4.0.0 、Unicornのウェブサーバとしての使用は非推奨となり、デフォルトでは使用されなくなりました。代わりにPumaがデフォルトのウェブサーバとして使用されています。5.0.0 ではUnicornのサポートは削除されました。

最新バージョンにアップグレードする前に、あなたの値から Unicorn の設定を削除する必要があります。

Pumaの設定オプションについては、ウェブサービスの詳細を参照してください。

Helm 2

Helm 2 は非推奨となり、2020年11月のリリースを最後にアップストリームでのサポートは終了しました。GitLab Helm chartの4.12 リリースが、Tiller Helm 2.xをサポートする最後のリリースとなります。

Helm 2から3へのマイグレーションドキュメントをご覧ください。

Cert-Manager

このチャートの5.0.0 リリースの一環として、Cert-Manager チャートを0.10.1 から1.2.0 にアップグレードしました。新しいバージョンはIssuer 用のcert-manager.io/v1 API バージョンを使用するため、別の Cert-Manager インスタンスを使用していてこのチャートで提供される Issuer を使用している場合は、Cert-Manager をcert-manager.io/v1 バージョンをサポートするバージョンにアップグレードする必要があります。

このChartが提供するCert-ManagerとIssuer を使用している場合、アップグレードは自動的に行われます。アップグレード中、Cert-Manager のDeployment オブジェクト（以前は名前にcertmanager が付いていました）は削除され、名前にcert-manager が付いた新しいオブジェクトが作成されます。

アップグレード中に Cert-Manager でイシューが発生した場合は、Cert-Manager アップグレードのトラブルシューティングセクションを確認してください。

4.x 以前のバージョンからのアップグレードパス

4.0 にアップグレードする前に、まず4.12.x リリースの Chart にアップグレードする必要があります。4.0 アップグレードのドキュメントに従ってください。

既知のイシューと制限事項

以下は既知のイシューと制限事項のリストです。

現在対象外の機能

リリース・ケイデンス

新しいGitLabパッチがリリースされるたびに、新しいバージョンのChartをリリースする予定です。

Chartのバージョン管理方法の詳細はリリースドキュメントをご覧ください。

このリポジトリにあるイシューやマージリクエストとともに、より簡単に更新を追うことができる変更履歴もあります。

Kubernetes デプロイのサポート

GitLabは以下の環境でテストされています：

その他のKubernetesデプロイも動作するはずです。GKE以外のデプロイで問題が発生した場合は、イシューを上げてください。

このリリースでは、Kubernetes バージョンv1.17.17-gke.4900 およびv1.15.12-eks-31566f の CI テストが自動化されています。

技術サポート

イシューを作成する前に、既知の問題と制限をレビューし、同様の問題がすでに存在しないか検索してください。

私たちはコミュニティの幅広いテストに大いに感謝し、詳細なイシューを報告することを奨励します。

私たちはマージリクエストという形で貢献する改良を歓迎します。コントリビューターのドキュメントをご覧ください。