返回 Cookbooks
cluster recipe

删除 TKE 集群

使用腾讯云 Python SDK 删除指定 TKE 集群,默认 dry-run,必须显式确认才会提交删除请求。

Python 10 分钟 Verified 风险:高 TKE APIDelete ClusterCleanup

风险与费用提示

资源影响 删除云资源
费用影响 会删除真实 TKE 集群,并可能销毁 CVM 节点和云硬盘;删除后需检查是否有遗留负载均衡器。

脚本默认 dry-run;执行 --confirm-delete 前必须完成数据备份、删除保护检查和资源保留策略确认。

执行拓扑

Python SDK
TKE API
资源清理

前置条件

  • 已准备腾讯云 SecretId 和 SecretKey。
  • 已复制 cookbook/config.example.yaml 为 cookbook/config.yaml。
  • 已确认目标 ClusterId、地域、备份状态、删除保护状态、CBS 删除策略和删除后需要核查的关联资源。

参数表

参数 必填 示例 说明
--cluster-id cls-xxxxxxxx 要删除的 TKE 集群 ID。
--region ap-guangzhou 目标集群所在地域。
--confirm-delete --confirm-delete 确认提交 DeleteCluster 请求;不传时只输出删除计划。
--instance-delete-mode terminate 节点删除策略,可选 terminate 或 retain。
--cbs-delete-mode retain CBS 删除策略,可选 terminate 或 retain。
--wait --wait 提交删除请求后等待集群删除完成。

执行命令

Step 1
cd cookbook
Step 2
pip install -r requirements.txt
Step 3
python3 cluster/delete_cluster.py --cluster-id cls-xxxxxxxx --region ap-guangzhou
Step 4
python3 cluster/delete_cluster.py --cluster-id cls-xxxxxxxx --region ap-guangzhou --confirm-delete --wait

验证步骤

Check 1
tccli tke DescribeClusters --Region ap-guangzhou --ClusterIds '["cls-xxxxxxxx"]'
Check 2
确认返回 ResourceNotFound.ClusterNotFound,或查询结果中不再包含该集群。

清理步骤

  1. 检查 CVM、CBS、CLB、公网 IP 等关联计费资源是否已删除或按预期保留。
  2. 如选择 retain,记录保留资源清单和后续负责人。
  3. 确认本次操作产生的日志和备份文件已按团队要求归档。

Agent Prompt

Prompt

请根据 TKE Workshop 的 delete-cluster Cookbook,先对 cls-xxxxxxxx 输出 dry-run 删除计划,确认备份、删除保护和 CBS 删除策略后,再提交删除、等待完成并检查关联资源。