SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场alibabacloud-ack-cli

alibabacloud-ack-cli

部署与运维

查看项目

更新于 10-15 12:04

技能介绍

概述 该技能用于在终端管理阿里云容器服务 Kubernetes（ACK），基于 aliyun CLI 的 cs 插件工作。资料中给出了具体的版本参照（aliyun-cli 3.3.2 + cs plugin 0.2.1），并建议插件更新后重新运行内置的自发现命令以刷新 API 与参数列表。

用途 面向需要从命令行操作 ACK 的用户，覆盖集群生命周期（创建、修改、删除、升级）、节点池（创建、扩缩容、升级、删除）、组件（Addon）的安装、升级、卸载，以及获取 kubeconfig、查看任务等常见运维场景。

主要能力与要点

  1. 安装与验证：需要 aliyun CLI 与 cs 插件，资料给出插件安装、更新、列表核对命令，并提供脚本 check-cs-plugin.sh、install-cs-plugin.sh 进行一键检查与安装；包含端到端的 describe-clusters-for-region 验证调用，用于同时验证 CLI、插件与鉴权。
  2. 命令风格：只使用 kebab-case 插件命令，不使用旧版 PascalCase 的 OpenAPI 形式；建议在构造任何命令前先运行 --help 查看参数类型与结构。
  3. 异步任务：许多 ACK 操作异步返回 task_id，需要通过 describe-task-info 轮询查看状态（running / success / failed）与错误信息；支持 pause-task / resume-task / cancel-task 统一控制任务；任务 ID 具有区域作用域，需传入对应 region。
  4. 复杂 JSON 参数：部分参数为嵌套结构，例如 Terway 的 PodVswitchId、AutoMode、Addon 的 config。其中 config 为“JSON 字符串内嵌在 JSON 中”的形态，资料提示易出现转义错误（InvalidParameter.Format），建议用文件或 jq 构造。
  5. 区域化 API：遵循两条规则——优先使用 *ForRegion 变体（如 describe-clusters-for-region，使用 --biz-region-id），并在集群 ID 维度的调用上传递 --region 以直连区域端点。资料说明 --region 与 --biz-region-id 取值相同但角色不同，且不存在 --region-id 参数。
  6. 废弃参数检测：CLI 在 --help 中以中文「【该参数已废弃】」标记废弃参数（无英文等价），需要显式匹配，并应按提示使用替代参数。
  7. 可观测性要求：加载技能时生成一次性 32 位小写十六进制 session id，并在每个云 API（业务）命令中以固定形式携带 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ack-cli/{session-id}；CLI 系统/工具命令与 --help 不携带该参数。

使用方式 结合 aliyun cs 子命令完成操作，典型命令包括：describe-clusters-for-region、describe-cluster-detail、describe-cluster-user-kubeconfig、upgrade-cluster、describe-cluster-node-pools、describe-cluster-node-pool-detail、modify-cluster-node-pool（以 desired_size 设定绝对节点数）、upgrade-cluster-nodepool、list-addons、describe-addon、list-cluster-addon-instances、install-cluster-addons、upgrade-cluster-addons、un-install-cluster-addons、describe-task-info、describe-cluster-tasks 等。资料还提供 wait-for-task.sh 脚本用于带退避的任务轮询。

适用场景 需要在终端批量或自动化地管理 ACK 集群、节点池、组件与任务轮询的用户，例如创建集群、调整节点数量、安装/升级 Addon、获取 kubeconfig、跟踪异步任务状态。

限制与注意

  • 资料参照的版本为 aliyun-cli 3.3.2 + cs plugin 0.2.1，更新后需重新发现参数。
  • 部分操作（创建、删除、升级、扩缩容、Addon 变更等）为异步，需轮询任务确认结果；资料建议开始长时间轮询前先询问用户，示例默认每 30 秒轮询并设定上限（集群创建约 30 分钟，Addon 安装约 5 分钟）。
  • 扩缩容需注意 scale-cluster-node-pool --count 为增量而非绝对值，设置绝对数量应使用 modify-cluster-node-pool 的 desired_size。
  • 具体收费、价格、平台支持范围、权限策略细节，资料未提供完整说明，需参考对应官方文档。
  • 关于脚本具体实现与其他参考文件内容，资料仅提及文件名，未提供全部细节。