GitLab Helmチャート4.0

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

主な変更点のまとめ

問題のあるHelm 2.15

Helm v2.15.xには深刻なバグがあります。

Helm 2を使用する場合は、2.14.3 または>= 2.16.1 を使用してください。

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

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

最新の3.3.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 4.0.0 (GitLab 13.0.0).
It is required to upgrade to the latest 3.3.x version first before proceeding.
Please follow the upgrade documentation at https://docs.gitlab.com/charts/releases/3_0.html
and upgrade to GitLab Helm chart version 3.3.x before upgrading to 4.0.0.

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

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

主な変更点

PostgreSQL

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

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

note
PostgreSQL 11はGitLab 13.0（2020年5月）で最低限必要なPostgreSQLのバージョンです。PostgreSQL 9.6とPostgreSQL 10はGitLab 13.0以降ではサポートされなくなりました。

Webserviceチャート

Unicornサブチャートの名前がWebserviceに変更されました。アップグレードすると、HelmはUnicornのすべてのKubernetesリソースを削除し、Webserviceの名前で新しいリソースを作成します。このチャートは、Unicorn と Puma の両方がこのチャートでサポートされている Web サーバーであるという事実を反映するために名前が変更されました。詳細は、この変更を紹介するマージリクエストに記載されています。

note
新しいポッドの準備が整うまで、アップグレード中は GitLab にアクセスできなくなります。

Puma ウェブサーバ

Webservice chart で使用されるデフォルトの Web サーバが Puma に設定されました。これにより、いくつかのパフォーマンスが改善され、依存プロキシなどの機能がブロックされなくなりました。

Unicorn ウェブサーバは今のところサポートされたままで、以下の方法で設定できます：

gitlab:
  webservice:
    webServer: unicorn

詳しくはwebServer options をご覧ください。

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

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

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

まず2.6.x リリースの Chart にアップグレードし、次に3.3.x にアップグレードしてから3.0 にアップグレードする必要があります。2.0のアップグレードドキュメントに従ってください。

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

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

Helm チャートの問題/制限：

現在対象外の機能

リリース・ケイデンス

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

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

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

Kubernetes デプロイのサポート

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

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

このリリースでは、Kubernetes バージョンv1.14.10-gke.17 およびv1.13.12-eks-879c36 の CI テストが自動化されています。

技術サポート

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

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

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