🏗️ minikube-cluster-on-demand

Instant Single node Kubernetes cluster inside your GitHub Codespaces.

⚡ Quick Start

• Should be Logged into Github —> Press , (comma) on this repo —> Click Create new codespace

Boom! Your cluster is ready in minutes!

🎨 Access the "Breathing" GUI:

• Run this command in a new terminal (keep it open): minikube dashboard --port=9090
• UI is Ready: Go to Ports > Port 9090 > Open in Browser 🌐.
  • If you see JSON "Paths," simply append this exact string to your browser's address bar to reveal the visual dashboard: /api/v1/namespaces/kubernetes-dashboard/services/http:kubernetes-dashboard:/proxy/

Done! You wasted NO time on local setup. You've a fully working cluster, up and running!

🛜 Modern Networking via Gateway API (Optional)

North-South traffic is managed through the Kubernetes Gateway API, which is enabled and preconfigured in your cluster.

• Use the provided example listener: kubectl apply -f examples/Gateway.yaml
• Or, create custom Gateway listeners to define specific ports, protocols, and routing rules for your services.

🚀 Deploy "Hello World" Demo App in 30 sec inside cluster! (Optional)

• Deploy kubectl apply -f examples/all-in-one.yaml
• Check Running pods kubectl get pods -n traefik-v3
• Power up the Gateway kubectl port-forward service/traefik -n traefik-v3 8080:80 & Head to Port 8080. Hello World!
• Important! End the port forward ctrl+c & Delete the app when done kubectl delete -f examples/all-in-one.yaml to free the port for your app use.

🎯 Why this Template?

• Zero-Config: Skip the hassel of manual setup. Just get to your work!
• Modern Networking: Pre-loaded with the Kubernetes Gateway API (the successor to Ingress).
• Helm Ready: Native support for Helm charts to deploy your apps instantly, remote!
• Visual-First, GUI: Kubernetes UI Dashboard pre-configured to see your "breathing" pods live!
• Free: Codespace is free upto $10 per month! Enough to play around and implement something cool in the cluster.
• Zero-Footprint: No local install, no junk, no risk. Delete when done.
• Fully Open: No black boxes. Leverage IaC-powered open-source infrastructure you can customize and control.

🛠️ Handy Commands

• To Stop Cluster: minikube stop
• To Start Cluster: minikube start
• Cluster/Endpoints frozen: docker restart $(docker ps -q)

🌟 Support the Project

If this one-click Minikube setup saved you hassles of YAML-wrangling today, please:

• Star this repo to help others find it! ⭐️
• Fork it and build your own Gateway API experiments. 🍴
• Share it on LinkedIn & tag me! 🐦

🤝 Contribute & Support

Found a bug or have a better way to optimize for 2-core machines? Open an Issue or submit a Pull Request. Let's make the "Instant K8s" experience even faster together!

---

Use for Dev | Test | CI/CD Actions | Practice | Basically a throw away cluster after use!

Go ahead, give it a spin! 🚀