如何删除超级节点¶

文档元信息¶

功能名称: 删除超级节点
API 版本: 2018-05-25
适用集群版本: 所有版本
文档更新时间: 2026-01-07
Agent 友好度: ⭐⭐⭐⭐⭐

功能概述¶

从 TKE 集群中删除指定的虚拟节点（Virtual Node），释放 Serverless 资源。

核心功能: - 单个删除: 删除指定的虚拟节点 - 批量删除: 同时删除多个虚拟节点 - 强制删除: 即使节点上有运行中的 Pod 也执行删除 - 安全删除: 默认检查节点上是否有 Pod，有则拒绝删除

任务目标: 安全地删除不再使用的虚拟节点，释放资源

前置条件¶

集群状态为 Running
虚拟节点存在且可访问
已获取虚拟节点名称（NodeName）
确认节点上的 Pod 可以被安全删除（非强制删除时）

操作步骤¶

Step 1: 查询虚拟节点列表¶

在删除前，先确认要删除的节点名称:

# 查看所有虚拟节点
kubectl get nodes -l type=virtual-kubelet

# 查看节点详情
kubectl describe node eklet-subnet-xxxxxxxx-0

# 查看节点上运行的 Pod
kubectl get pods --all-namespaces -o wide --field-selector spec.nodeName=eklet-subnet-xxxxxxxx-0

Step 2: 准备删除参数¶

参数名	必填	类型	说明	示例值
ClusterId	是	String	集群 ID	cls-xxxxxxxx
NodeNames	是	Array	虚拟节点名称列表	["eklet-subnet-xxx-0"]
Force	否	Boolean	是否强制删除	false (默认)

Force 参数说明: - false (默认): 非强制删除，如果节点上有运行中的 Pod，操作将失败 - true: 强制删除，即使节点上有运行中的 Pod 也会执行删除

Step 3: 调用 DeleteClusterVirtualNode API¶

方式一: 安全删除（推荐）

# 使用腾讯云 CLI - 默认安全删除
tccli tke DeleteClusterVirtualNode \
  --Region ap-guangzhou \
  --ClusterId cls-xxxxxxxx \
  --NodeNames '["eklet-subnet-xxxxxxxx-0"]'

方式二: 强制删除（谨慎使用）

# 强制删除，即使有运行中的 Pod
tccli tke DeleteClusterVirtualNode \
  --Region ap-guangzhou \
  --ClusterId cls-xxxxxxxx \
  --NodeNames '["eklet-subnet-xxxxxxxx-0"]' \
  --Force true

使用 Python SDK:

from tencentcloud.common import credential
from tencentcloud.tke.v20180525 import tke_client, models

cred = credential.Credential("SecretId", "SecretKey")
client = tke_client.TkeClient(cred, "ap-guangzhou")

req = models.DeleteClusterVirtualNodeRequest()
req.ClusterId = "cls-xxxxxxxx"
req.NodeNames = ["eklet-subnet-xxxxxxxx-0"]
req.Force = False  # 安全删除

resp = client.DeleteClusterVirtualNode(req)
print(f"删除成功, 请求ID: {resp.RequestId}")

使用 Go SDK:

package main

import (
    "fmt"
    "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common"
    "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/profile"
    tke "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/tke/v20180525"
)

func main() {
    credential := common.NewCredential("SecretId", "SecretKey")
    cpf := profile.NewClientProfile()
    client, _ := tke.NewClient(credential, "ap-guangzhou", cpf)

    request := tke.NewDeleteClusterVirtualNodeRequest()
    request.ClusterId = common.StringPtr("cls-xxxxxxxx")
    request.NodeNames = common.StringPtrs([]string{"eklet-subnet-xxxxxxxx-0"})
    request.Force = common.BoolPtr(false)

    response, err := client.DeleteClusterVirtualNode(request)
    if err != nil {
        panic(err)
    }
    fmt.Printf("删除成功, 请求ID: %s\n", *response.Response.RequestId)
}

