创建 UK8S Kubernetes 集群

你正在引导用户创建一个 UK8S 集群。集群名称从 $ARGUMENTS 获取，若未提供则默认为 uk8s。

默认配置

CLUSTER_NAME = $ARGUMENTS 或 "uk8s"

# Master 节点
MASTER_MACHINE_TYPE = "O"
MASTER_CPU = 2
MASTER_MEM = 4096
MASTER_COUNT = 3
MASTER_SERIES = "o1i"

# 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 命令是否可用：

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

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

• macOS ARM: https://github.com/ucloud/ucloud-cli/releases/download/v0.3.0/ucloud-darwin_arm64.zip
• macOS Intel: https://github.com/ucloud/ucloud-cli/releases/download/v0.3.0/ucloud-darwin_amd64.zip
• Linux amd64: https://github.com/ucloud/ucloud-cli/releases/download/v0.3.0/ucloud-linux_amd64.zip
• Linux arm64: https://github.com/ucloud/ucloud-cli/releases/download/v0.3.0/ucloud-linux_arm64.zip
• Windows amd64: https://github.com/ucloud/ucloud-cli/releases/download/v0.3.0/ucloud-windows_amd64.zip

Step 2: 检查 CLI 配置

检查当前配置：

ucloud config list

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

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

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

ucloud config set --region  --zone  --project-id 

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

Step 3: 获取 VPC 和 Subnet

3.1 获取 VPC

ucloud api --Action DescribeVPC --Region  --ProjectId 

从返回结果中：

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

3.2 获取 Subnet

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

从返回结果中：

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

Step 4: 获取 Kubernetes 版本

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

ucloud api --Action GetUK8SVersions --Region  --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  --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  --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 "" | base64

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

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

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

{
  "Action": "CreateUK8SClusterV2",
  "Region": "",
  "Zone": "",
  "ProjectId": "",
  "ClusterName": "",
  "Tag": "Default",
  "LoginMode": "Password",
  "Password": "",
  "K8sVersion": "",
  "VPCId": "",
  "SubnetId": "",
  "ExternalApiServer": "Yes",
  "MasterMachineType": "O",
  "MasterCPU": 2,
  "MasterMem": 4096,
  "MasterMinmalCpuPlatform": "Intel/CascadelakeR",
  "MasterBootDiskType": "CLOUD_RSSD",
  "MasterDataDiskType": "CLOUD_RSSD",
  "MasterDataDiskSize": 20,
  "Nodes.0.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": "",
  "CNIMode": "VPC",
  "ServiceCIDR": "192.168.0.0/16",
  "ChargeType": "Dynamic",
  "LbClass": "nlb",
  "KubeProxy.Mode": "iptables",
  "Master.0.Zone": "",
  "Master.1.Zone": "",
  "Master.2.Zone": ""
}

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

Step 8: 执行创建

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

检查返回结果：

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

Step 9: 报告结果

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

UK8S 集群创建成功！

集群名称: 
集群 ID:   
Region:    
Zone:      

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

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

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

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