正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

外部IngressコントローラーでGitLabチャートを構成する

このチャートは、バンドルされたNGINX IngressでIngressリソースを構成します。このチャートは、IngressからGateway APIへの移行を試みていますが、外部IngressコントローラーでIngressを引き続き使用できます。

外部Ingressコントローラーを準備する

NGINX

NGINX Ingressは非推奨となり、2026年3月以降はセキュリティパッチを受け取ることはありません。

詳細については、公式発表をお読みください。

GitLabで使用する外部NGINX Ingressデプロイを構成および準備するには、外部NGINX Ingressドキュメントを確認してください。

Traefik

GitLab Shell（GitLabのSSHデーモン）のポート22を公開するようにTraefikを構成する必要があります:

ports:
  gitlab-shell:
    expose: true
    port: 2222
    exposedPort: 22

GitLab Ingressオプションをカスタマイズする

NGINX Ingressコントローラーは、どのIngressコントローラーが特定のIngressIngressを処理するかを示す注釈を使用します（ドキュメントを参照）。global.ingress.class設定を使用して、このチャートで使用するIngressクラスを構成できます。必ずHelmオプションでこれを設定してください。

--set global.ingress.class=myingressclass

必ずしも必須ではありませんが、外部Ingressコントローラーを使用している場合は、このチャートでデフォルトでデプロイされるIngressコントローラーを無効にすることをお勧めします:

--set nginx-ingress.enabled=false

カスタム証明書管理

外部Ingressコントローラーを使用している場合は、外部cert-managerインスタンスを使用するか、他のカスタム方法で証明書を管理することもできます。TLSオプションの詳細については、GitLabチャートのTLSの構成を参照してください。ただし、このディスカッションの目的のために、cert-managerチャートを無効にし、GitLabコンポーネントチャートに組み込みの証明書リソースを検索しないように指示するために設定する必要がある2つの値を次に示します:

--set installCertmanager=false
--set global.ingress.configureCertmanager=false