docs: reorganize basics node and kubernetes docs

Author: wenjiehs

cookbook/README.md

@@ -135,7 +135,7 @@ python3 supernode/deploy_gpu_pod.py \
 
 | 脚本 | 语言 | 功能 | 文档链接 |
 |------|------|------|---------|
-| `deploy_nginx.py` | Python | 部署 Nginx 示例 | [docs](../docs/basics/workload/01-create-deployment.md) |
+| `deploy_nginx.py` | Python | 部署 Nginx 示例 | [docs](../src/content/docs/basics/kubernetes/02-kubectl-common-operations.md) |
 
 ### 超级节点 (supernode/)
 

cookbook/workload/deploy_nginx.py

@@ -4,7 +4,7 @@
 
 功能: 在 TKE 集群中部署 Nginx Deployment 和 Service
 使用方法: python3 deploy_nginx.py --cluster-id cls-xxxxxxxx --replicas 3
-文档链接: https://tke-workshop.github.io/basics/workload/01-create-deployment/
+文档链接: https://tke-workshop.github.io/basics/kubernetes/02-kubectl-common-operations/
 """
 
 import argparse

src/content/docs/basics/cluster/01-create-cluster.md

@@ -51,6 +51,19 @@ title: "如何创建 TKE 集群"
 | RunInstancesForNode | 否 | Array | 节点创建参数 | 见下方 |
 | Region | 是 | String | 地域 | ap-guangzhou |
 
+**ClusterBasicSettings 常用参数**:
+
+| 参数名 | 必填 | 类型 | 说明 | 示例值 |
+|--------|------|------|------|--------|
+| ClusterName | 否 | String | 集群名称,建议不超过 50 个字符 | my-tke-cluster |
+| ClusterVersion | 否 | String | Kubernetes 版本 | 1.28.3 |
+| ClusterDescription | 否 | String | 集群描述 | 生产集群 |
+| VpcId | 否 | String | VPC ID | vpc-xxxxxxxx |
+| ProjectId | 否 | Integer | 项目 ID,默认 0 | 0 |
+| TagSpecification | 否 | Array | 集群资源标签配置 | 见下方 |
+| ClusterLevel | 否 | String | 集群规模: L5/L20/L50/L100/L200/L500 | L5 |
+| AutoUpgradeClusterLevel | 否 | Object | 集群规格自动升配配置 | `{"IsAutoUpgrade": true}` |
+
 **ClusterCIDRSettings 结构**:
 
 ```text
@@ -71,13 +84,51 @@ title: "如何创建 TKE 集群"
   "ClusterDescription": "测试集群",       // 集群描述
   "VpcId": "vpc-xxxxxxxx",                // VPC ID
   "ProjectId": 0,                         // 项目ID (默认0)
+  "TagSpecification": [                   // 集群资源标签
+    {
+      "ResourceType": "cluster",
+      "Tags": [
+        {"Key": "env", "Value": "production"},
+        {"Key": "owner", "Value": "platform-team"}
+      ]
+    }
+  ],
   "ClusterLevel": "L5",                   // 集群规模: L5/L20/L50/L100/L200/L500
   "AutoUpgradeClusterLevel": {            // 集群规格自动升配配置
     "IsAutoUpgrade": true                 // 是否自动升配
   }
 }
 ```
 
+**TagSpecification 结构**:
+
+```text
+[
+  {
+    "ResourceType": "cluster",            // 标签绑定的资源类型,创建集群时固定为 cluster
+    "Tags": [
+      {
+        "Key": "env",                     // 标签键
+        "Value": "production"             // 标签值
+      },
+      {
+        "Key": "owner",
+        "Value": "platform-team"
+      }
+    ]
+  }
+]
+```
+
+常用标签建议:
+
+| 标签键 | 示例值 | 用途 |
+|--------|--------|------|
+| env | production / staging / test | 区分环境 |
+| owner | platform-team | 标识责任团队 |
+| cost-center | cc-1001 | 成本分摊 |
+| project | payment | 关联业务项目 |
+
 #### Step 2: 调用 CreateCluster API
 
 **使用 cURL (HTTP 直接调用)**:
@@ -103,7 +154,16 @@ curl -X POST "https://tke.tencentcloudapi.com/" \
       "ClusterLevel": "L5",
       "AutoUpgradeClusterLevel": {
         "IsAutoUpgrade": true
-      }
+      },
+      "TagSpecification": [
+        {
+          "ResourceType": "cluster",
+          "Tags": [
+            {"Key": "env", "Value": "production"},
+            {"Key": "owner", "Value": "platform-team"}
+          ]
+        }
+      ]
     },
     "ClusterCIDRSettings": {
       "ClusterCIDR": "172.16.0.0/16",
@@ -130,7 +190,16 @@ tccli tke CreateCluster \
     "ClusterLevel": "L5",
     "AutoUpgradeClusterLevel": {
       "IsAutoUpgrade": true
-    }
+    },
+    "TagSpecification": [
+      {
+        "ResourceType": "cluster",
+        "Tags": [
+          {"Key": "env", "Value": "production"},
+          {"Key": "owner", "Value": "platform-team"}
+        ]
+      }
+    ]
   }' \
   --ClusterCIDRSettings '{
     "ClusterCIDR": "172.16.0.0/16",
@@ -158,6 +227,16 @@ req.ClusterBasicSettings = models.ClusterBasicSettings()
 req.ClusterBasicSettings.ClusterName = "my-tke-cluster"
 req.ClusterBasicSettings.ClusterVersion = "1.28.3"
 req.ClusterBasicSettings.VpcId = "vpc-xxxxxxxx"
+tag_spec = models.TagSpecification()
+tag_spec.ResourceType = "cluster"
+env_tag = models.Tag()
+env_tag.Key = "env"
+env_tag.Value = "production"
+owner_tag = models.Tag()
+owner_tag.Key = "owner"
+owner_tag.Value = "platform-team"
+tag_spec.Tags = [env_tag, owner_tag]
+req.ClusterBasicSettings.TagSpecification = [tag_spec]
 req.ClusterBasicSettings.ClusterLevel = "L5"
 req.ClusterBasicSettings.AutoUpgradeClusterLevel = models.AutoUpgradeClusterLevel()
 req.ClusterBasicSettings.AutoUpgradeClusterLevel.IsAutoUpgrade = True
@@ -197,6 +276,15 @@ func main() {
 		ClusterName:    common.StringPtr("my-tke-cluster"),
 		ClusterVersion: common.StringPtr("1.28.3"),
 		VpcId:          common.StringPtr("vpc-xxxxxxxx"),
+		TagSpecification: []*tke.TagSpecification{
+			{
+				ResourceType: common.StringPtr("cluster"),
+				Tags: []*tke.Tag{
+					{Key: common.StringPtr("env"), Value: common.StringPtr("production")},
+					{Key: common.StringPtr("owner"), Value: common.StringPtr("platform-team")},
+				},
+			},
+		},
 		ClusterLevel:   common.StringPtr("L5"),
 		AutoUpgradeClusterLevel: &tke.AutoUpgradeClusterLevel{
 			IsAutoUpgrade: common.BoolPtr(true),
@@ -382,6 +470,31 @@ CoreDNS is running at https://cls-xxxxxxxx.ccs.tencent-cloud.com/api/v1/namespac
 
 `AutoUpgradeClusterLevel` 是对象类型,不是布尔值；当前 CreateCluster API 示例使用 `{"IsAutoUpgrade": true}`。
 
+### 配置集群标签
+
+创建集群时可以通过 `ClusterBasicSettings.TagSpecification` 同步绑定标签到集群实例:
+
+```json
+{
+  "ClusterBasicSettings": {
+    "ClusterName": "prod-payment-gz",
+    "TagSpecification": [
+      {
+        "ResourceType": "cluster",
+        "Tags": [
+          {"Key": "env", "Value": "production"},
+          {"Key": "project", "Value": "payment"},
+          {"Key": "cost-center", "Value": "cc-1001"}
+        ]
+      }
+    ]
+  }
+}
+```
+
+!!! note "标签说明"
+    `ResourceType` 创建集群时使用 `cluster`。标签用于资源检索、权限治理和成本分摊,建议在创建时一次性写入基础标签,避免后续补录遗漏。
+
 ### 配置集群删除保护
 
 创建后通过 API 启用:
@@ -408,6 +521,7 @@ tccli tke EnableClusterDeletionProtection \
 - 容器网络 CIDR: 172.16.0.0/16
 - Service CIDR: 10.96.0.0/24
 - 集群规模: L5
+- 集群标签: env=production, owner=platform-team, cost-center=cc-1001
 ```
 
 ### 带节点创建 Prompt
@@ -437,7 +551,11 @@ tccli tke EnableClusterDeletionProtection \
    - L20: 6-20 节点,适合小型生产
    - L50: 21-50 节点,适合中型生产
 4. **启用删除保护**: 生产集群建议启用删除保护
-5. **版本选择**: 选择稳定版本,避免使用最新版本
+5. **标签策略**:
+   - 创建时添加 `env`、`owner`、`project`、`cost-center` 等基础标签
+   - 标签键和值保持稳定,避免同一含义出现 `team`、`owner`、`department` 等多套命名
+   - 结合 CAM、账单和资源检索需求提前约定标签规范
+6. **版本选择**: 选择稳定版本,避免使用最新版本
 
 ---
 

src/content/docs/basics/index.md

@@ -11,9 +11,8 @@ title: "基础操作"
 通过本模块的学习，你将掌握：
 
 - [x] 创建和管理 TKE 集群
-- [x] 配置和管理节点与节点池
-- [x] 部署和管理工作负载（Deployment）
-- [x] 创建和配置服务（Service）
+- [x] 配置和管理普通节点、标准节点池、原生节点和超级节点
+- [x] 连接集群并使用 kubectl 操作 Kubernetes 对象
 - [x] 查看集群和资源的监控信息
 
 ## 模块结构
@@ -29,57 +28,78 @@ title: "基础操作"
 | [删除集群](cluster/02-delete-cluster.md) | 安全删除集群 | 15 分钟 |
 | [查询集群](cluster/04-describe-clusters.md) | 获取集群详细信息 | 15 分钟 |
 
-### 🖥️ 节点管理
-管理集群中的工作节点，支持手动添加节点和节点池两种方式。
+### 🖥️ 普通节点管理
+管理集群中的单个 CVM 工作节点，适用于存量 CVM 加入、少量节点调整和节点维护。
 
 | 章节 | 内容 | 时间 |
 |------|------|------|
 | [添加节点](node/01-add-node.md) | 向集群添加节点 | 25 分钟 |
 | [删除节点](node/02-delete-node.md) | 从集群移除节点 | 20 分钟 |
+| [维护节点](node/03-maintain-node.md) | cordon、drain、uncordon 和排障 | 20 分钟 |
 | [查询节点](node/04-describe-nodes.md) | 获取节点详细信息 | 15 分钟 |
 
-### 📦 节点池管理
-使用节点池统一管理一组具有相同配置的节点，支持自动伸缩和批量操作。
+### 📦 标准节点池管理
+使用标准节点池统一管理一组普通 CVM 节点，支持自动伸缩、统一标签、污点和批量操作。
 
 | 章节 | 内容 | 时间 |
 |------|------|------|
 | [创建节点池](node-pool/01-create-node-pool.md) | 创建节点池配置 | 30 分钟 |
 | [扩缩节点池](node-pool/02-scale-node-pool.md) | 调整节点池规模 | 20 分钟 |
+| [查询节点池](node-pool/03-describe-node-pool.md) | 查询节点池列表和详情 | 15 分钟 |
+| [删除节点池](node-pool/04-delete-node-pool.md) | 安全删除节点池 | 20 分钟 |
 
-### 🚀 工作负载管理
-部署和管理应用工作负载，以 Deployment 为例演示无状态应用的部署。
+### 🧩 原生节点管理
+使用 TKE 原生节点能力，以 `MachineSet` / `Machine` 声明式管理节点，适合高利用率和精细化运维场景。
 
 | 章节 | 内容 | 时间 |
 |------|------|------|
-| [创建 Deployment](workload/01-create-deployment.md) | 部署无状态应用 | 30 分钟 |
-| [更新 Deployment](workload/02-update-deployment.md) | 应用滚动更新 | 25 分钟 |
-| [删除 Deployment](workload/03-delete-deployment.md) | 清理应用资源 | 15 分钟 |
+| [创建原生节点池](native-node/01-create-native-node-pool.md) | 使用 MachineSet 创建原生节点池 | 30 分钟 |
+| [扩缩原生节点池](native-node/02-scale-native-node-pool.md) | 调整原生节点池副本和伸缩范围 | 20 分钟 |
+| [管理原生节点](native-node/03-manage-native-node.md) | 查询、维护和删除 Machine | 20 分钟 |
 
-### 🌐 服务管理
-配置服务（Service）以实现应用的网络访问和负载均衡。
+### ⚡ 超级节点管理
+使用超级节点池承载 Serverless 容器工作负载，适合秒级弹性、按需资源和免节点运维场景。
 
 | 章节 | 内容 | 时间 |
 |------|------|------|
-| [创建 Service](service/01-create-service.md) | 暴露应用服务 | 25 分钟 |
+| [创建超级节点池](supernode/01-create-supernode-pool.md) | 创建虚拟节点池 | 25 分钟 |
+| [创建按量超级节点](supernode/02-create-supernode.md) | 添加按量虚拟节点 | 20 分钟 |
+| [删除超级节点](supernode/03-delete-supernode.md) | 清理虚拟节点资源 | 15 分钟 |
+
+### 🚀 Kubernetes 对象操作
+连接 TKE 集群，并使用 `kubectl` 管理 Deployment、Service、ConfigMap、Secret、Ingress、Job 等 Kubernetes 对象。
+
+| 章节 | 内容 | 时间 |
+|------|------|------|
+| [连接集群](kubernetes/01-connect-cluster.md) | 获取 kubeconfig 并验证 kubectl 访问 | 20 分钟 |
+| [常用 kubectl 命令操作](kubernetes/02-kubectl-common-operations.md) | 查看、部署、更新、删除和排障 Kubernetes 对象 | 35 分钟 |
 
 ## 学习路径
 
 ### 🎯 快速入门路径（新手推荐）
 
 适合首次接触 TKE 的用户，按以下顺序完成基础操作：
 
-1. **创建集群** → 2. **创建节点池** → 3. **创建 Deployment** → 4. **创建 Service**
+1. **创建集群** → 2. **创建标准节点池** → 3. **连接集群** → 4. **使用 kubectl 部署对象**
 
 完成时间：约 **2 小时**
 
 ### 🏃 进阶实践路径
 
 适合有 Kubernetes 基础的用户，深入了解 TKE 特性：
 
-1. **查询集群详情** → 2. **手动添加节点** → 3. **节点池扩缩容** → 4. **Deployment 更新** → 5. **清理资源**
+1. **查询集群详情** → 2. **手动添加节点** → 3. **节点维护** → 4. **节点池扩缩容** → 5. **kubectl 排障** → 6. **清理资源**
 
 完成时间：约 **1.5 小时**
 
+### 🧠 节点能力选型路径
+
+适合需要理解 TKE 节点产品形态的用户：
+
+1. **普通节点管理** → 2. **标准节点池管理** → 3. **原生节点管理** → 4. **超级节点管理**
+
+完成后你将能判断不同工作负载应该使用普通节点池、原生节点还是超级节点。
+
 ## 前置准备
 
 开始学习前，请确保已准备：
@@ -126,8 +146,8 @@ title: "基础操作"
 
 本模块的每篇文档都包含：
 
-- ✅ **完整的 API 调用示例**：可直接复制执行的 JSON 请求
-- ✅ **CLI 命令参考**：tccli 和 kubectl 命令示例
+- ✅ **云资源 API 示例**：集群、节点和节点池使用 tccli/API 示例
+- ✅ **Kubernetes 对象操作**：使用 kubectl 管理集群内对象
 - ✅ **验证步骤**：确认操作成功的检查方法
 - ✅ **常见问题排查**：典型错误和解决方案
 - ✅ **测试报告**：功能测试验证结果
@@ -137,12 +157,13 @@ title: "基础操作"
 !!! warning "重要提示"
     - 创建集群和节点会产生费用，请关注资源成本
     - 删除集群前请备份重要数据
-    - 生产环境建议使用节点池而非手动管理节点
+    - 生产环境建议使用标准节点池、原生节点池或超级节点池，而非长期手动管理单个节点
     - 所有操作都需要相应的 API 权限
 
 !!! tip "最佳实践"
     - 为不同环境（开发/测试/生产）创建独立集群
     - 使用节点池标签实现节点分组管理
+    - 明确区分 Kubernetes 节点标签和腾讯云资源标签
     - 为生产应用配置健康检查和资源限制
     - 定期检查集群和节点的监控指标