update

Author: Marcel Zapf

README.md

@@ -1,240 +1,121 @@
 # K8s DevMachine
 
-A containerized development environment for Kubernetes that provides a VM-like dev experience with SSH access.
+Containerized development environment for Kubernetes with SSH access. Perfect for VS Code Remote SSH development.
 
 ## ✨ Features
 
-- **Complete development toolkit** with pre-installed tools:
-  - Terraform
-  - Packer
-  - Ansible with Python libraries
-  - Git, Vim, SSH utilities
-  - MinIO Client
-- **SSH access** on port 2222
+- **Development Tools**: Terraform, Packer, Ansible, Python 3, Git, Vim
+- **System Tools**: htop, tmux, mc, mcli (minio cli), curl, jq, ping, dig, dmidecode, lshw
+- **Cloud Tools**: MinIO Client, SSH server with key-based auth
+- **VS Code Remote SSH ready** - full IDE experience
+- **Go development support** - easily install Go SDK
 - **Persistent storage** for home directory
-- **Secure configuration** with non-root user
-- **Python virtual environment** auto-activated
-- **Customizable SSH keys** via ConfigMap
+- **Non-root user** (UID 1001) with auto-activated Python venv
 
 ## 🚀 Quick Start
 
-### Prerequisites
-
-- Kubernetes cluster (>= 1.20)
-- Helm 3.x
-- Storage class (Longhorn recommended)
-- LoadBalancer support (for external access)
-
-### Installation
-
-1. **Clone the repository**
 ```bash
+# 1. Clone repo
 git clone https://github.com/syntax3rror404/k8s-devmachine.git
 cd k8s-devmachine
-```
-
-2. **Configure SSH keys**
-Edit `chart/values.yaml` and add your public SSH keys:
 
-```yaml
+# 2. Add your SSH keys to chart/values.yaml
 ssh:
   authorizedKeys: |
     ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQC... user@hostname
-    ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI... user@hostname
-```
 
-3. **Deploy with Helm**
-```bash
+# 3. Deploy
 helm install devmachine ./chart
-```
 
-4. **Get external IP and connect**
-```bash
+# 4. Connect
 kubectl get svc devmachine-service
 ssh -p 2222 dev@<EXTERNAL-IP>
 ```
 
-## 🔧 Configuration
-
-### values.yaml
-
-```yaml
-replicaCount: 1
-
-image:
-  source: ghcr.io/syntax3rror404/k8s-devmachine@sha256:...
-  pullPolicy: IfNotPresent
-
-service:
-  type: LoadBalancer
-  port: 2222
-  targetPort: 2222
-
-persistence:
-  enabled: true
-  size: 10Gi
-  storageClass: "longhorn"
+## 💻 VS Code Remote SSH
 
-ssh:
-  authorizedKeys: |
-    # Add your SSH public keys here
+1. Install "Remote - SSH" extension in VS Code
+2. Add to `~/.ssh/config`:
 ```
-
-### Resource limits (optional)
-
-```yaml
-resources:
-  requests:
-    memory: "512Mi"
-    cpu: "250m"
-  limits:
-    memory: "2Gi"
-    cpu: "1000m"
+Host k8s-devmachine
+    HostName <EXTERNAL-IP>
+    Port 2222
+    User dev
 ```
+3. Connect via VS Code: `Ctrl+Shift+P` → "Remote-SSH: Connect to Host"
 
-## 🔐 Access
+## 🛠️ Install Additional Tools
 
-### SSH Connection
+### Go Installation
 ```bash
-# Get external IP
-EXTERNAL_IP=$(kubectl get svc devmachine-service -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
-
-# Connect via SSH
-ssh -p 2222 dev@$EXTERNAL_IP
+ssh -p 2222 dev@<EXTERNAL-IP>
+cd /tmp
+wget https://go.dev/dl/go1.21.5.linux-amd64.tar.gz
+tar -xzf go1.21.5.linux-amd64.tar.gz
+mv go ~/bin/
+go version  # Already in PATH
 ```
 
-### Port Forwarding (alternative)
+### Node.js
 ```bash
-kubectl port-forward svc/devmachine-service 2222:2222
-ssh -p 2222 dev@localhost
+curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
+sudo apt-get install -y nodejs
 ```
 
-## 📁 Container Structure
-
-```
-/home/dev/
-├── .ssh/authorized_keys    # Your SSH keys
-├── .bashrc                 # Shell configuration
-├── venv/                   # Python virtual environment
-├── ssh_keys/              # SSH host keys (persistent)
-└── run/                   # Runtime files
-```
-
-## 🛠️ Development
-
-### Building the image
-
-The container image is automatically built via GitHub Actions on push to master branch.
+## 🔧 Configuration
 
