clouddojo 0.1.0

A gamified, narrative-driven troubleshooting platform for DevOps/SRE engineers

CloudDojo CLI ⚡

Learn DevOps troubleshooting through gamified, story-driven challenges
“The world isn’t perfect. But it’s there for us, doing the best it can…” — Madoka Kaname

---

🚀 Quick Start (Because life’s too short to read docs)

# Install it, because you want to be cool
pip install clouddojo

# Setup prerequisites — or just wait patiently for the magic to happen
clouddojo setup

# Start your journey to DevOps enlightenment
clouddojo dojo

🌟 What is CloudDojo?

CloudDojo is your gamified dojo where you learn DevOps troubleshooting through stories, sweat, and a dash of anime spirit. It’s like leveling up in your favorite RPG — but instead of dragons, you fight container demons.

• 🎮 Story-driven scenarios — Real company drama, but without the annoying meetings
• 🛤️ Structured learning paths — Beginner → Intermediate → Pro-level boss fights
• 💡 Progressive hints — Because nobody likes spoilers, but everyone loves a helping hand
• 🏆 Achievement system — XP, levels, badges — basically, bragging rights
• 📊 Progress tracking — Watch your DevOps powers grow like a true shonen hero

🎓 Learning Paths

Path	Level	Focus	Scenarios
🐋 Container Fundamentals	Beginner	Docker, nginx, configs	3
⚓ Kubernetes Warrior	Intermediate	Pods, services, networking	3
🔥 Production SRE	Advanced	System admin, automation	2

🎯 What You'll Learn

Docker troubleshooting — When containers act like rebellious teenagers

Kubernetes debugging — Because clusters love throwing tantrums

Production scenarios — Real-world chaos without the screaming bosses (hopefully)

Best practices — The ancient scrolls of DevOps wisdom, passed down so you don’t mess up

🤝 Contributing (Join the guild)

Think you can add cool new scenarios or fix stuff? Sweet! Here’s your questline:

Start here: CONTRIBUTING.md

Use our sacred template: scenario_template.py

Test your spells: python tests/test_scenarios.py

Submit your PR: Await our wise elders’ approval

🤖 AI-Assisted Contributions Welcome!

AI sidekicks like ChatGPT or Copilot are totally legit — just use our AI PR Template so we know you didn’t summon a demon instead.

📚 Documentation Scrolls

CONTRIBUTING.md — How to add epic scenarios

ARCHITECTURE.md — The bones of CloudDojo

TESTING.md — How to make sure your code doesn’t explode

SECURITY.md — Because safety first, ninja style

📋 Prerequisites (Your gear before the battle)

Python 3.8+

Docker (auto-installed by setup, if you don’t want to wait forever)

kubectl (also auto-installed, for your convenience)

NOTE: Auto-install might take a while (because patience is a virtue nobody asked for). We highly recommend installing Docker, Kubernetes, and Minikube yourself first — then run the auto-setup to verify everything didn’t self-destruct.

We’re “working hard” on the setup script… but if you want to help, contributions are welcome. No pressure. Seriously.

🆘 Need Help? (Because even heroes ask for directions)

• First time? Run clouddojo dojo and choose "Learning Paths"
• Stuck? Each scenario has progressive hints
• Issues? Check GitHub Issues
• Questions? Use GitHub Discussions

📊 Project Stats

• 8 scenarios across 3 learning paths
• 10+ achievements to unlock
• Cross-platform (Windows, macOS, Linux)
• Open source (MIT License)

🌟 Star History

If CloudDojo helped you level up your DevOps skills, please ⭐ star the repository!

“You should enjoy the little detours. To the fullest. Because that's where you'll find the things more important than what you want.” — Gintama

---

Ready to become a DevOps master? pip install clouddojo 🚀