Agent Skills
返回列表
UK8S 集群详情查询

UK8S 集群详情查询

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_faf0d21d/uk8s-describe。

技能介绍

要解决什么问题

在 UCloud 上跑 UK8S 时，排查网络、节点状态或扩缩容问题，往往需要对照控制台里的集群 ID，一次性看清 Master/Node、内外网 IP 和节点状态。手工在文档里翻 DescribeUK8SCluster 的字段，再自己拼 ucloud-cli 命令，既慢也容易漏 Region 或 ClusterId 不匹配时的报错信息。

本技能把「查单个集群详情」收成固定流程：先校验 CLI 环境，再拿 ClusterId（未传则追问），调用接口并按约定格式化输出。

技能如何工作

  1. 环境检查：按 references/check-ucloud-cli.md 确认 ucloud-cli 可用。
  2. 参数：$ARGUMENTS 为必填的 ClusterId；为空时用 AskUserQuestion 收集并记录。
  3. 查询：调用 DescribeUK8SCluster；RetCode 为 0 才进入展示，否则输出完整 RetCode + Message 并终止（不吞错误）。
  4. 展示：

- 集群基本信息；
- MasterList：有数据则列出；为空时说明托管版集群不返回 Master；
- NodeList：为空时提示当前无 Node；
- 节点字段：内存为 MB（展示保留原值）；IPSet 中 Type=Private 作内网 IP，Bgp / Internation 作外网 IP；State 原样展示。

响应结构以 references/DescribeUK8SCluster.md 为准。

适用边界与注意点

  • 仅针对单个集群；ID 错误或 Region 不对时，应结合返回的 Message 让用户核对 ID 与地域。
  • 依赖已配置好的 ucloud-cli 与对应账号权限；环境未就绪时先完成 Step 1，再查集群。
  • 托管版集群不会在 API 里返回 Master 节点列表，空 MasterList 是预期行为，不是查询失败。

使用场景

  • 生产 UK8S 告警时，凭 ClusterId 查询节点 State 与 IPSet 内外网 IP，对照监控与工单信息。
  • 发布或升级前确认 MasterList 是否为空（托管版）及 NodeList 规模，避免按自建集群假设操作。
  • DescribeUK8SCluster 返回非 0 时，完整展示 RetCode 与 Message，核对 ClusterId、Region 是否匹配。
  • 用户反馈「看不到节点」时，先查 NodeList 是否为空，区分真实无 Node 与 ID/地域填错。

适合人员

  • 值守 UCloud UK8S 的 SRE，希望在 Agent 对话里按固定步骤拿到单集群配置与节点明细。
  • 日常用 ucloud-cli 维护云原生环境的工程师，需要统一 ClusterId 入参与 Master/Node 字段展示规则。
  • 为 UK8S 封装内部运维助手的平台开发，要求未传 ClusterId 时追问且不得吞掉 API 错误。
  • 从控制台转向 CLI 的 K8s 管理员，需要理解托管版无 Master、内存 MB 与 IPSet Type 的展示约定。