K8sQuest 教程：先把 kubeconfig 边界守住，再开始闯关

K8sQuest 把 Kubernetes 排障做成 5 个世界、50 个任务。它不是网页模拟器：任务真正落在本机 kind 集群里，玩家在第二个终端用 kubectl 修复 Pod、Deployment、Service、网络和存储问题。

1. 游戏引擎和集群怎样配合

install.sh 创建 Python 虚拟环境、安装 requirements.txt、建立名为 k8squest 的 kind 集群，并切换到 kind-k8squest context。engine 负责布置任务、检查状态和记录进度，worlds 保存各关内容。

游戏终端提供 check、hint、solution、validate、skip、reset 和 quit。实际修复仍由你在另一个终端执行 kubectl，因而能练到对象状态、日志和事件的真实排查顺序。

2. 安装前先检查这六项

docker info
kind version
kubectl version --client
python3 --version   # 需要 3.9+
jq --version
bash --version

Linux 与 macOS 可按官方路径运行脚本；Windows 要使用 Git Bash，并先启动采用 WSL2 后端的 Docker Desktop。PowerShell 和 CMD 不是 README 给出的支持入口。

git clone https://github.com/Manoj-engineer/k8squest.git
cd k8squest
git rev-parse HEAD
sed -n '1,220p' install.sh
./install.sh
kubectl config current-context
./play.sh

最后一条检查应返回 kind-k8squest。如果不是，先停止，不要继续执行关卡命令。

3. RBAC 有边界，也有盲区

官方 RBAC 为 k8squest-player 创建 namespace Role。它允许在 k8squest 内操作 Pod、Secret、Service、Deployment、Job 和网络策略等对象；节点、命名空间等集群资源主要是只读。这个设计能减少误伤，却不等于沙箱。

安装脚本仍然连接 Docker daemon、下载 Python 包与 kind 镜像，还会修改当前 kubeconfig context。机器上若同时保存生产集群凭据，建议改用专用本机账户或可丢弃虚拟机，并在每次练习前检查 context。

4. 卡关、重置与清理

先用 check 看实时资源，再逐级打开 hint；需要重新开始时用游戏内 reset，或运行 python3 engine/reset.py <level>。all 会重置全部进度与关卡资源，执行前同样核对 context。

仓库没有付费、订阅、充值或转售入口。

5. 与 kind 的区别

Kubernetes SIGs 的 kind负责用 Docker 节点建立本地集群，本身不提供闯关内容。K8sQuest 在 kind 之上增加故障任务、提示、校验、复盘和进度。

只需要 CI 或开发用本地集群时，直接使用 kind；需要循序练习 kubectl 排障时，再加入 K8sQuest。

常见问题