diff --git a/tech_docs/minikube_setup_debian.md b/tech_docs/minikube_setup_debian.md index 5369ed9..a4c8a5d 100644 --- a/tech_docs/minikube_setup_debian.md +++ b/tech_docs/minikube_setup_debian.md @@ -1,3 +1,86 @@ +# Kubernetes Learning Lab Setup with Minikube on Debian 12 + +## Prerequisites +- System Requirements: + - 2+ CPUs + - 2GB+ free memory + - 20GB+ free disk space + - Internet connection +- Software Requirements: + - Docker + - Kubectl + - Minikube + +## Setup Steps + +### 1. Install Docker +1. Update package list: `sudo apt-get update` +2. Install required packages +3. Add Docker's GPG key +4. Set up Docker repository +5. Install Docker Engine +6. Start and enable Docker +7. Verify installation + +### 2. Install Kubectl +1. Download latest release +2. Make binary executable +3. Move binary to PATH +4. Verify installation + +### 3. Install Minikube +1. Download latest Minikube binary +2. Install Minikube +3. Verify installation + +### 4. Start Minikube +1. Start Minikube with Docker driver +2. Verify Minikube status + +### 5. Basic Minikube Commands +- Check cluster info +- Deploy sample application +- Access Minikube Dashboard + +### 6. Stop and Delete Minikube +- Stop Minikube +- Delete Minikube + +## Sample Projects + +### 1. Guestbook Application +- Components: + - Frontend: PHP-based web interface + - Backend: Redis master and replicas +- Deployment steps: + 1. Clone Kubernetes examples repository + 2. Deploy Redis Master (Deployment and Service) + 3. Deploy Redis Replicas (Deployment and Service) + 4. Deploy Guestbook Frontend (Deployment and Service) + 5. Verify and access the application + +### 2. Simple Nginx Web Application +- Components: + - Nginx web server + - Static HTML page +- Deployment steps: + 1. Create Deployment YAML + 2. Create ConfigMap for HTML content + 3. Create Service YAML + 4. Deploy the application + 5. Access the application + 6. Clean up resources + +## Additional Learning Resources +1. Kubernetes Documentation +2. Katacoda Scenarios +3. "Kubernetes Up and Running" book +4. "Kubernetes the Hard Way" tutorial + +For detailed instructions and commands, refer to the original document. + +--- + A good reference project for learning how to work with Kubernetes (K8s) should cover various aspects of K8s, including deployments, services, networking, storage, and scaling. One such project is the **"Guestbook"** application, a simple multi-tier web application that demonstrates many core concepts of Kubernetes. ### Guestbook Application Overview