第 3 章 · 三阶段部署：k3s 与 kubeadm
场景说明
第 2 章假设你「已有 kubeconfig」。本章面向 从零建集群：公司刚采购一台 Linux 云主机（或内网虚拟机），要在上面跑 Kubernetes，但不想手写 kubeadm 脚本。
小紫云计算提供三条图形向导：
- 单节点 k3s — 最快，适合 PoC 与本章跟练；
- 多节点 kubeadm — 1 Master + N Worker；
- 高可用 kubeadm — 3 Master + VIP。
本章以 单节点 k3s 为主跟练；多节点 / 高可用只讲差异点，避免一次堆太多机器。
学完你能
| 能力 | 说明 |
|---|---|
| 选对部署路径 | k3s 验证 vs kubeadm 生产 |
| 完成 SSH 与离线包配置 | 内网无外网也能装 |
| 读部署日志排错 | SSH、镜像、join 三类失败 |
| 部署后首检 | 登录、巡检、metrics-server |
3.1 部署入口
左侧 部署 子菜单：
| 菜单项 | 引擎 | 典型用途 |
|---|---|---|
| 单节点（k3s） | k3s | PoC、开发验证、资源紧张的单机环境 |
| 多节点（kubeadm） | kubeadm | 1 Master + N Worker，生产扩展 |
| 高可用（kubeadm） | kubeadm | 3 Master + VIP + Worker，控制面高可用 |
首页卡片也可直接进入对应向导。
3.2 单节点（k3s）— 逐步跟练
前置：一台 Linux 节点，本机小紫云计算能 SSH 通（用户名 / 密码或密钥）。
入口：部署 → 单节点（k3s）
| 配置区 | 填写要点 |
|---|---|
| SSH 连接 | IP、端口（默认 22）、用户名、密码或私钥 |
| 安装方式 | 有外网选在线；内网选 本地上传 安装包 |
| 数据目录 | k3s 数据路径，建议大容量磁盘挂载点 |
| 调优选项 | 按向导默认即可，勿随意改 kubeconfig 路径 |
| 部署日志 | 可指定日志文件路径，失败时留存 |
跟练步骤
- 点击 测试连接 → 应提示 SSH 成功
- 点击 开始部署
- 打开 部署日志 抽屉，观察滚动输出
- 完成后按页面提示 导入 kubeconfig 或跳转 集群登录
你应该看到什么
- 日志中出现 k3s 安装、服务启动、kubeconfig 生成等字样
- 结束时有成功提示，无持续报错退出
- 集群登录 后 管理 → 节点管理 显示 1 个节点 Ready
- 运维 → 集群监控 可打开（指标可能提示需装 metrics-server，属下一步）
内网离线补充
- 提前准备：k3s 二进制、离线镜像包、安装脚本（向导会说明所需文件）
- 选 本地上传 逐项上传，再开始部署
3.3 多节点（kubeadm）要点
入口：部署 → 多节点（kubeadm）
| 角色 | 说明 |
|---|---|
| Master | 控制面，填 SSH 与主机名 |
| Worker | 可添加多台，每台独立 SSH |
| 镜像与安装包 | 在线或本地上传 |
| 网络插件 | 向导内选 CNI（如 Flannel），勿安装中途改 kubeconfig 路径 |
你应该看到什么
- 日志汇总各 Worker join 是否成功
- 节点列表：1 Master + N Worker 均为 Ready
- 可导入 / 使用的 kubeconfig 指向 Master API
Worker 未加入时：在日志中搜索 join，复制命令到对应 Worker SSH 手动执行，再回到节点管理刷新。