K8S 集群部署技能

使用 kubeadm 部署生产级 Kubernetes 集群。

Workflow Overview

用户发起部署、交付请求 → 展示流程概览 → 用户确认 → 信息收集 → 架构设计 → 技术方案（部署、测试） → 部署计划 → 执行工具 → 验证测试 → 交付报告 → 复盘总结

流程概览

例如，当用户说我想部署（搭建、交付）一套新的 K8S 集群时，先展现以下流程和约束让用户确认：

⚠️ 重要提示

部署新的 K8S 集群，意味着需要更高权限（root），同时机器上的数据会被清理，请确保你提供的机器列表是正确的。

部署流程

当前版本约束

用户确认

展示流程后，询问用户：

以上是部署流程概览，是否符合您的预期？如果可以，我们开始第一阶段：信息收集。

Step 0: 信息收集

获取以下信息后开始架构设计：

必需信息：

1. 1. 节点 IP-主机名映射表（支持多种格式）：

10.0.2.11 k8s-node1
10.0.2.12 k8s-node2
10.0.2.13 k8s-node3

- CSV 文件：10.0.2.11,k8s-node1
- 表格形式：直接粘贴表格
- AI 会自动解析并转换成 JSON 格式

1. 2. SSH 访问方式（二选一）：

1. 3. K8S 版本：官方最新版
2. 软件包和镜像获取方式：

约束边界（当前版本不支持）：

• - 持久化存储
• GPU 节点

示例用户输入：

有 3 台虚拟机：

• - 10.0.2.7 (Control Plane)
• 10.0.2.8 (Worker)
• 10.0.2.9 (Worker)

Step 1: 环境勘察

根据用户提供的信息，进行环境勘察
主要检查点：
SSH 登录验证
主机名
账户权限是否满足
资源是否符合信息
K8S部署前置检查

勘察报告用途
1，返回给用户确认
2，收集的信息用来做架构、部署方案的设计

Step 2: 架构设计

生成架构设计文档，包含：

1. 1. 集群拓扑：节点角色、IP 分配、网络规划
2. 组件版本：K8S、containerd、CNI 插件版本
3. 资源规划：节点资源分配、Pod 网段、Service 网段
4. 镜像源配置：国内环境镜像加速方案

使用 best-practice/best-practices.md 生成文档，生成文件保存在 report/ 目录中。

生成详细部署技术方案，包含：

1. 1. 检查并修复系统配置
2. 检查并安装 containerd
3. 检查并安装 K8S 组件
4. 初始化 K8S 控制面
5. 安装 CNI 插件
6. 加入节点

使用 best-practice/best-practices.md 生成文档，生成文档保存在 report/ 目录中。

生成详细验证测试方案，包含：

1. 1. 检查集群状态：节点标签、系统 Pod、CNI 插件；如果是 HA 验证 etcd 同步等
2. 测试应用部署：nginx、busybox
3. 测试网络状态：DNS 解析、Service 功能、应用部署访问等
4. 测试存储：emptyDir；目前不支持 PVC

使用 best-practice/best-practices.md 生成文档，生成文档保存在 report/ 目录中。

Step 3: 部署计划

生成部署计划文档，包含：

1. 1. 部署里程碑：各阶段目标
2. 依赖检查清单：系统要求、网络要求、资源要求
3. 风险评估：可能的问题和应对方案
4. 回滚方案：失败时的清理和重置步骤

使用 best-practice/deploy-plan.md 生成文档，生成文档保存在 report/ 目录中。

Step 4: 部署执行

用户确认

交互规则（重要）

强制要求

• - ✅ 每个里程碑开始前通知
• ✅ 每个里程碑结束后汇报
• ✅ 等待用户确认后再继续

通知格式：

==========================================
🚀 开始执行 M0 - 环境检测
==========================================
正在检测 3 个节点的环境...

• - SSH 连接：✅
• 系统版本：Ubuntu 24.04
• 资源配置：2核4G

==========================================
✅ M0 完成 - 环境检测通过
==========================================
下一步：M1 - 系统配置
回复 y 继续，或 n 暂停

问题处理规则（重要）：
遇到问题时，不要直接陷入解决方案，先给用户提供 2-3 个方案让用户选择：

❌ 错误做法：
问题：DNS 解析失败
直接执行：配置 DNS 服务器...

✅ 正确做法：
==========================================
❌ M3 遇到问题 - DNS 解析失败
==========================================
错误：curl: (6) Could not resolve host: pkgs.k8s.io

可能的原因：

1. 1. DNS 服务器未配置
2. 网络隔离（无法访问外网）
3. 防火墙限制

解决方案：
A. 配置 DNS 服务器（推荐）
- 配置 8.8.8.8 或 114.114.114.114
- 预计耗时：1-2 分钟

B. 使用离线安装包
- 需要提前下载 K8S 安装包
- 适合内网环境

C. 跳过此步骤，稍后手动安装
- 你可以自己配置网络后继续

请选择：A / B / C

禁止行为：

• - ❌ 不通知直接执行下一个里程碑
• ❌ 一股脑跑完全部流程
• ❌ 只在最后汇报结果
• ❌ 遇到问题直接陷入解决方案

里程碑