用途:在 Zeabur 上管理专用 Kubernetes 集群(Linode LKE 或 AWS EKS)的节点池,包括列出节点池、修改节点数量、添加或删除节点池。节点池操作尚未进入 Zeabur CLI,需直接调用 https://api.zeabur.com/graphql,API 与云厂商原语一一对应(EKS 托管节点组或 LKE 节点池)。
主要能力:查询集群的 server ID 与节点池信息(id、instanceType、nodeCount、readyNodes、minNodes、maxNodes、status、price);用 scaleNodePool 原地调整节点数;用 addNodePool 添加不同机型(如更大或 GPU 节点);用 removeNodePool 删除节点池。
使用方式:所有请求需 Bearer token,优先用 ZEABUR_API_KEY,否则从 ~/.config/zeabur/cli.yaml 读取 CLI token;建议写入 0600 的 curl 配置文件并用 -K 传入,避免 token 出现在进程列表。先用 npx zeabur@latest server list -i=false 找 server ID,再调用 GraphQL。变更后每约 30 秒轮询列表,直到 readyNodes 等于新 nodeCount 且状态健康(EKS 为 ACTIVE,LKE 为 ready);约 15 分钟未收敛则停止并报告。
限制与注意:扩缩会改变真实计费,任何变更前必须明确确认集群、节点池、具体变更和当前月价,并得到直接的是/否答复,模糊回复不算同意。节点池变更需集群 owner 或 admin 权限。缩容会排空节点并重新调度工作负载,需确认剩余容量足够;不得把集群唯一节点池缩到 0,也不得删除最后一个节点池。传输层超时或失败时不要盲目重试,先重新查询状态。instanceType 原样传给云厂商,LKE 可查 https://api.linode.com/v4/linode/types,EKS 需用集群所在区域可用的 EC2 机型。401 需重新登录,空 nodePools 表示该服务器不是专用 Kubernetes 集群。