批量删除虚拟节点:

# 批量删除多个虚拟节点
req = models.DeleteClusterVirtualNodeRequest()
req.ClusterId = "cls-xxxxxxxx"
req.NodeNames = [
    "eklet-subnet-xxxxxxx1-0",
    "eklet-subnet-xxxxxxx2-0",
    "eklet-subnet-xxxxxxx3-0"
]
req.Force = False

resp = client.DeleteClusterVirtualNode(req)

Step 4: 获取响应¶

成功响应:

{
  "Response": {
    "RequestId": "1ac0d3ae-063e-4789-93fe-3c73e93191b9"
  }
}

验证步骤¶

Step 1: 验证节点已删除¶

# 查看节点列表，确认节点已不存在
kubectl get nodes -l type=virtual-kubelet

# 查看特定节点（应该返回 Not Found）
kubectl get node eklet-subnet-xxxxxxxx-0

期望结果:

Error from server (NotFound): nodes "eklet-subnet-xxxxxxxx-0" not found

Step 2: 验证 Pod 状态¶

如果是强制删除，检查原节点上的 Pod 状态:

# 查看所有 Pod 状态
kubectl get pods --all-namespaces -o wide

# Pod 应该已被终止或重新调度到其他节点

Step 3: 查看集群事件¶

# 查看最近的集群事件
kubectl get events --all-namespaces --sort-by='.lastTimestamp' | tail -20

安全删除流程¶

异常处理¶

常见错误及解决方案¶

错误码	错误信息	原因	解决方案
ResourceInUse.ExistRunningPod	存在运行中的 Pod	节点上有运行中的 Pod	先驱逐 Pod 或使用强制删除
ResourceUnavailable.ClusterState	集群状态异常	集群状态不支持操作	等待集群状态恢复正常
InvalidParameter.Param	参数错误	参数格式或取值错误	检查参数格式
InternalError.UnexpectedInternal	未知内部错误	服务端错误	稍后重试或联系技术支持
ResourceNotFound.NodeNotFound	节点不存在	节点已被删除或不存在	确认节点名称正确

删除失败处理¶

场景 1: 节点上有运行中的 Pod

# 1. 查看节点上的 Pod
kubectl get pods --all-namespaces -o wide \
  --field-selector spec.nodeName=eklet-subnet-xxxxxxxx-0

# 2. 驱逐 Pod
kubectl drain eklet-subnet-xxxxxxxx-0 \
  --ignore-daemonsets \
  --delete-emptydir-data \
  --force

# 3. 重新执行删除
tccli tke DeleteClusterVirtualNode \
  --Region ap-guangzhou \
  --ClusterId cls-xxxxxxxx \
  --NodeNames '["eklet-subnet-xxxxxxxx-0"]'

场景 2: 紧急情况需要强制删除

# 使用强制删除（会直接终止 Pod）
tccli tke DeleteClusterVirtualNode \
  --Region ap-guangzhou \
  --ClusterId cls-xxxxxxxx \
  --NodeNames '["eklet-subnet-xxxxxxxx-0"]' \
  --Force true

注意: 强制删除会立即终止节点上的所有 Pod，可能导致服务中断，请谨慎使用。

高级配置¶

批量安全删除脚本¶

#!/bin/bash

CLUSTER_ID="cls-xxxxxxxx"
REGION="ap-guangzhou"
NODE_NAMES=(
  "eklet-subnet-xxxxxxx1-0"
  "eklet-subnet-xxxxxxx2-0"
  "eklet-subnet-xxxxxxx3-0"
)

