initial commit

README.md

@@ -0,0 +1,96 @@
+# Kubernetes on Raspberry Pi with Ansible - Usage Guide
+
+This guide details how to use the generated Ansible playbook to install Kubernetes on your Raspberry Pi cluster.
+
+## Prerequisites
+
+1. **Ansible Installed**: You need Ansible installed on your control machine (your laptop/desktop).
+   *   **Debian/Ubuntu**:
+       ```bash
+       sudo apt update && sudo apt install ansible sshpass -y
+       ```
+   *   **Arch Linux**:
+       ```bash
+       sudo pacman -S ansible sshpass
+       ```
+   *   **Fedora**:
+       ```bash
+       sudo dnf install ansible sshpass
+       ```
+2. **SSH Access**: Ensure you have SSH access to all Raspberry Pi nodes.
+3. **Hardware**: 4 Raspberry Pi nodes (1 Master, 3 Workers) with Raspberry Pi OS installed.
+
+## Configuration Steps
+
+### 1. Configure Inventory
+Edit `inventory/hosts.ini` and replace the placeholder IP addresses with the actual IPs of your Raspberry Pis.
+
+```ini
+[masters]
+pi1 ansible_host=192.168.1.10  <-- Change to Master IP
+
+[workers]
+pi2 ansible_host=192.168.1.11  <-- Change to Worker 1 IP
+pi3 ansible_host=192.168.1.12  <-- Change to Worker 2 IP
+pi4 ansible_host=192.168.1.13  <-- Change to Worker 3 IP
+```
+
+### 2. Configure Credentials
+You need to set the SSH password for the `pi` user. We use Ansible Vault for security.
+
+1. Generate an encrypted password string:
+   ```bash
+   ansible-vault encrypt_string 'YOUR_ACTUAL_PASSWORD' --name 'vault_ssh_password'
+   ```
+   *Replace `YOUR_ACTUAL_PASSWORD` with the real password.*
+
+2. Copy the output block and paste it into `group_vars/all.yml`, replacing the commented out section or just adding it.
+   
+   Example in `group_vars/all.yml`:
+   ```yaml
+   ansible_password: !vault |
+             $ANSIBLE_VAULT;1.1;AES256
+             ... (encrypted string) ...
+   ```
+   
+   Do the same for `vault_become_password` if your sudo password is different. If sudo password is same as ssh password, you can just set:
+   ```yaml
+   ansible_become_password: "{{ vault_ssh_password }}"
+   ```
+
+### 3. Run the Playbook
+
+To start the installation, run:
+
+```bash
+ansible-playbook site.yml --ask-vault-pass
+```
+
+*Note: Since you used `encrypt_string` without a password file, it might ask for a vault password if you set one. If you just used `encrypt_string`, you might need to provide the vault password you used to encrypt it.*
+
+**Alternative (Simpler for testing):**
+If you don't want to use Vault yet, you can pass the password as an extra var (INSECURE - be careful with history):
+```bash
+ansible-playbook site.yml -e "ansible_password=yourpassword ansible_become_password=yourpassword"
+```
+
+## Verification
+
+After the playbook completes:
+
+1. **SSH into the Master Node**:
+   ```bash
+   ssh pi@<master-ip>
+   ```
+
+2. **Check Nodes**:
+   ```bash
+   kubectl get nodes
+   ```
+   You should see 4 nodes with status `Ready`.
+
+3. **Check Pods**:
+   ```bash
+   kubectl get pods -A
+   ```
+   Ensure `coredns` and `kube-flannel` are running.