TKE Skill 使用场景指南¶

1. 查询所有可用集群，了解集群全貌
   - 列出集群名称、版本、节点数、状态
   - 识别出运行中的集群

2. 根据集群名称或标签找到目标集群
   - 假设团队使用的集群名包含 "test" 或 "dev"

3. 检查目标集群的健康状态
   - 集群状态是否为 Running
   - 节点是否全部就绪

4. 检查集群的访问端点
   - 是否已开启外网访问（远程办公需要）
   - 如未开启，提示需要申请开通

5. 获取 kubeconfig
   - 获取外网 kubeconfig
   - 验证 kubeconfig 格式正确

6. 输出接入指南
   - kubeconfig 保存路径建议
   - kubectl 测试命令

================================================================================
🎯 TKE 集群接入向导
================================================================================

📋 可用集群列表:
┌────────────────┬──────────────────┬─────────┬────────┬───────┐
│ 集群 ID        │ 名称             │ 版本    │ 节点数 │ 状态  │
├────────────────┼──────────────────┼─────────┼────────┼───────┤
│ cls-xxxxxxxx   │ dev-cluster      │ 1.30.0  │ 2      │ ✅ 运行中 │
│ cls-yyyyyyyy   │ production       │ 1.28.0  │ 10     │ ✅ 运行中 │
└────────────────┴──────────────────┴─────────┴────────┴───────┘

🎯 目标集群: dev-cluster (cls-xxxxxxxx)

🏥 健康检查:
  ✅ 集群状态: Running
  ✅ 节点状态: 2/2 运行中
  ✅ 外网访问: 已开启

🔑 获取访问凭证:
  ✅ kubeconfig 已获取

📝 接入指南:
  1. 保存 kubeconfig:
     export KUBECONFIG=/tmp/tke-kubeconfig

  2. 测试连接:
     kubectl cluster-info
     kubectl get nodes

  3. 查看命名空间:
     kubectl get namespaces

================================================================================

1. 获取所有集群列表

2. 对每个集群进行健康检查:
   a. 集群状态检查
      - Running: 正常
      - Creating/Upgrading: 警告（进行中）
      - Abnormal: 严重告警

   b. 节点健康检查
      - 统计 running/initializing/failed 节点数
      - 计算健康率 = running / total
      - 健康率 < 100%: 警告
      - 健康率 < 80%: 严重告警

   c. 端点可用性检查
      - 检查内网/外网端点状态
      - 未开启: 信息提示
      - Creating: 警告
      - Created: 正常

3. 汇总巡检结果
   - 统计正常/警告/严重告警数量
   - 列出所有异常项
   - 给出处理建议

4. 生成巡检报告

================================================================================
📊 TKE 集群巡检报告
================================================================================
巡检时间: 2026-03-17 17:30:00
巡检范围: ap-guangzhou 地域所有集群

📈 巡检汇总:
┌──────────┬───────┐
│ 级别     │ 数量  │
├──────────┼───────┤
│ ✅ 正常  │ 2     │
│ ⚠️ 警告  │ 0     │
│ ❌ 严重  │ 0     │
└──────────┴───────┘

📋 详细检查结果:

【集群 1】dev-cluster (cls-xxxxxxxx)
├── 集群状态: ✅ Running
├── K8s 版本: 1.30.0
├── 节点健康: ✅ 2/2 (100%)
│   ├── 10.0.1.10 - running
│   └── 10.0.1.11 - running
├── 内网端点: ℹ️ 未开启
└── 外网端点: ✅ 已开启 (xx.xx.xx.xx:443)

================================================================================
📝 巡检结论: 所有集群运行正常，无需处理
================================================================================

1. 盘点 VPC 资源
   - 列出所有 VPC
   - 统计每个 VPC 的子网数量和可用 IP
   - 识别适合部署的 VPC（非默认、IP 充足）

2. 分析子网分布
   - 按可用区统计子网
   - 计算每个可用区的可用 IP 总量
   - 识别 IP 资源紧张的子网

3. 检查安全组配置
   - 列出可用安全组
   - 识别适合 TKE 的安全组（名称包含 tke/k8s/container）

4. 分析可用区状态
   - 哪些可用区可用
   - 推荐的可用区（基于子网 IP 充足度）

5. 获取 K8s 版本信息
   - 可选版本列表
   - 推荐版本（最新稳定版）

6. 生成规划建议
   - 推荐的 VPC
   - 推荐的子网和可用区
   - 推荐的 K8s 版本
   - 预估可支撑的节点规模

================================================================================
📐 TKE 集群环境规划报告
================================================================================

📦 VPC 资源盘点:
┌────────────────┬──────────┬────────────────┬──────────┬───────────┐
│ VPC ID         │ 名称     │ CIDR           │ 子网数   │ 可用 IP   │
├────────────────┼──────────┼────────────────┼──────────┼───────────┤
│ vpc-xxxxxxxx   │ dev      │ 10.0.0.0/16    │ 3        │ 12,500    │
│ vpc-yyyyyyyy   │ prod     │ 172.16.0.0/16  │ 5        │ 8,200     │
└────────────────┴──────────┴────────────────┴──────────┴───────────┘

