https://github.com/rohitg00/k8sgames
Learn Kubernetes by playing. Deploy pods, fix CrashLoopBackOff, type real kubectl commands: 3D browser game, no install needed.
https://github.com/rohitg00/k8sgames
browser-game cka cloud-native containers devops education games gamification k8s k8sgames kubectl kubernetes kubernetes-learning learning simulation sre threejs
Last synced: about 15 hours ago
JSON representation
Learn Kubernetes by playing. Deploy pods, fix CrashLoopBackOff, type real kubectl commands: 3D browser game, no install needed.
- Host: GitHub
- URL: https://github.com/rohitg00/k8sgames
- Owner: rohitg00
- License: apache-2.0
- Created: 2026-02-15T11:07:42.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-03-31T20:17:38.000Z (4 days ago)
- Last Synced: 2026-03-31T20:24:40.392Z (4 days ago)
- Topics: browser-game, cka, cloud-native, containers, devops, education, games, gamification, k8s, k8sgames, kubectl, kubernetes, kubernetes-learning, learning, simulation, sre, threejs
- Language: JavaScript
- Homepage: https://k8sgames.com
- Size: 1.3 MB
- Stars: 154
- Watchers: 0
- Forks: 15
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# K8s Games
Learn Kubernetes by playing. Deploy pods, fix CrashLoopBackOff, type real kubectl commands — all in a 3D sim that runs in your browser.
**[Play Now at k8sgames.com](https://k8sgames.com)** | **[K8s Draw — 3D Architecture Diagrams](https://k8sgames.com/draw)**
## Get Started
Visit **[k8sgames.com](https://k8sgames.com)** and pick a mode. No install, no signup, no build step.
Just here to diagram? Go straight to **[k8sgames.com/draw](https://k8sgames.com/draw)** — drag K8s resources onto a 3D canvas, draw connections, export YAML or PNG, and share via URL.
Or run locally:
```bash
git clone https://github.com/rohitg00/k8sgames.git
cd k8sgames
python3 -m http.server 8080
# Open http://localhost:8080
```
## How to Play
1. Pick a game mode from the main menu
2. Click resources from the left palette to place them in your cluster
3. Drag resources to reposition them anywhere
4. Click any resource to inspect it (status, YAML, kubectl describe)
5. Right-click for actions (Scale, Delete, Logs, Restart)
6. Press `/` to open the kubectl command bar
7. Handle incidents as they appear — diagnose and fix like a real SRE
8. Press `?` anytime for help
## Game Modes
| Mode | What You Do |
|------|-------------|
| **Campaign** | 20 levels across 5 chapters. Learn pods, deployments, networking, storage, and production K8s |
| **Chaos** | Endless survival. Incidents escalate until your cluster breaks. How long can you last? |
| **Sandbox** | Free build. Design any cluster, get scored 0-100 by the Architecture Advisor |
| **Challenges** | 10 timed scenarios. Deploy apps, fix outages, race the clock |
### K8s Draw (`/draw`)
A 3D Kubernetes architecture whiteboard. Like Excalidraw but for K8s.
- Drag-drop 21 resource types onto a 3D canvas
- Draw connection lines between resources
- Double-click to rename any resource
- Auto-layout organizes by tier (Nodes, Workloads, Networking, Storage, RBAC)
- Export as YAML (with correct apiVersions) or PNG
- Share diagrams via URL — one-click copy, open anywhere
- Edit properties: name, namespace, labels, replicas
- Right-click to delete, `Del` key for selected
No game logic, no incidents, no scoring — just diagramming.
## Controls
| Input | Action |
|-------|--------|
| `/` | kubectl command bar |
| `?` | Help / How to play |
| `Space` | Pause / Resume |
| `M` | Metrics dashboard |
| `Esc` | Back to menu |
| `1-9` | Quick-select resource |
| Left-click | Select resource |
| Left-drag | Move resource or rotate camera |
| Right-click | Context menu |
| Right-drag | Pan |
| Scroll | Zoom |
Bottom toolbar: **Auto-Align** (K8s architecture layout) | **Reset View** | **YAML** (export cluster) | **Help**
## What's In It
**25 K8s resources** — Pod, Deployment, ReplicaSet, StatefulSet, DaemonSet, Job, CronJob, Service, Ingress, NetworkPolicy, ConfigMap, Secret, PVC, PV, StorageClass, Node, Namespace, HPA, ResourceQuota, PodDisruptionBudget, ServiceAccount, Role, ClusterRole, RoleBinding, ClusterRoleBinding. Each has a unique 3D shape, color, and real K8s behavior.
**29 incidents** — OOMKilled, CrashLoopBackOff, ImagePullBackOff, node NotReady, DNS failures, PVC pending, API throttling, rollout stuck, certificate expiry, HPA flapping, and more. Investigate with kubectl describe/logs, then fix.
**kubectl command bar** — type real commands: `get pods`, `describe deployment nginx`, `scale deployment nginx --replicas=3`, `logs pod-1`, `rollout status`, `drain node-1`. Tab completion included.
**Visual connections** — animated lines show ownership chains (Deployment -> ReplicaSet -> Pod) and network routing (Service -> Pods) based on label selectors. Place a Service and pick which Deployment it connects to.
**Edit resources** — click Edit on any resource to modify labels, replicas, selectors, and service types. Quick-connect buttons let you wire a Service to an existing Deployment in one click.
**Architecture Advisor** — scores your cluster design across HA, security, scalability, cost, and 6 other categories.
**40 achievements** and a 30-level XP system from Novice to CKA-ready.
**RBAC simulation** — ServiceAccounts, Roles, ClusterRoles, RoleBindings, and ClusterRoleBindings with real rule definitions and wildcard detection.
## Tech
Three.js r152 + Tailwind CSS CDN + vanilla ES6 modules. No build step, no dependencies, no bundler. ~50K lines across 90+ files.
## License
Apache-2.0