SuperAPI AI 工具集

ucs-cluster-onboarding-manager

通用与其它

查看项目

更新于 10-15 22:15

技能介绍

用途:该技能面向华为云 UCS(Universal Cloud Service),通过 hcloud CLI 对集群进行纳管、生命周期与舰队分组管理,架构为 hcloud CLI → UCS 服务 API → Cluster/ClusterGroup/AccessConfig/KubeConfig 资源。

主要能力:注册自建或 CCE 集群到 UCS、从 UCS 注销集群、查询集群详情与列表、更新集群属性与元数据;创建/删除/更新/查询舰队分组,加入或移出分组;重试集群激活;获取集群访问信息与 kubeconfig;下载多集群联邦 kubeconfig;查询 UCS 资源配额。

使用方式:需安装 hcloud CLI(版本 >= 7.2.2),用 hcloud version 验证,首次使用可执行 printf "y\n" | hcloud version 接受隐私声明。凭证仅通过环境变量 HUAWEI_CLOUD_AK、HUAWEI_CLOUD_SK、HUAWEI_CLOUD_REGION 配置,禁止在代码、对话或命令中暴露 AK/SK,也不要用 echo 检查凭证。操作统一为 hcloud UCS <Operation> 格式,例如注册集群 hcloud UCS RegisterCluster、查询 hcloud UCS ShowCluster、创建分组 hcloud UCS RegisterClusterGroup、获取 kubeconfig hcloud UCS CreateClusterKubeconfig、下载联邦 kubeconfig hcloud UCS DownloadFederationKubeconfig、查询配额 hcloud UCS ShowQuota。RegisterCluster 使用 K8s API 风格参数(apiVersion、kind、metadata.、spec.),需注意 spec.category 取 self/onpremise、spec.provider 取 huaweicloud/self_managed、spec.type 小写 cce、spec.city 用城市代码。

适用场景:将 CCE 集群注册到 UCS、列出受管集群、注销集群、按环境或业务创建舰队分组、获取集群或联邦 kubeconfig、检查配额、更新集群元数据、重试激活等。

限制:需具备对应 IAM 权限(如 ucs:cluster:create、ucs:cluster:delete、ucs:clusterGroup:create、ucs:kubeconfig:create、ucs:quota:get 等),权限失败时需按参考文档创建自定义策略并授权;集群注销不可逆,会失去 UCS 策略治理与联邦访问;自建集群 kubeconfig 必须有效且 API Server 可达;ShowQuota 必须提供 domainid;联邦 kubeconfig 必须同时提供 clustergroupid 与 duration。具体输出格式、验证步骤与常见问题详见其参考文档。