返回 Cookbooks
cluster recipe

创建 TKE 托管集群

使用腾讯云 Python SDK 创建一个托管型 TKE 集群,并可选择等待集群进入 Running 状态。

Python 15 分钟 Verified 风险:高 TKE APIManaged ClusterVPC

风险与费用提示

资源影响 创建云资源
费用影响 会创建真实 TKE 集群、CVM 节点和云硬盘,可能产生持续费用。

执行前请确认地域、VPC、节点规格和预算;完成验证后按清理步骤删除集群。

执行拓扑

Python SDK
TKE API
K8s 集群

前置条件

  • 已准备腾讯云 SecretId 和 SecretKey。
  • 已在目标地域创建 VPC。
  • 已复制 cookbook/config.example.yaml 为 cookbook/config.yaml。

参数表

参数 必填 示例 说明
--cluster-name my-cluster 新建 TKE 集群名称,用于后续识别和清理。
--region ap-guangzhou 目标地域,必须与 VPC、子网和资源配额所在地域一致。
--wait --wait 创建后等待集群进入 Running 状态,适合自动化验证。

执行命令

Step 1
cd cookbook
Step 2
pip install -r requirements.txt
Step 3
python3 cluster/create_cluster.py --cluster-name my-cluster --region ap-guangzhou --wait

验证步骤

Check 1
tccli tke DescribeClusters --Region ap-guangzhou --ClusterIds '["cls-xxxxxxxx"]'
Check 2
确认 ClusterStatus 为 Running。

清理步骤

  1. 确认集群内业务和数据已不再需要。
  2. 在控制台或脚本中删除测试集群,并等待集群完全销毁。
  3. 检查 CVM、云硬盘、负载均衡和公网 IP 是否仍有遗留资源。

Agent Prompt

Prompt

请根据 TKE Workshop 的 create-cluster Cookbook,帮我在 ap-guangzhou 创建一个托管 TKE 集群。创建前先检查 config.yaml、VPC ID 和集群 CIDR,并在创建后等待集群 Running。