SuperAPI AI 工具集

alibabacloud-pai-node-management

通用与其它

查看项目

更新于 10-15 19:55

技能介绍

用途:通过 aliyun paistudio CLI 插件查看与运维阿里云 PAI 计算节点,可列举节点、查询单节点详情,并执行 cordon / uncordon / drain。层级为 ResourceGroup → MachineGroup → Node。

主要能力:

  1. 列举节点:aliyun paistudio list-nodes --region "${REGION_ID}" --resource-group-ids "${RESOURCE_GROUP_ID}" --page-number 1 --page-size 50,或使用 --quota-id;--resource-group-ids 与 --quota-id 互斥,必须且只能提供一个。
  2. 单节点查询:get-node 不在公开 CLI 中,需以 list-nodes 加 --region、--resource-group-ids、--node-names 和 --page-size 1 实现,返回 Status、EcsSpec、GpuType、Cpu、Memory、Gpu、MachineGroupId、ZoneId、IpAddress、健康状态、labels、taints 等;启用 --verbose true 会额外返回 LimitCPU / LimitGPU / LimitMemory 资源占用数据,启用前需询问用户。
  3. 节点操作:cordon / uncordon / drain 须经控制面 operate-node,且需两步确认(先查询节点当前状态,再按确认协议输出 CONFIRM-NODE-OP <NODE_ID> 提示)。

观测性要求:每个调用云 API 的 aliyun 命令都必须附加 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-node-management/{session-id},会话内随机生成 32 位十六进制 session-id;本地工具命令如 aliyun configure、plugin、version 不加该标志。

权限与认证:需 aliyun CLI ≥ 3.3.3 及 paistudio 插件;代理不读取或回显 AK/SK,仅通过 aliyun configure list 检查,未配置时让用户自行运行 aliyun configure。读取受 pai:GetQuota 或 pai:GetResourceGroup 约束,操作用 pai:UpdateResourceGroup 或 pai:UpdateQuota;遇 Forbidden.RAM / NoPermission 应停止并输出失败 Action 与 Resource。

限制:节点由平台托管,禁止节点级直接访问,不得使用 kubectl、SSH、nvidia-smi、SDK、curl、MCP、Terraform 等替代路径。get-node-gpu-metrics 与 list-node-pods 不在公开 CLI 中,无法调用,需引导至 PAI 控制台 ResourceGroup / Quota 级聚合看板,或升级至平台运维团队、灵骏运维工单、客户经理。节点开关机 / 重启 / 替换 / 迁移、MachineGroup 删除 / 释放均不在范围内。

适用场景:需要枚举节点、排查单节点规格与状态、或在 PAI 控制面内对节点执行 cordon / uncordon / drain 的场景。