-For local development:
-```bash
-docker build -t k8s-devmachine .
-docker run -p 2222:2222 k8s-devmachine
+Key `values.yaml` options:
+```yaml
+replicaCount: 1
+service:
+  type: LoadBalancer  # or NodePort
+  port: 2222
+persistence:
+  size: 10Gi
+  storageClass: "longhorn"
+ssh:
+  authorizedKeys: |
+    # Your SSH public keys here
 ```
 
-### Installed Tools
+## 🔐 Access Options
 
-- **Infrastructure**: Terraform, Packer, TF-Helper
-- **Configuration Management**: Ansible with extensive Python libraries
-- **Utilities**: Git, Vim, curl, jq, openssh, MinIO client
-- **System Tools**: ping, dig, dmidecode, lshw
+**SSH Direct**: `ssh -p 2222 dev@<EXTERNAL-IP>`
+**Port Forward**: `kubectl port-forward svc/devmachine-service 2222:2222`
+**NodePort**: `kubectl patch svc devmachine-service -p '{"spec":{"type":"NodePort"}}'`
 
 ## 🐛 Troubleshooting
 
-### Common Issues
-
-**SSH connection refused**
 ```bash
-# Check pod status
+# Check status
 kubectl get pods -l app=devmachine
-
-# View logs
 kubectl logs -l app=devmachine
 
-# Debug inside pod
-kubectl exec -it devmachine-0 -- /bin/bash
-```
-
-**LoadBalancer pending**
-```bash
-# Use NodePort instead
-kubectl patch svc devmachine-service -p '{"spec":{"type":"NodePort"}}'
-
-# Or use port-forwarding
-kubectl port-forward svc/devmachine-service 2222:2222
-```
-
-**Storage issues**
-```bash
-# Check storage class
-kubectl get storageclass
+# Debug connection
+kubectl exec -it devmachine-0 -- ss -tuln | grep 2222
 
-# Check PVC status
+# Storage issues
 kubectl get pvc
+kubectl describe pvc home-volume-devmachine-0
 ```
 
-### Debug Commands
+## 📁 Directory Structure
 
-```bash
-# Check service endpoints
-kubectl get endpoints devmachine-service
-
-# Describe pod for events
-kubectl describe pod devmachine-0
-
-# Test SSH service inside pod
-kubectl exec devmachine-0 -- ss -tuln | grep 2222
-```
-
-## 📊 Operations
-
-### Backup
-```bash
-# Backup home directory
-kubectl exec devmachine-0 -- tar czf - /home/dev > backup.tar.gz
-
-# Restore
-kubectl exec -i devmachine-0 -- tar xzf - -C / < backup.tar.gz
 ```
-
-### Updates
-```bash
-# Update image tag in values.yaml, then:
-helm upgrade devmachine ./chart
-
-# Rolling restart
-kubectl rollout restart statefulset/devmachine
-```
-
-### Scaling
-```bash
-# Scale to multiple instances
-helm upgrade devmachine ./chart --set replicaCount=3
+/home/dev/
+├── .ssh/authorized_keys    # SSH keys
+├── venv/                   # Python venv (auto-activated)
+├── bin/                    # Your binaries or optional bin/go installation
+└── projects/               # Your code
 ```
 
 ## 🔒 Security
 
-- Runs as non-root user (UID 1001)
-- Password authentication disabled
-- Key-based SSH authentication only
+- Non-root user (UID 1001)
+- Key-based SSH only
 - Seccomp profile enabled
-- Read-only root filesystem (where possible)
-
-## 🤝 Contributing
-
-1. Fork the repository
-2. Create a feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
-
-## 🙏 Acknowledgments
-
-- Built with Debian Bookworm Slim
-- Uses HashiCorp tools (Terraform, Packer)
-- Ansible automation platform
-- Kubernetes community
+- No privilege escalation
 
 ---
 
-> **Note**: This development machine is designed for development and testing purposes. Consider additional security measures for production environments.
+Perfect for remote development with persistent storage and full tool access with VSCode! 

chart/values.yaml

@@ -1,7 +1,7 @@
 replicaCount: 1
 
 image:
-  source: ghcr.io/syntax3rror404/k8s-devmachine@sha256:989cf449c639285da581399c36e12c83401ad7583dd44231ef1d2b7c95759aa7 
+  source: ghcr.io/syntax3rror404/k8s-devmachine@sha256:510352ea9a57812d776f095fbc51244349a0d89913e3a5af08ed365fd344bc4b 
   pullPolicy: IfNotPresent
 
 service:
@@ -24,7 +24,6 @@ ssh:
     # Place auth keys here ...
     # ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCu...
 
-
 securityContext:
   runAsNonRoot: true
   runAsUser: 1001