for node in "${NODE_NAMES[@]}"; do
  echo "处理节点: $node"

  # 驱逐 Pod
  kubectl drain $node \
    --ignore-daemonsets \
    --delete-emptydir-data \
    --force \
    --grace-period=300

  if [ $? -eq 0 ]; then
    echo "驱逐成功，开始删除节点"

    # 删除节点
    tccli tke DeleteClusterVirtualNode \
      --Region $REGION \
      --ClusterId $CLUSTER_ID \
      --NodeNames "[\"$node\"]"

    echo "节点 $node 删除完成"
  else
    echo "节点 $node 驱逐失败，跳过删除"
  fi

  sleep 5
done

删除前的健康检查¶

from tencentcloud.common import credential
from tencentcloud.tke.v20180525 import tke_client, models
import subprocess

def check_node_pods(node_name):
    """检查节点上是否有运行中的 Pod"""
    cmd = f"kubectl get pods --all-namespaces -o wide --field-selector spec.nodeName={node_name}"
    result = subprocess.run(cmd.split(), capture_output=True, text=True)
    return result.stdout.strip()

def delete_virtual_node_safely(cluster_id, node_name, force=False):
    """安全删除虚拟节点"""
    # 检查节点上的 Pod
    pods = check_node_pods(node_name)

    if pods and not force:
        print(f"警告: 节点 {node_name} 上有运行中的 Pod:")
        print(pods)
        confirm = input("是否继续删除? (yes/no): ")
        if confirm.lower() != 'yes':
            print("取消删除操作")
            return

    # 执行删除
    cred = credential.Credential("SecretId", "SecretKey")
    client = tke_client.TkeClient(cred, "ap-guangzhou")

    req = models.DeleteClusterVirtualNodeRequest()
    req.ClusterId = cluster_id
    req.NodeNames = [node_name]
    req.Force = force

    try:
        resp = client.DeleteClusterVirtualNode(req)
        print(f"删除成功, 请求ID: {resp.RequestId}")
    except Exception as e:
        print(f"删除失败: {e}")

# 使用示例
delete_virtual_node_safely("cls-xxxxxxxx", "eklet-subnet-xxxxxxxx-0")

Agent Prompt 模板¶

安全删除虚拟节点 Prompt¶

请安全删除虚拟节点:
- 集群ID: {{cluster_id}}
- 节点名称: {{node_name}}
- 删除方式: 安全删除（先驱逐 Pod）

强制删除虚拟节点 Prompt¶

请强制删除虚拟节点（紧急情况）:
- 集群ID: cls-xxxxxxxx
- 节点名称: eklet-subnet-xxxxxxxx-0
- 删除方式: 强制删除
- 注意: 会立即终止节点上的所有 Pod

批量删除虚拟节点 Prompt¶

请批量删除以下虚拟节点:
- 集群ID: cls-xxxxxxxx
- 节点列表: eklet-subnet-xxx1-0, eklet-subnet-xxx2-0, eklet-subnet-xxx3-0
- 删除前先驱逐所有 Pod

最佳实践¶

删除前检查:
始终先查看节点上的 Pod 状态
确认业务可以被安全迁移
检查是否有 StatefulSet 或持久化数据
优雅驱逐:
使用 kubectl drain 优雅驱逐 Pod
设置合理的 grace-period（如 300s）
使用 --ignore-daemonsets 忽略 DaemonSet
删除策略:
生产环境推荐使用安全删除（Force=false）
仅在紧急情况下使用强制删除
批量删除时逐个处理，避免大规模中断
监控和验证:
删除后验证节点已从集群中移除
检查 Pod 是否成功重新调度
查看集群事件确认无异常
自动化清理:
使用脚本批量清理不用的虚拟节点
定期检查并清理闲置节点
结合监控系统自动化运维

API 文档链接¶

DeleteClusterVirtualNode: https://cloud.tencent.com/document/api/457/85353
API Explorer: https://console.cloud.tencent.com/api/explorer?Product=tke&Version=2018-05-25&Action=DeleteClusterVirtualNode

Cookbook 示例¶

完整可执行代码示例: TKE 超级节点删除 Cookbook

文档版本: v1.0
最后更新: 2026-01-07
维护者: TKE Documentation Team