第 2 章 · 集群接入：导入 kubeconfig 与登录
场景说明
你在第 1 章装好了小紫云计算。现在有两种常见情况：
- 同事已经搭好一套测试集群，发来一个
kubeconfig文件，请你「帮忙看看 Pod 为什么 Crash」； - 你即将用第 3 章向导部署 k3s，部署完成后工具会生成 kubeconfig，需要登记到客户端里。
无论哪种，都必须先完成 集群接入：把集群登记进列表，并设为 当前已连接集群。否则 应用部署、系统容器、运维 等页面会一直提示「请先登录集群」——这是刻意的 集群门禁，防止误操作未选定的环境。
学完你能
| 能力 | 说明 |
|---|---|
| 导入 kubeconfig | 从文件登记集群并首次连接 |
| 切换工作集群 | 在测试 / 预发 / 生产等多套环境间安全切换 |
| 导出备份 | 把已登记配置导出给同事或第二台电脑 |
| 排查连接失败 | 证书、网络、权限三类常见问题 |
2.1 两种接入方式
| 方式 | 适用场景 |
|---|---|
| 导入 kubeconfig | 云上集群、他人搭建的集群、本工具历史部署导出的配置 |
| 集群登录 | 已在「导入」列表中登记，切换当前工作集群 |
入口：左侧 集群接入 → 导入 kubeconfig / 集群登录。
2.2 导入 kubeconfig — 逐步跟练
准备：一个有效的 kubeconfig 文件（扩展名 .yaml / .yml / .conf 均可）。若无文件，可先跳到第 3 章部署单节点 k3s，完成后再回到本节。
| 步骤 | 操作 | 说明 |
|---|---|---|
| 1 | 打开 集群接入 → 导入 kubeconfig | 进入导入表单与已登记列表 |
| 2 | 填写 集群显示名称 | 自定，建议带环境后缀，如 测试-k3s、生产-华北 |
| 3 | 选择 集群模式 | 单节点 / 多节点 / 高可用，与真实架构一致即可（影响部分展示与巡检文案） |
| 4 | 点击 选择文件 | 选中 kubeconfig |
| 5 | 点击 导入并连接 | 等待连接结果 |
你应该看到什么
- 成功：提示「已导入并连接」或类似成功文案
- 下方 已登记列表 出现一行：名称、模式、导入时间
- 窗口 顶部状态栏 显示刚连接的集群名
- 打开 运维 → 集群监控 或 管理 → 节点管理，应能加载节点列表（可能为空或 NotReady，属集群自身状态）
技巧
- 测试与生产 务必分开导入，名称一眼可区分
- 同一 kubeconfig 不要重复导入成多个名称，以免切换时搞混
2.3 集群登录与切换 — 逐步跟练
适用于：已导入过多个集群，今天要操作其中一套。
- 打开 集群接入 → 集群登录
- 在列表中选择目标集群
- 点击 连接（或「切换」）
你应该看到什么
- 顶部状态栏集群名变为所选环境
- 之前打开的 应用部署 等标签页会 重新加载 该集群数据（切换前未保存的操作可能丢失，切换前确认无进行中的部署）
多标签页习惯
- 顶部 工作区标签页 可同时开「应用部署 + 集群监控」
- 切换集群前看一眼状态栏：当前操作的是哪套环境
- 生产环境操作建议单独开一个客户端窗口或固定标签页命名（如浏览器书签式习惯）