📍 可用区资源分布:
┌─────────────────┬──────────┬───────────┬─────────────┐
│ 可用区          │ 子网数   │ 可用 IP   │ 推荐度      │
├─────────────────┼──────────┼───────────┼─────────────┤
│ ap-guangzhou-3  │ 2        │ 8,000     │ ⭐⭐⭐ 推荐 │
│ ap-guangzhou-6  │ 2        │ 6,500     │ ⭐⭐ 良好   │
│ ap-guangzhou-7  │ 2        │ 6,200     │ ⭐⭐ 良好   │
└─────────────────┴──────────┴───────────┴─────────────┘

🔐 安全组:
  推荐使用: sg-xxxxxxxx (tke-default-sg)

📦 K8s 版本:
┌─────────┬────────────┐
│ 版本    │ 推荐度     │
├─────────┼────────────┤
│ 1.30.0  │ ⭐ 稳定版  │
│ 1.32.2  │ ⭐ 新版本  │
│ 1.34.1  │ 最新版     │
└─────────┴────────────┘

💡 规划建议:
┌─────────────┬──────────────────────────────────────────┐
│ 配置项      │ 推荐值                                   │
├─────────────┼──────────────────────────────────────────┤
│ VPC         │ vpc-xxxxxxxx (dev) - IP 资源充足        │
│ 子网        │ subnet-xxxxxxxx (ap-guangzhou-3)        │
│ 可用区      │ ap-guangzhou-3                          │
│ 安全组      │ sg-xxxxxxxx                             │
│ K8s 版本    │ 1.30.0 (稳定版)                         │
│ 预估容量    │ 可支撑约 200 个节点                      │
└─────────────┴──────────────────────────────────────────┘

================================================================================

1. 验证集群存在且运行中
   - 查询集群状态
   - 如果不存在：提示集群 ID 错误
   - 如果非 Running：提示集群状态异常

2. 检查节点健康状况
   - 如果没有健康节点：可能影响 API Server

3. 检查访问端点
   - 内网端点状态
   - 外网端点状态
   - 根据用户网络环境判断应该使用哪个端点

4. 获取并验证 kubeconfig
   - 检查 server 地址是否与端点匹配
   - 检查证书是否存在

5. 生成诊断报告
   - 问题定位
   - 解决建议

================================================================================
🔍 TKE 集群访问故障诊断
================================================================================
目标集群: cls-xxxxxxxx

📋 诊断检查项:

1️⃣ 集群状态检查
   ✅ 集群存在
   ✅ 状态: Running
   ✅ 版本: 1.30.0

2️⃣ 节点健康检查
   ✅ 节点总数: 2
   ✅ 健康节点: 2
   ✅ API Server 应该可用

3️⃣ 访问端点检查
   ├── 内网端点: ❌ 未开启
   └── 外网端点: ✅ 已开启
       地址: xx.xx.xx.xx:443

4️⃣ Kubeconfig 检查
   ✅ 成功获取 kubeconfig
   ✅ Server 地址: https://xx.xx.xx.xx:443
   ✅ 证书配置存在

================================================================================
📊 诊断结果: 集群访问配置正常
================================================================================

💡 如果仍无法连接，请检查:
   1. 本地网络是否能访问外网 IP xx.xx.xx.xx
   2. 防火墙是否放行 443 端口
   3. kubeconfig 文件路径是否正确设置

   测试命令:
   $ telnet xx.xx.xx.xx 443
   $ kubectl --kubeconfig=/path/to/config cluster-info

================================================================================

1. 获取所有集群信息
   - 基本配置（版本、类型、运行时）
   - 节点数量和规格
   - 网络配置

2. 生成对比矩阵
   - 版本对比
   - 节点规模对比
   - 网络配置对比

3. 识别差异和问题
   - 版本不一致
   - 配置不一致
   - 资源使用不均衡

4. 给出优化建议
   - 版本升级建议
   - 资源调整建议

1. 获取集群当前配置
   - 所在 VPC、子网、可用区
   - 当前节点数量

2. 检查子网 IP 余量
   - 获取子网可用 IP 数
   - 计算扩容所需 IP（节点数 + Pod 预留）
   - 判断是否充足

3. 检查可用区状态
   - 目标可用区是否可用

4. 检查安全组
   - 安全组是否存在
   - 是否有必要的规则（TKE 需要的端口）

5. 生成扩容检查报告
   - 资源是否充足
   - 风险评估
   - 扩容建议

1. 检查 TCR 实例
   - 列出所有 TCR 实例
   - 检查实例状态
   - 获取实例域名

