Node 节点

NODE_MACHINE_TYPE = "O" NODE_CPU = 4 NODE_MEM = 4096 NODE_COUNT = 2 NODE_MAX_PODS = 110

存储

BOOT_DISK_TYPE = "CLOUD_RSSD" BOOT_DISK_SIZE = 40 DATA_DISK_TYPE = "CLOUD_RSSD" DATA_DISK_SIZE = 20

网络

CNI_MODE = "VPC" SERVICE_CIDR = "192.168.0.0/16"

其他

CHARGE_TYPE = "Dynamic" LB_CLASS = "nlb" KUBE_PROXY = "iptables" EXTERNAL_API_SERVER = "Yes" DELETE_PROTECTION = "No" IMAGE_OS = "Ubuntu 24.04"


## Step 1: 检查 ucloud-cli

检查 `ucloud` 命令是否可用：

```bash
which ucloud

如果不存在，执行以下脚本自动检测平台并下载：

OS=$(uname -s | tr '[:upper:]' '[:lower:]')
ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')
INSTALL_DIR="$HOME/.local/bin"
mkdir -p "$INSTALL_DIR"
curl -L "https://github.com/ucloud/ucloud-cli/releases/download/v0.3.0/ucloud-${OS}_${ARCH}.zip" -o /tmp/ucloud.zip
unzip -o /tmp/ucloud.zip -d "$INSTALL_DIR"
chmod +x "$INSTALL_DIR/ucloud"
export PATH="$INSTALL_DIR:$PATH"

安装后验证：

ucloud --help

若网络仍慢，告知用户手动下载对应平台包：

Step 2: 检查 CLI 配置

检查当前配置：

ucloud config list

需要确认以下字段已配置：

public_key — 不为空
private_key — 不为空
region — 不为空
zone — 不为空
project_id — 不为空

若有缺失，使用 AskUserQuestion 询问用户提供对应值，然后执行：

ucloud config set --region <Region> --zone <Zone> --project-id <ProjectId>

记录下 Region、Zone、ProjectId 用于后续步骤。

Step 3: 获取 VPC 和 Subnet

3.1 获取 VPC

ucloud api --Action DescribeVPC --Region <Region> --ProjectId <ProjectId>

从返回结果中：

解析 DataSet 数组
优先选择 Tag 为 Default 的 VPC
若无默认 VPC，用 AskUserQuestion 列出所有 VPC 让用户选择
记录 VPCId

3.2 获取 Subnet

ucloud api --Action DescribeSubnet --Region <Region> --ProjectId <ProjectId> --VPCId <VPCId>

从返回结果中：

解析 DataSet 数组
优先选择 Tag 为 Default 的 Subnet
若无默认 Subnet，用 AskUserQuestion 列出所有 Subnet 让用户选择
记录 SubnetId

Step 4: 获取 Kubernetes 版本

调用 GetUK8SVersions 接口获取可用版本列表：

ucloud api --Action GetUK8SVersions --Region <Region> --ProjectId <ProjectId> --Kind Dedicated

响应格式：

{
  "RetCode": 0,
  "Data": [
    { "K8sVersion": "1.32.8", "ContainerdVersion": "1.6.33" },
    { "K8sVersion": "1.30.14", "ContainerdVersion": "1.6.33" },
    { "K8sVersion": "1.28.15", "ContainerdVersion": "1.6.10" }
  ]
}

解析出第一个版本（最新）作为默认值：

ucloud api --Action GetUK8SVersions --Region <Region> --ProjectId <ProjectId> --Kind Dedicated \
  | python3 -c "import sys,json; data=json.load(sys.stdin); print(data['Data'][0]['K8sVersion'])"

默认使用列表中第一个版本（最新）
记录 K8sVersion（必须是完整三段式，如 1.32.8）

若接口报错，用 AskUserQuestion 让用户手动输入版本号。

Step 5: 获取镜像 ID

ucloud api --Action DescribeUK8SImage --Region <Region> --ProjectId <ProjectId>

从返回结果中：

找到 ImageName 包含 Ubuntu 24.04 或 Ubuntu 2404 的镜像
若找不到，选择最新的 Ubuntu 镜像
记录 ImageId

若接口报错，用 AskUserQuestion 让用户提供镜像 ID。

Step 6: 生成密码

生成随机密码（包含大小写字母和数字，12位）：

openssl rand -base64 12 | tr -dc 'A-Za-z0-9' | head -c 12

然后 Base64 编码：

echo -n "<password>" | base64

务必记录明文密码，最后报告给用户。

Step 7: 组装请求 JSON 并创建集群

使用 Write 工具将以下 JSON 写入临时文件 /tmp/create_uk8s.json：

{
  "Action": "CreateUK8SClusterV2",
  "Region": "<Region>",
  "Zone": "<Zone>",
  "ProjectId": "<ProjectId>",
  "ClusterName": "<CLUSTER_NAME>",
  "Tag": "Default",
  "LoginMode": "Password",
  "Password": "<Base64Password>",
  "K8sVersion": "<K8sVersion>",
  "VPCId": "<VPCId>",
  "SubnetId": "<SubnetId>",
  "ExternalApiServer": "Yes",
  "MasterMachineType": "O",
  "MasterCPU": 2,
  "MasterMem": 4096,
  "MasterMinmalCpuPlatform": "Intel/CascadelakeR",
  "MasterBootDiskType": "CLOUD_RSSD",
  "MasterDataDiskType": "CLOUD_RSSD",
  "MasterDataDiskSize": 20,
  "Nodes.0.Zone": "<Zone>",
  "Nodes.0.MachineType": "O",
  "Nodes.0.MinmalCpuPlatform": "Intel/CascadelakeR",
  "Nodes.0.CPU": 4,
  "Nodes.0.Mem": 4096,
  "Nodes.0.Count": 2,
  "Nodes.0.IsolationGroup": "",
  "Nodes.0.MaxPods": 110,
  "Nodes.0.Labels.0.Key": "",
  "Nodes.0.Labels.0.Value": "",
  "Nodes.0.BootDiskType": "CLOUD_RSSD",
  "Nodes.0.DataDiskType": "CLOUD_RSSD",
  "Nodes.0.DataDiskSize": 20,
  "ImageId": "<ImageId>",
  "CNIMode": "VPC",
  "ServiceCIDR": "192.168.0.0/16",
  "ChargeType": "Dynamic",
  "LbClass": "nlb",
  "KubeProxy.Mode": "iptables",
  "Master.0.Zone": "<Zone>",
  "Master.1.Zone": "<Zone>",
  "Master.2.Zone": "<Zone>"
}

重要：用实际获取到的值替换所有 <placeholder>。

Step 8: 执行创建

ucloud api --local-file /tmp/create_uk8s.json

检查返回结果：

成功：解析 ClusterId
失败：显示错误信息，分析原因并提示用户

Step 9: 报告结果

创建成功后，向用户报告：

UK8S 集群创建成功！

集群名称: <CLUSTER_NAME>
集群 ID:   <ClusterId>
Region:    <Region>
Zone:      <Zone>

Master: 3 x O型 (2C/4G)
Node:   2 x O型 (4C/4G)

K8s 版本: <K8sVersion>
CNI:      VPC 模式
Service CIDR: 192.168.0.0/16

登录密码: <明文密码>
（请妥善保管此密码）

集群创建中，预计 5-10 分钟完成。
可通过以下命令查看状态：
ucloud api --Action DescribeUK8SCluster --Region <Region> --ProjectId <ProjectId> --ClusterId <ClusterId>

错误处理

任何 API 调用失败时，显示完整错误信息
分析常见错误：余额不足、配额限制、参数错误
提供修复建议
不要静默忽略任何错误

参考文档

UK8S API: https://docs.ucloud.cn/api/uk8s-api/
VPC API: https://docs.ucloud.cn/api/vpc-api/README
ucloud-cli: https://github.com/ucloud/ucloud-cli

create-uk8s

创建 UK8S Kubernetes 集群

默认配置