集群管理

1. 概述

集群是用于运行k8s的托管群组，一个Choerodon集群对应为一个k8s集群。有了集群，我们就能以此来统一调配资源，管理环境。此外，每个集群可以对组织下各个项目设置是否公开，配置后，只有被分配权限的项目中的环境才能连接到该集群。

注意：自0.19.0版本后，我们将`集群管理`模块从组织层迁到了项目层；同时，为了统一存放以往版本在组织中创建的集群，我们在本组织下新建了一个名为“默认运维项目”的项目，且只有组织管理员才有该项目的项目所有者权限。

只有项目所有者对集群页面有查看和编辑操作的权限。

通过此页面，您可以了解到如何创建、修改和删除集群，以及如何查看节点详情。

2. 创建集群

(1) 点击左上方的 创建集群，右侧会弹出创建集群页面，输入相关信息，包括集群编码、集群名称和集群描述；

集群创建成功后，默认向该组织下所有项目公开，若想为所创集群配置特定的公开范围，需要在集群的权限管理页面进行设置。
- 集群编码：集群客户端的名称，限制为30个字符。
只能由小写字母、数字、”-“组成，且以小写字母开头，不能以”-“结尾。
- 集群名称：项目下集群的显示名称。限制为10个字符。
- 集群描述：环境的描述，限制为30字符。

(2) 填写完成后，点击创建，界面会自动生成可执行的shell脚本命令，其中各个参数已经由后端服务自动生成。

helm upgrade --install --create-namespace \
    choerodon-cluster-agent-test-cluster \
    --repo=https://openchart.choerodon.com.cn/choerodon/c7n/ \
    --namespace=choerodon \
    --version=0.23.2 \
    --set config.connect=wss://service.choerodon.com.cn/websocket \
    --set config.token=81a64691-c31a-4b19-bfd2-c0aa10c8d50d \
    --set [email protected] \
    --set-string config.clusterId=81712320244796416 \
    --set config.choerodonId=62a0c1fb \
    --set rbac.create=true \
    choerodon-cluster-agent

- helm: 在集群中的kubectl创建的命名空间内通过helm install部署一个集群客户端。参数有： - repo: chart仓库地址，取值为部署持续交互时的环境变量env.open.AGENT_REPOURL - name: release name，取值为集群编码 - version: chart version，取值为署持续交付时的环境变量env.open.AGENT_VERSION - config: 环境变量 - connect:取值为部署持续交付时的环境变量env.open.AGENT_SERVICEURL - token：生成集群时自动生成 - clusterId: 集群的唯一性标识 - rbac.create: 用于控制kubectl权限
- choerodon-agent: chart name

(3) 复制脚本命令至集群中运行，与平台建立连接。

自Choerodon 0.22.0版本开始，C7N agent中helm组件已由V2升级至V3，进行激活操作前请确保集群中helm指令为 v3.2.4 版本。若未达到要求版本，请先更新helm指令后再进行后续操作。

 > - helm 的版本必须是v3.2.0及以上。

(4) 执行成功后回到集群管理界面，便可以看到之前创建好的集群状态变为连接状态。

3. 管理集群

在左侧的树结构中，点击标识，可选择 修改集群或者 删除集群。同时，对于未连接的集群，还可以选择 激活集群的选项。

修改集群：此处仅支持修改集群的名称与描述
删除集群：点击 删除集群，会弹出复制删除指令的提示框，当复制指令去k8s运行后，再回到平台点击“已执行，删除”，该集群将被彻底删除。
激活集群：该操作仅用于未连接状态的集群。

只有未连接且无关联环境的集群才能被删除。

4. 查看集群详情

在集群管理页面的树结构中，状态为运行中的集群会统一分布在树结构上部分，而状态为未连接的集群则聚集在树结构的下半部分。在集群树结构中，每一个处于运行中状态的集群下方都会展示出该集群下部分节点的信息，点击某个节点名称，可以看到资源分配和节点监控页签。默认展示资源分配页签下的内容。

(1) 资源分配在资源分配页签下，可以看到该节点中的资源分配情况和其中的Pods详情。

(2) 节点监控如果集群安装了监控组件，点击节点监控页签，登录后即可看到节点的计算、存储、网络等资源。

如何安装监控组件，请查看组件管理一节。登录相关操作，请查看集群监控一节。

5. 集群权限分配

点击 权限分配页签，便可查看到所选集群在组织内的公开范围，即拥有该集群权限的项目。

点击导航栏上方的 权限管理，便可设置集群的公开范围，其中包括组织下所有项目与组织下特定项目。

若选择 组织下所有项目，那么表示该组织下所有项目中的环境都能与该集群相连接；
若选择 组织下特定项目，就表示只有被分配权限的项目下的环境才能连接到该集群。

6. 健康检查

健康检查模块通过集成Polaris组件实现了集群的健康检查功能，支持检测出集群与环境中可能影响稳定性、可靠性、可伸缩性和安全性的配置问题。

只有处于“运行中”状态且有关联环境的集群，才能执行健康检查。

（1）执行健康检查

选择一个满足健康检查条件的集群，点击 健康检查页签，进入健康检查页面；
点击界面中的扫描按钮，开始执行健康检查；

（2）查看健康检查结果

健康检查成功后,能从“集群概览”和“环境详情”两个维度，查看存在配置项的问题。各个配置项在通过健康检查后，存在passed、warning以及error三个状态，分别代表检测通过、警告、错误的状态。而界面上的健康分值，也是根据passed状态配置项的占比计算得来的。需要注意的是，各类详情下，只会展示出warning与 error状态的配置项。

健康分值= passed配置项数量/(passed配置项数量+1/2warning配置项数量+error配置项数量)

从“集群概览”的维度查看集群中各个分类的配置项问题；主要分为了：健康检查、镜像检查、网络配置、资源分配以及安全这五类，并可以分别查看各个分类下有问题的配置项（warning与 error状态的配置项）及其所属的环境。
从“环境详情”的维度查看集群中所有环境（包括Choerodon平台环境与非Choerodon平台环境）中存在问题的配置项（warning与 error状态的配置项）。