• エージェントサーバーの無効化
  • イングレスの指定
  • インストールのコマンドラインオプション
• TLS通信の有効化
• gitlab.kas.privateApi 属性を通してTLS通信を有効にします（非推奨）。
• kas チャートのテスト
• KEDAの設定

GitLabkas チャートの使い方

kas サブチャートは、GitLabエージェントサーバ(KAS) の設定可能なデプロイを提供します。エージェントサーバーはGitLabと一緒にインストールするコンポーネントです。kasKubernetes用のGitLabエージェントをkas管理するために必要です。

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

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

サービスへのアクセス経路はIngressの設定に依存します。

詳細については、GitLab agent for Kubernetesアーキテクチャを参照してください。

エージェントサーバーの無効化

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

使用例：

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

イングレスの指定

Chartの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通信の有効化

• gitlab.kas.privateApi.tls.enabled とgitlab.kas.privateApi.tls.secretName 属性はGitLab 15.8で非推奨となり、GitLab 17.0で削除される予定です。代わりにグローバルKAS属性でTLSを有効にしてください。

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

gitlab.kas.privateApi 属性を通してTLS通信を有効にします（非推奨）。

前提条件：

• GitLab 15.5.1以降を使用してください。GitLabのバージョンはglobal.gitlabVersion: <version> で設定できます。 最初のデプロイ後に強制的にイメージを更新する必要がある場合は、global.image.pullPolicy: Always も設定してください。

1. kas ポッドが信頼する認証局と証明書を作成します。
2. 信頼された証明書を使用するようにChartを設定します。
3. オプション。TLS用にRedisを設定します。

作成した証明書を使用するようにkas を設定するには、以下の値を設定します。

例えば、このvalues.yaml ファイルを使って Chart をデプロイすることができます：

.internal-ca: &internal-ca gitlab-internal-tls-ca # The secret name you used to share your TLS CA.
.internal-tls: &internal-tls gitlab-internal-tls # The secret name you used to share your TLS certificate.

global:
  certificates:
    customCAs:
    - secret: *internal-ca
  hosts:
    domain: gitlab.example.com # Your gitlab domain
  appConfig:
    gitlab_kas:
      internalUrl: "grpcs://RELEASE-kas.NAMESPACE.svc:8153" # Replace RELEASE and NAMESPACE with your chart's release and namespace

gitlab:
  kas:
    privateApi:
      tls:
        enabled: true
        secretName: *internal-tls
    customConfig:
      api:
        listen:
          certificate_file: /etc/kas/tls.crt
          key_file: /etc/kas/tls.key
      agent:
        listen:
          certificate_file: /etc/kas/tls.crt
          key_file: /etc/kas/tls.key
        kubernetes_api:
          listen:
            certificate_file: /etc/kas/tls.crt
            key_file: /etc/kas/tls.key
    ingress:
      annotations:
        nginx.ingress.kubernetes.io/backend-protocol: https
        nginx.ingress.kubernetes.io/proxy-ssl-name: RELEASE-kas.NAMESPACE.svc # Replace RELEASE and NAMESPACE with your chart's release and namespace
        nginx.ingress.kubernetes.io/proxy-ssl-secret: NAMESPACE/CA-SECRET-NAME # Replace NAMESPACE and CA-SECRET-NAME with your chart's namespace and CA secret name. The same you used for &internal-ca.
        nginx.ingress.kubernetes.io/proxy-ssl-verify: on

kas チャートのテスト

Chartをインストールします：

1. Kubernetesクラスターを作成します。
2. マージリクエストのワーキングブランチをチェックしてください。

3. ローカルの Chart ブランチから、デフォルトで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 セクションで設定された値にデフォルト設定されます。

以下が真である場合、hpa セクションで設定された CPU とメモリのしきい値に基づいて、CPU とメモリのトリガーが自動的に追加されます：

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

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

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