add local nginx dev env

Author: Sarthak Agrawal

dev/nginx/Makefile

@@ -0,0 +1,35 @@
+PORT ?= 8080
+
+.PHONY: help deploy cleanup logs update port-forward test
+
+help: ## Show this help
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-15s\033[0m %s\n", $$1, $$2}'
+	@echo "\nVariables:"
+	@echo "  PORT=8080    Port for port-forwarding (default: 8080)"
+
+deploy: ## Deploy nginx and echo server to Kubernetes
+	kubectl create configmap nginx-config --from-file=nginx.conf --dry-run=client -o yaml | kubectl apply -f -
+	kubectl apply -f nginx.yaml
+	@echo "Waiting for pods to be ready..."
+	kubectl wait --for=condition=ready pod -l app=nginx-proxy --timeout=60s
+	kubectl wait --for=condition=ready pod -l app=echo-server --timeout=60s
+
+cleanup: ## Delete everything from Kubernetes
+	kubectl delete configmap nginx-config --ignore-not-found=true
+	kubectl delete -f nginx.yaml --ignore-not-found=true
+
+logs: ## Show nginx logs
+	kubectl logs -l app=nginx-proxy -f
+
+update: ## Update nginx config and restart pods
+	kubectl create configmap nginx-config --from-file=nginx.conf --dry-run=client -o yaml | kubectl apply -f -
+	kubectl rollout restart deployment/nginx-proxy
+
+port-forward: ## Port forward nginx pod to localhost:PORT (default: 8080)
+	kubectl port-forward deployment/nginx-proxy $(PORT):80 &
+
+test: ## Test the setup via port-forward (run 'make port-forward' first)
+	@echo "Testing nginx health..."
+	@curl -s http://localhost:$(PORT)/health
+	@echo "\nTesting echo backend..."
+	@curl -s http://localhost:$(PORT)/ | head -5

dev/nginx/README.md

@@ -0,0 +1,39 @@
+# Simple NGINX Kubernetes Environment
+
+Easy way to test NGINX proxying to a backend pod in Kubernetes.
+
+## Quick Start
+
+```bash
+# Deploy nginx and echo server
+make deploy
+
+# Port-forward nginx pod (in separate terminal)
+make port-forward
+
+# Test it works
+make test
+
+# Clean up
+make cleanup
+```
+
+## Available Commands
+
+- `make deploy` - Deploy nginx and echo server to Kubernetes
+- `make port-forward` - Port forward nginx pod to localhost:8080
+- `make test` - Test the setup via curl (assuming port-forward is running)
+- `make update` - Update config and restart pods
+- `make logs` - View nginx logs
+- `make cleanup` - Delete everything
+
+## How it works
+
+1. NGINX pod proxies all requests to echo server pod
+2. Use port-forward to access nginx on localhost:8080
+3. Edit `nginx.conf` directly and run `make update`
+
+## URLs (after port-forward)
+
+- http://localhost:8080/health - NGINX health check
+- http://localhost:8080/ - Proxied to echo server

dev/nginx/nginx.conf

@@ -0,0 +1,21 @@
+events {
+    worker_connections 1024;
+}
+
+http {
+    upstream echo-backend {
+        server echo-service:8080;
+    }
+
+    server {
+        listen 80;
+
+        location /health {
+            return 200 "OK\n";
+        }
+
+        location / {
+            proxy_pass http://echo-backend;
+        }
+    }
+}

dev/nginx/nginx.yaml

@@ -0,0 +1,71 @@
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: nginx-proxy
+  namespace: default
+  labels:
+    app: nginx-proxy
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: nginx-proxy
+  template:
+    metadata:
+      labels:
+        app: nginx-proxy
+    spec:
+      containers:
+      - name: nginx
+        image: nginx:alpine
+        ports:
+        - containerPort: 80
+        volumeMounts:
+        - name: nginx-config
+          mountPath: /etc/nginx/nginx.conf
+          subPath: nginx.conf
+      volumes:
+      - name: nginx-config
+        configMap:
+          name: nginx-config
+
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: echo-server
+  namespace: default
+  labels:
+    app: echo-server
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: echo-server
+  template:
+    metadata:
+      labels:
+        app: echo-server
+    spec:
+      containers:
+      - name: echo
+        image: ealen/echo-server:latest
+        ports:
+        - containerPort: 8080
+        env:
+        - name: PORT
+          value: "8080"
+
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: echo-service
+  namespace: default
+spec:
+  selector:
+    app: echo-server
+  ports:
+  - port: 8080
+    targetPort: 8080