2. 检查命名空间
   - 列出实例下的命名空间
   - 检查是否有项目对应的命名空间

3. 生成集成指南
   - Docker 登录命令
   - 镜像推送示例
   - K8s ImagePullSecret 配置

1. 解析用户权限需求
   - 租户名称（如 team-frontend）
   - 目标命名空间（如 frontend, frontend-staging）
   - 权限级别（readonly/developer/admin/custom）

2. 创建 RBAC 资源
   - ServiceAccount: tke-tenant-{租户名}
   - Role: 基于权限级别模板
   - RoleBinding: 绑定 SA 和 Role

3. 获取租户 Token
   - 使用 kubectl create token
   - 支持设置过期时间

4. 生成一键安装 Prompt
   - 包含 kubeconfig 配置
   - 包含 Token
   - 包含使用说明
   - 可直接发给租户执行

5. 输出安装指南
   - 租户粘贴 Prompt 到自己的 Agent
   - 自动完成配置
   - 开始使用自然语言操作 K8s

管理员：帮我创建一个账号 team-frontend，权限级别 developer，可以访问 frontend 命名空间

Agent：
正在创建租户 RBAC 资源...

✅ 已创建以下资源：
┌─────────────────────────────────────────────────────────────────┐
│ ServiceAccount: tke-tenant-team-frontend                        │
│ Namespace: frontend                                             │
├─────────────────────────────────────────────────────────────────┤
│ Role: tke-tenant-team-frontend-role                             │
│ 权限级别: developer                                              │
│ 权限:                                                           │
│   - pods: get, list, watch, create, update, patch, delete       │
│   - deployments: get, list, watch, create, update, patch, delete│
│   - services: get, list, watch, create, update, patch, delete   │
│   - configmaps/secrets: get, list, watch, create, update, patch │
├─────────────────────────────────────────────────────────────────┤
│ RoleBinding: tke-tenant-team-frontend-binding                   │
│ 绑定命名空间: frontend                                           │
└─────────────────────────────────────────────────────────────────┘

需要我生成该租户的安装 Prompt 吗？

管理员：帮我生成 team-frontend 的安装 Prompt

Agent：
📋 已生成安装 Prompt，请将以下内容发送给 team-frontend 团队成员：

---
# TKE Skill 一键安装 Prompt
# 租户: team-frontend | 命名空间: frontend | 集群: my-tke-cluster

## 步骤 1：保存 kubeconfig
将以下内容保存到 ~/.kube/tke-tenant-team-frontend.config：

```yaml
apiVersion: v1
kind: Config
clusters:
- cluster:
    certificate-authority-data: LS0tLS1...
    server: https://xx.xx.xx.xx:443
  name: my-tke-cluster
contexts:
- context:
    cluster: my-tke-cluster
    namespace: frontend
    user: tke-tenant-team-frontend
  name: tke-tenant-team-frontend@my-tke-cluster
current-context: tke-tenant-team-frontend@my-tke-cluster
users:
- name: tke-tenant-team-frontend
  user:
    token: eyJhbGciOiJSUzI1...

**租户使用 Agent：**

### 核心价值

| 传统方式 | TKE Skill 多租户管理 |
|---------|---------------------|
| 手写 RBAC YAML | **一句话描述权限** |
| 手动分发 kubeconfig | **生成一键安装 Prompt** |
| 培训租户使用 kubectl | **租户直接用自然语言操作** |
| 权限变更需要重新配置 | **修改 RBAC 后重新生成 Prompt** |

---

## 场景 9: 一句话部署应用（✅ 已验证）

### 场景描述

**作为** 一名开发工程师  
**我想要** 用自然语言将应用部署到 TKE 集群  
**以便于** 无需手写 YAML 就能完成应用上线

### 业务背景

开发者用 AI 写完代码后，想部署到 K8s，却面临：

1. 需要学习 Dockerfile 编写
2. 需要理解 Deployment、Service、ConfigMap 等概念
3. 需要配置资源限制、健康检查等最佳实践
4. 需要处理镜像构建、推送等流程

### AI 执行步骤

### 实际验证结果

| 应用 | 类型 | 部署结果 | 访问地址 |
|------|------|----------|----------|
| 应用1 | 静态页面（"你好，猴哥"） | ✅ 成功 | http://119.91.184.206 |
| 应用2 | 复杂应用（需打包镜像） | ✅ 成功 | http://119.91.188.55 |

---

## 场景 10: 智能运维排障（✅ 已验证）

### 场景描述

**作为** 一名开发工程师或 SRE  
**我想要** 让 AI 帮我排查 K8s 应用故障  
**以便于** 快速定位问题原因并恢复服务

### 业务背景

应用部署或运行时出现问题，传统排障流程：

1. 登录控制台查看 Pod 状态
2. 查看 Events 找线索
3. 查看容器日志
4. 搜索文档/Google
5. 不行就找 SRE...

### AI 执行步骤