如何创建超级节点池¶

文档元信息¶

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

功能概述¶

在 TKE 集群中创建超级节点池（Virtual Node Pool），提供 Serverless 化的容器运行能力，无需管理底层节点。

核心优势: - 免节点运维: 无需关心节点的购买、扩容和维护 - 按需计费: 按 Pod 实际使用的资源计费 - 快速弹性: 秒级启动 Pod，无需等待节点创建 - 资源隔离: 每个 Pod 独立的安全沙箱环境

任务目标: 在指定集群中创建超级节点池，用于承载 Serverless 工作负载

前置条件¶

• 集群状态为 Running
• 集群网络模式支持超级节点（VPC-CNI 或 Global Router）
• 已准备好子网 ID 和安全组 ID
• 账户余额充足（超级节点按量计费）
• 确认地域支持超级节点功能

操作步骤¶

Step 1: 准备节点池配置参数¶

Labels 结构:

{
  "Labels": [
    {
      "Name": "node-type",
      "Value": "serverless"
    },
    {
      "Name": "env",
      "Value": "production"
    }
  ]
}

Taints 结构:

{
  "Taints": [
    {
      "Key": "serverless",
      "Value": "true",
      "Effect": "NoSchedule"
    }
  ]
}

Step 2: 调用 CreateClusterVirtualNodePool API¶

使用腾讯云 CLI:

tccli tke CreateClusterVirtualNodePool \
  --Region ap-guangzhou \
  --ClusterId cls-xxxxxxxx \
  --Name vk-nodepool \
  --SubnetIds '["subnet-xxxxxxxx"]' \
  --SecurityGroupIds '["sg-xxxxxxxx"]' \
  --Labels '[
    {
      "Name": "node-type",
      "Value": "serverless"
    }
  ]' \
  --DeletionProtection false \
  --OS linux

使用 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.CreateClusterVirtualNodePoolRequest()
req.ClusterId = "cls-xxxxxxxx"
req.Name = "vk-nodepool"
req.SubnetIds = ["subnet-xxxxxxxx"]
req.SecurityGroupIds = ["sg-xxxxxxxx"]

# 配置标签
label = models.Label()
label.Name = "node-type"
label.Value = "serverless"
req.Labels = [label]

# 配置操作系统
req.OS = "linux"
req.DeletionProtection = False

resp = client.CreateClusterVirtualNodePool(req)
print(f"节点池ID: {resp.NodePoolId}")
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.NewCreateClusterVirtualNodePoolRequest()
    request.ClusterId = common.StringPtr("cls-xxxxxxxx")
    request.Name = common.StringPtr("vk-nodepool")
    request.SubnetIds = common.StringPtrs([]string{"subnet-xxxxxxxx"})
    request.SecurityGroupIds = common.StringPtrs([]string{"sg-xxxxxxxx"})
    request.OS = common.StringPtr("linux")
    request.DeletionProtection = common.BoolPtr(false)

    response, err := client.CreateClusterVirtualNodePool(request)
    if err != nil {
        panic(err)
    }
    fmt.Printf("节点池ID: %s\n", *response.Response.NodePoolId)
}

Step 3: 获取响应¶

成功响应:

{
  "Response": {
    "NodePoolId": "np-xxxxxxxx",
    "RequestId": "12345678-1234-1234-1234-123456789012"
  }
}

验证步骤¶

Step 1: 查询节点池状态¶

tccli tke DescribeClusterVirtualNodePools \
  --Region ap-guangzhou \
  --ClusterId cls-xxxxxxxx

Step 2: 使用 kubectl 验证¶

# 查看虚拟节点（创建节点池后需要创建虚拟节点才会出现）
kubectl get nodes -l node-type=serverless

# 查看节点池相关的系统 Pod
kubectl get pods -n kube-system | grep virtual-kubelet

期望结果:

NAME                                READY   STATUS    RESTARTS   AGE
virtual-kubelet-np-xxxxxxxx-xxxxx   1/1     Running   0          2m

Step 3: 查看超级节点池详情¶

# 使用控制台或 API 查询节点池详细信息
tccli tke DescribeClusterVirtualNodePools \
  --Region ap-guangzhou \
  --ClusterId cls-xxxxxxxx \
  --Filters '[
    {
      "Name": "NodePoolId",
      "Values": ["np-xxxxxxxx"]
    }
  ]'

异常处理¶

常见错误及解决方案¶

节点池创建失败处理¶

如果节点池状态异常:

# 1. 查看节点池详细信息
tccli tke DescribeClusterVirtualNodePools \
  --Region ap-guangzhou \
  --ClusterId cls-xxxxxxxx

# 2. 检查集群事件
kubectl get events -n kube-system --sort-by='.lastTimestamp'

# 3. 查看 virtual-kubelet 日志
kubectl logs -n kube-system -l app=virtual-kubelet

高级配置¶

配置多子网支持¶

{
  "SubnetIds": [
    "subnet-xxxxxxx1",
    "subnet-xxxxxxx2",
    "subnet-xxxxxxx3"
  ]
}

说明: 多子网配置可实现跨可用区的容灾能力

配置节点标签和污点¶

{
  "Labels": [
    {
      "Name": "workload-type",
      "Value": "batch"
    },
    {
      "Name": "cost-center",
      "Value": "ai-team"
    }
  ],
  "Taints": [
    {
      "Key": "serverless",
      "Value": "true",
      "Effect": "NoSchedule"
    }
  ]
}

配置删除保护¶

{
  "DeletionProtection": true
}

说明: 开启删除保护后，需要先关闭保护才能删除节点池，避免误删除

Agent Prompt 模板¶

创建超级节点池 Prompt¶

请在集群中创建超级节点池:
- 集群ID: {{cluster_id}}
- 节点池名称: vk-nodepool-prod
- 子网ID: {{subnet_id}}
- 安全组ID: {{security_group_id}}
- 节点标签: node-type=serverless, env=production
- 操作系统: linux
- 删除保护: 关闭

创建带污点的节点池 Prompt¶

请创建一个带污点的超级节点池，用于运行特定工作负载:
- 集群ID: cls-xxxxxxxx
- 名称: vk-nodepool-dedicated
- 污点配置: dedicated=gpu:NoSchedule
- 标签: gpu=true

最佳实践¶

1. 子网规划:
2. 建议为超级节点池规划独立的子网
3. 确保子网 IP 地址段充足（建议 /24 或更大）

4. 多可用区部署时配置多个子网

5. 安全组配置:

6. 允许集群 CIDR 访问超级节点
7. 开放必要的端口（如 443 用于 API 访问）

8. 根据业务需求配置出站规则

9. 标签策略:

10. 使用标签标识节点类型: node-type=serverless
11. 使用标签标识环境: env=production

12. 使用标签进行成本分摊: cost-center=team-name

13. 污点配置:

14. 为超级节点添加污点避免非预期 Pod 调度
15. 配合 Pod 的 tolerations 实现精准调度

16. 示例污点: serverless=true:NoSchedule

17. 删除保护:

18. 生产环境建议开启删除保护
19. 定期审查不使用的节点池

相关文档¶

• 创建按量超级节点
• 删除超级节点
• 查询超级节点池
• 普通节点管理

API 文档链接¶

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

Cookbook 示例¶

完整可执行代码示例: TKE 超级节点池创建 Cookbook

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