使用极狐GitLab `kas` chart

kas 子软件包提供了一个可配置的 极狐GitLab 代理服务器 (KAS) 部署。代理服务器是与极狐GitLab 一起安装的组件，管理 极狐GitLab Kubernetes 代理 时必需。

此图表依赖于访问极狐GitLab API 和 Gitaly 服务器。启用此图表时，将部署一个 Ingress。

为了消耗最少的资源，kas 容器使用无操作系统镜像。部署的服务通过 Ingress 暴露，使用 WebSocket 代理进行通信。此代理允许与外部组件 agentk 进行长时间连接。agentk 是 Kubernetes 集群侧代理的对应部分。

访问服务的路径取决于您的 Ingress 配置。

有关更多信息，请参见 极狐GitLab Kubernetes 代理架构。

禁用代理服务器#

极狐GitLab 代理服务器 (kas) 默认启用。要在您的极狐GitLab 实例上禁用它，请将 Helm 属性 global.kas.enabled 设置为 false。

例如：

shell
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，例如：

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

此示例仅使用 kas.my-other-domain.com 作为 KAS Ingress 的主机。其余服务（包括极狐GitLab、Registry、MinIO 等）使用 global.hosts.domain 中指定的域。

安装命令行选项#

您可以使用 --set 标志将这些参数传递给 helm install 命令。

启用 TLS 通信#

通过 全局 KAS 属性 启用 kas pod 与其他极狐GitLab 图表组件之间的 TLS 通信。

测试 kas 图表#

要安装图表：

1. 创建您自己的 Kubernetes 集群。

2. 检出合并请求的工作分支。

3. 从本地图表分支安装（或升级）极狐GitLab，默认启用 kas：

   shell
   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 运行配置和使用 极狐GitLab Kubernetes 代理 的过程： （您也可以按照步骤手动配置和使用代理。）

   1. 从您的 GDK 极狐GitLab 仓库，进入 QA 文件夹：cd qa。

   2. 运行以下命令以运行 QA 测试：

      shell
      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 部分启用 KEDA ScaledObjects 的安装，而不是常规的 HorizontalPodAutoscalers。此配置是可选的，可以在需要根据自定义或外部指标进行自动缩放时使用。

大多数设置默认使用在 hpa 部分设置的值（如果适用）。

如果以下条件为真，则会根据在 hpa 部分设置的 CPU 和内存阈值自动添加 CPU 和内存触发器：

• triggers 未设置。
• 相应的 request.cpu.request 或 request.memory.request 设置也设置为非零值。

如果未设置触发器，则不会创建 ScaledObject。

serviceAccount#

此部分控制是否应创建 ServiceAccount 以及是否应在 pod 中挂载默认访问令牌。

亲和性#

有关更多信息，请参阅 affinity。

启用调试日志#

要为 KAS 子软件包启用调试日志，请在您的 values.yaml 文件的 kas 部分中添加以下内容：

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