GitLab kas チャートの使用

kasサブチャートは、構成可能なKubernetes向けGitLabエージェントサーバー (KAS)のデプロイを提供します。エージェントサーバーは、GitLabと共にインストールするコンポーネントです。Kubernetes向けGitLabエージェントの管理に必要です。

このチャートは、GitLab APIおよびGitalyサーバーへのアクセスに依存します。このチャートを有効にすると、Ingressがデプロイされます。

リソース消費を最小限に抑えるため、kasコンテナはディストロレスイメージを使用します。デプロイされたサービスはIngressによって公開され、通信にはWebSocketプロキシが使用されます。このプロキシにより、外部コンポーネントであるagentkとの長期接続が可能になります。agentkはKubernetesクラスタ側のエージェントの対応物です。

サービスにアクセスするためのルートは、Ingress設定によって異なります。

詳しくは、Kubernetes向けGitLabエージェントのアーキテクチャをご覧ください。

エージェントサーバーを無効にする

GitLabエージェントサーバー（kas）は、デフォルトで有効になっています。GitLabインスタンスで無効にするには、Helmプロパティglobal.kas.enabledをfalseに設定します。

例:

helm upgrade --install kas --set global.kas.enabled=false

Ingressの指定

チャートのIngressをデフォルトの設定で使用すると、エージェントサーバーのサービスはサブドメインで到達可能になります。たとえば、global.hosts.domain: example.comの場合、エージェントサーバーはkas.example.comで到達可能です。

KAS Ingressは、global.hosts.domainとは異なるドメインを使用できます。

global.hosts.kas.nameを設定します。例:

global.hosts.kas.name: kas.my-other-domain.com

この例では、KAS Ingressのホストとしてkas.my-other-domain.comのみを使用します。その他のサービス（GitLab、レジストリ、MinIOなど）は、global.hosts.domainで指定されたドメインを使用します。

コマンドラインオプションのインストール

これらのパラメータを、--setフラグを使用して、helm installコマンドに渡すことができます。

TLS通信を有効にする

グローバルKAS属性を介して、kasポッドと他のGitLabチャートコンポーネント間のTLS通信を有効にします。

kasチャートをテストする

チャートをインストールするには:

1. 独自のKubernetesクラスタを作成します。

2. マージリクエストの作業ブランチをチェックアウトします。

3. ローカルチャートブランチからデフォルトで有効になっているkasを使用してGitLabをインストール（またはアップグレード）します:

   helm upgrade --force --install gitlab . \
     --timeout 600s \
     --set global.hosts.domain=your.domain.com \
     --set global.hosts.externalIP=XYZ.XYZ.XYZ.XYZ \
     --set certmanager-issuer.email=your@email.com

4. GDKを使用して、Kubernetes向けGitLabエージェントを構成および使用するプロセスを実行します: （エージェントを手動で構成して使用する手順に従うこともできます）。

   1. GDK GitLabリポジトリから、QAフォルダーに移動します: cd qa。

   2. 次のコマンドを実行して、QAテストを実行します:

      GITLAB_USERNAME=$ROOT_USER
      GITLAB_PASSWORD=$ROOT_PASSWORD
      GITLAB_ADMIN_USERNAME=$ROOT_USER
      GITLAB_ADMIN_PASSWORD=$ROOT_PASSWORD
      bundle exec bin/qa Test::Instance::All https://your.gitlab.domain/ -- --tag orchestrated --tag quarantine qa/specs/features/ee/api/7_configure/kubernetes/kubernetes_agent_spec.rb

      また、環境変数を使用してインストールするagentkバージョンをカスタマイズすることもできます: GITLAB_AGENTK_VERSION=v13.7.1

KEDAの設定

このkedaセクションでは、通常のHorizontalPodAutoscalersの代わりに、KEDA ScaledObjectsのインストールを有効にします。この設定はオプションであり、カスタムメトリクスまたは外部メトリクスに基づいてオートスケールが必要な場合に使用できます。

ほとんどの設定は、該当するhpaセクションで設定された値にデフォルト設定されます。

次がtrueの場合、hpaセクションで設定されたCPUおよびメモリのしきい値に基づいて、CPUおよびメモリトリガーが自動的に追加されます:

• triggersが設定されていません。
• 対応するrequest.cpu.requestまたはrequest.memory.request設定も、ゼロ以外の値に設定されています。

トリガーが設定されていない場合、ScaledObjectは作成されません。

これらの設定の詳細については、KEDAドキュメントを参照してください。

サービスアカウント

このセクションでは、サービスアカウントを作成するかどうか、およびデフォルトのアクセストークンをポッドにマウントするかどうかを制御します。

affinity

詳細については、affinityを参照してください。

デバッグログを有効にする

KASサブチャートのデバッグロギングを有効にするには、values.yamlファイルのkasセクションに以下を追加します:

customConfig:
   observability:
      logging:
         level: debug
         grpc_level: debug