集群管理

本文介绍如何在 Zadig 系统上进行多集群管理。Zadig 基于本地集群安装，同时支持外部多个 K8s 集群资源的接入和使用。其中，测试集群一般用于自测、开发、测试用途，生产集群一般用于预发布和生产发布用途。

添加集群

注意

需要保证添加的集群可以访问到 Zadig 所在的集群

访问 系统设置 -> 集群管理，点击 新建 添加集群。

参数说明：

连接方式：支持代理连接和直接连接两种方式，具体操作请参考代理连接方式、直接连接方式。
名称：集群名称只支持小写字母、数字和中划线。
集群提供商：该集群的提供商信息。
描述：该集群的用途描述信息。
生产集群：
- 如果指定生产集群为「否」，有环境创建权限的用户，可以指定使用哪个集群资源。
- 如果指定生产集群为「是」，超级管理员可以通过权限控制集群资源的使用，以实现业务与资源的严格隔离和安全生产管控。
KubeConfig：待接入集群的 KubeConfig 配置文件内容，使用直接连接方式时需填写。

创建集群时可设置高级配置，也可以在创建完成后再修改。高级配置说明：

在外接集群中安装 Agent，适用场景：外接集群可以访问 Zadig 所在的集群。

选择代理连接方式填写集群基本信息后，在待接入集群中执行 Agent 安装脚本，如图所示：

脚本执行完毕后，刷新集群列表查看集群状态，状态正常即为接入成功。

需要外接集群的 admin 权限，在 Zadig 系统中配置其 KubeConfig，适用场景：Zadig 所在的集群可以访问外接集群。

选择直接连接方式填写集群基本信息及外接集群的 KubeConfig 内容后保存即可。

断开：断开集群操作并不会删除已经在集群中创建的环境资源，如需清理，请手动删除。集群断开后，可通过再次执行 Agent 安装脚本接入。
编辑：可修改集群的基本信息及高级配置。
删除：删除集群操作并不会删除已经在集群中创建的环境资源，如需清理，请手动删除。
更新 Agent：更新 Zadig 系统在该集群中安装的 Agent，即：koderover-agent 命名空间下的 dind、koderover-agent-node-agent 和 resource-server 资源。

点击编辑，可设置该集群资源的调度策略。以执行工作流任务为例对不同的策略说明如下：

可按需对不同集群资源配置缓存策略。

将会使用系统默认对象存储来缓存资源，可在对象存储管理中设置默认对象存储。

可使用集群中已有的存储资源或按需动态创建资源。

选择存储资源

动态生成资源：选择文件存储类型的 StorageClass 并指定动态生成的存储空间大小，注意：若使用腾讯云 cbs 作为 StorageClass，则有效的存储空间大小范围 (GiB)：[10, 32000]。
使用现有存储资源：选择已有存储资源，注意：创建该存储资源的 PVC 中，accessModes 需要是 ReadWriteMany。

缓存目录规则

可设置缓存资源在集群存储中的存储目录相对路径规则，实现共享缓存，或者根据不同的项目/工作流/服务组件独享缓存。支持以下变量：

$PROJECT：项目名称
$WORKFLOW：工作流名称
$SERVICE_MODULE：服务组件名称 (测试工作流中无此参数，对于测试工作流的缓存，该变量将被忽略)

举例说明如下：

缓存目录规则	说明
`$PROJECT/$WORKFLOW/$SERVICE_MODULE`	为同一项目同一工作流中的服务组件单独设置独享缓存，不同服务组件之间互不干扰
`$PROJECT/$WORKFLOW`	同一项目下的同一工作流共享缓存；不同工作流之间独享缓存互不干扰
`$PROJECT/$SERVICE_MODULE`	同一项目下的相同服务组件共享缓存
`$PROJECT`	同一项目共享缓存；不同项目的缓存资源将存储在集群 PVC 的不同目录中，彼此独享缓存互不干扰
`cache`	缓存资源将存储在集群 `/<PVC 根目录>/cache` 目录下，所有项目共享使用缓存
无	缓存资源将存储在集群 `/<PVC 根目录>` 下，所有项目共享使用缓存

配置集群的 Dind 资源。

副本数量：默认为 1，可按需调整。设置多副本后，同一个服务的构建任务会被尽可能调度到同一个 Dind 实例，不同服务的构建任务会被尽可能打散调度到不同的 Dind 实例，避免因单个 Dind 实例承载过多的构建任务而增加失败概率。
资源限制：CPU 默认为 4000m，Memory 默认为 8192Mi。
存储资源：可用于存储镜像缓存等。当指定集群存储资源时，选择文件存储类型的 StorageClass 并指定动态生成的存储空间大小。