Update minikube targets

Signed-off-by: Mihai Criveti <[email protected]>

Author: crivetimihai

.gitignore

@@ -1,3 +1,4 @@
+minikube-*
 .htpasswd
 .env.gcr
 packages-lock.json

Makefile

@@ -1329,132 +1329,200 @@ ibmcloud-ce-rm:
 # =============================================================================
 # 🧪 MINIKUBE LOCAL CLUSTER
 # =============================================================================
+# A self‑contained block with sensible defaults, overridable via the CLI.
+# Examples:
+#   make minikube-start MINIKUBE_DRIVER=podman
+#   make minikube-image-load TAG=v0.1.2
+#
+#   # Push via the internal registry (registry addon):
+#   # 1️⃣ Discover the randomized host‑port (docker driver only):
+#   REG_URL=$(shell minikube -p $(MINIKUBE_PROFILE) service registry -n kube-system --url)
+#   # 2️⃣ Tag & push:
+#   docker build -t $${REG_URL}/$(PROJECT_NAME):dev .
+#   docker push $${REG_URL}/$(PROJECT_NAME):dev
+#   # 3️⃣ Reference in manifests:
+#   image: $${REG_URL}/$(PROJECT_NAME):dev
+#
+#   # If you built a prod image via:
+#   #     make docker-prod   # ⇒ mcpgateway/mcpgateway:latest
+#   # Tag & push it into Minikube:
+#   docker tag mcpgateway/mcpgateway:latest $${REG_URL}/mcpgateway:latest
+#   docker push $${REG_URL}/mcpgateway:latest
+#   # Override the Make target variable or patch your Helm values:
+#   make minikube-k8s-apply IMAGE=$${REG_URL}/mcpgateway:latest
+# -----------------------------------------------------------------------------
+
+# ▸ Tunables (export or pass on the command line)
+MINIKUBE_PROFILE ?= mcpgw          # Profile/cluster name
+MINIKUBE_DRIVER  ?= docker         # docker | podman | hyperkit | virtualbox …
+MINIKUBE_CPUS    ?= 4              # vCPUs to allocate
+MINIKUBE_MEMORY  ?= 6g             # RAM (supports m / g suffix)
+# Enabled addons – tweak to suit your workflow (`minikube addons list`).
+# • ingress / ingress-dns      – Ingress controller + CoreDNS wildcard hostnames
+# • metrics-server             – HPA / kubectl top
+# • dashboard                  – Web UI (make minikube-dashboard)
+# • registry                   – Local Docker registry, *dynamic* host-port
+# • registry-aliases           – Adds handy DNS names inside the cluster
+MINIKUBE_ADDONS  ?= ingress ingress-dns metrics-server dashboard registry registry-aliases
+# OCI image tag to preload into the cluster.
+# • By default we point to the *local* image built via `make docker-prod`, e.g.
+#   mcpgateway/mcpgateway:latest.  Override with IMAGE=<repo:tag> to use a
+#   remote registry (e.g. ghcr.io/ibm/mcp-context-forge:v0.1.1).
+TAG              ?= latest         # override with TAG=<ver>
+IMAGE            ?= $(IMG):$(TAG)  # or IMAGE=ghcr.io/ibm/mcp-context-forge:$(TAG)
+
+# -----------------------------------------------------------------------------
+# 🆘  HELP TARGETS (parsed by `make help`)
+# -----------------------------------------------------------------------------
 # help: 🧪 MINIKUBE LOCAL CLUSTER
-# help: minikube-install      - Install Minikube (macOS, Linux, or Windows via choco)
-# help: helm-install          - Install Helm CLI (macOS, Linux, or Windows)
-# help: minikube-start        - Start local Minikube cluster with Ingress + DNS + metrics-server
-# help: minikube-stop         - Stop the Minikube cluster
-# help: minikube-delete       - Delete the Minikube cluster
-# help: minikube-image-load   - Build and load ghcr.io/ibm/mcp-context-forge:latest into Minikube
-# help: minikube-k8s-apply    - Apply Kubernetes manifests from k8s/
-# help: minikube-status       - Show status of Minikube and ingress pods
+# help: minikube-install        - Install Minikube + kubectl (macOS / Linux / Windows)
+# help: minikube-start          - Start cluster + enable $(MINIKUBE_ADDONS)
+# help: minikube-stop           - Stop the cluster
+# help: minikube-delete         - Delete the cluster completely
+# help: minikube-tunnel         - Run "minikube tunnel" (LoadBalancer) in foreground
+# help: minikube-dashboard      - Print & (best‑effort) open the Kubernetes dashboard URL
+# help: minikube-image-load     - Load $(IMAGE) into Minikube container runtime
+# help: minikube-k8s-apply      - Apply manifests from k8s/
+# help: minikube-status         - Cluster + addon health overview
+# help: minikube-context        - Switch kubectl context to Minikube
+# help: minikube-ssh            - SSH into the Minikube VM
+# help: minikube-reset          - 🚨 delete ➜ start ➜ apply ➜ status (idempotent dev helper)
+# help: minikube-registry-url 	- Echo the dynamic registry URL (e.g. http://localhost:32790)
 
 .PHONY: minikube-install helm-install minikube-start minikube-stop minikube-delete \
-        minikube-image-load minikube-k8s-apply minikube-status
+        minikube-tunnel minikube-dashboard minikube-image-load minikube-k8s-apply \
+        minikube-status minikube-context minikube-ssh minikube-reset minikube-registry-url
 
+# -----------------------------------------------------------------------------
+# 🚀  INSTALLATION HELPERS
+# -----------------------------------------------------------------------------
 minikube-install:
 	@echo "💻 Detecting OS and installing Minikube + kubectl…"
-	@if [ "$$(uname)" = "Darwin" ]; then \
-	  echo "🍎 Installing via Homebrew…"; \
+	@if [ "$(shell uname)" = "Darwin" ]; then \
 	  brew install minikube kubernetes-cli; \
-	elif [ "$$(uname)" = "Linux" ]; then \
-	  echo "🐧 Installing via direct download…"; \
-	  curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 && \
-	  sudo install minikube-linux-amd64 /usr/local/bin/minikube && \
-	  rm minikube-linux-amd64; \
-	  echo "🔧 Installing kubectl…"; \
-	  curl -LO "https://dl.k8s.io/release/$$(curl -sL https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl" && \
+	elif [ "$(shell uname)" = "Linux" ]; then \
+	  curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 && \
+	  chmod +x minikube && sudo mv minikube /usr/local/bin/; \
+	  curl -Lo kubectl "https://dl.k8s.io/release/$$(curl -sL https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl" && \
 	  chmod +x kubectl && sudo mv kubectl /usr/local/bin/; \
 	elif command -v powershell.exe >/dev/null; then \
-	  echo "🪟 Installing via Chocolatey…"; \
-	  powershell.exe -Command "choco install -y minikube kubernetes-cli"; \
-	else \
-	  echo "❌ Unsupported OS. Please install manually."; \
-	  exit 1; \
-	fi
-
-helm-install:
-	@echo "📦 Installing Helm CLI…"
-	@if [ "$$(uname)" = "Darwin" ]; then \
-	  brew install helm; \
-	elif [ "$$(uname)" = "Linux" ]; then \
-	  curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash; \
-	elif command -v powershell.exe >/dev/null; then \
-	  powershell.exe -Command "choco install -y kubernetes-helm"; \
+	  powershell.exe -NoProfile -Command "choco install -y minikube kubernetes-cli"; \
 	else \
-	  echo "❌ Unsupported OS. Please install Helm manually."; \
-	  exit 1; \
+	  echo "❌ Unsupported OS. Install manually ↗"; exit 1; \
 	fi
 
+# -----------------------------------------------------------------------------
+# ⏯  LIFECYCLE COMMANDS
+# -----------------------------------------------------------------------------
 minikube-start:
-	@echo "🚀 Starting Minikube with profile 'mcpgw'..."
-	minikube start \
-	  --driver=docker \
-	  --cpus=4 --memory=6g \
-	  --profile=mcpgw
-	@echo "🔌 (Re)enabling required addons…"
-	minikube addons enable ingress -p mcpgw
-	minikube addons enable ingress-dns -p mcpgw
-	minikube addons enable metrics-server -p mcpgw
+	@echo "🚀 Starting Minikube profile '$(MINIKUBE_PROFILE)' (driver=$(MINIKUBE_DRIVER)) …"
+	minikube start -p $(MINIKUBE_PROFILE) \
+	  --driver=$(MINIKUBE_DRIVER) \
+	  --cpus=$(MINIKUBE_CPUS) --memory=$(MINIKUBE_MEMORY)
+	@echo "🔌 Enabling addons: $(MINIKUBE_ADDONS)"
+	@for addon in $(MINIKUBE_ADDONS); do \
+	  minikube addons enable $$addon -p $(MINIKUBE_PROFILE); \
+	done
 
 minikube-stop:
-	@echo "🛑 Stopping Minikube cluster..."
-	minikube stop -p mcpgw
+	@echo "🛑 Stopping Minikube …"
+	minikube stop -p $(MINIKUBE_PROFILE)
 
 minikube-delete:
-	@echo "🗑 Deleting Minikube cluster..."
-	minikube delete -p mcpgw
+	@echo "🗑 Deleting Minikube profile '$(MINIKUBE_PROFILE)' …"
+	minikube delete -p $(MINIKUBE_PROFILE)
 
+# -----------------------------------------------------------------------------
+# 🛠  UTILITIES
+# -----------------------------------------------------------------------------
+minikube-tunnel:
+	@echo "🌐 Starting minikube tunnel (Ctrl+C to quit) …"
+	minikube -p $(MINIKUBE_PROFILE) tunnel
+
+minikube-dashboard:
+	@echo "📊 Fetching dashboard URL …"
+	@minikube dashboard -p $(MINIKUBE_PROFILE) --url | { \
+	  read url; \
+	  echo "🔗 Dashboard: $$url"; \
+	  ( command -v xdg-open >/dev/null && xdg-open $$url >/dev/null 2>&1 ) || \
+	  ( command -v open     >/dev/null && open $$url     >/dev/null 2>&1 ) || true; \
+	}
+
+minikube-context:
+	@echo "🎯 Switching kubectl context to Minikube …"
+	kubectl config use-context minikube
+
+minikube-ssh:
+	@echo "🔧 Connecting to Minikube VM (exit with Ctrl+D) …"
+	minikube ssh -p $(MINIKUBE_PROFILE)
+
+# -----------------------------------------------------------------------------
+# 📦  IMAGE & MANIFEST HANDLING
+# -----------------------------------------------------------------------------
 minikube-image-load:
-	@echo "📦 Loading image into Minikube (must be pre-built)..."
-	@if ! docker image inspect ghcr.io/ibm/mcp-context-forge:latest >/dev/null 2>&1; then \
-	  echo "❌ Image ghcr.io/ibm/mcp-context-forge:latest not found. Download or build it first."; \
-	  exit 1; \
+	@echo "📦 Loading $(IMAGE) into Minikube …"
+	@if ! docker image inspect $(IMAGE) >/dev/null 2>&1; then \
+	  echo "❌ $(IMAGE) not found locally. Build or pull it first."; exit 1; \
 	fi
-	minikube image load ghcr.io/ibm/mcp-context-forge:latest -p mcpgw
-	@echo "🔍 Verifying image presence inside Minikube..."
-	minikube ssh -p mcpgw "sudo crictl images | grep ghcr.io/ibm/mcp-context-forge || echo '❌ Image not found in Minikube runtime'"
+	minikube image load $(IMAGE) -p $(MINIKUBE_PROFILE)
 
 minikube-k8s-apply:
-	@echo "🧩 Applying Kubernetes manifests..."
-	kubectl apply -f k8s/postgres-config.yaml || true
-	kubectl apply -f k8s/postgres-pv.yaml || true
-	kubectl apply -f k8s/postgres-pvc.yaml || true
-	kubectl apply -f k8s/postgres-deployment.yaml
-	kubectl apply -f k8s/postgres-service.yaml
-	kubectl apply -f k8s/redis-deployment.yaml
-	kubectl apply -f k8s/redis-service.yaml
-	kubectl apply -f k8s/mcp-context-forge-deployment.yaml
-	kubectl apply -f k8s/mcp-context-forge-service.yaml
-	kubectl apply -f k8s/mcp-context-forge-ingress.yaml
-	minikube status -p mcpgw
+	@echo "🧩 Applying k8s manifests in ./k8s …"
+	@kubectl apply -f k8s/ --recursive
 
-minikube-status:
-	@echo "📊 Minikube cluster status:"
-	minikube status -p mcpgw
-
-	@echo "\n📦 Addon status (ingress, ingress-dns, metrics-server):"
-	minikube addons list | grep -E 'ingress|ingress-dns|metrics-server'
-
-	@echo "\n🚦 Ingress controller pods:"
-	kubectl get pods -n ingress-nginx -o wide || true
-
-	@echo "\n🧭 Ingress-DNS pods (coredns):"
-	kubectl get pods -n kube-system -l k8s-app=kube-dns -o wide || true
+# -----------------------------------------------------------------------------
+# 🔍  Utility: print the current registry URL (host‑port) – works after cluster
+#             + registry addon are up.
+# -----------------------------------------------------------------------------
+minikube-registry-url:
+	@echo "📦 Internal registry URL:" && \
+	minikube -p $(MINIKUBE_PROFILE) service registry -n kube-system --url || \
+	echo "⚠️  Registry addon not ready – run make minikube-start first."
 
-	@echo "\n🧩 Application services:"
-	kubectl get svc || true
+# -----------------------------------------------------------------------------
+# 📊  INSPECTION & RESET
+# -----------------------------------------------------------------------------
+minikube-status:
+	@echo "📊 Minikube cluster status:" && minikube status -p $(MINIKUBE_PROFILE)
+	@echo "\n📦 Addon status:" && minikube addons list | grep -E "$(subst $(space),|,$(MINIKUBE_ADDONS))"
+	@echo "\n🚦 Ingress controller:" && kubectl get pods -n ingress-nginx -o wide || true
+	@echo "\n🔍 Dashboard:" && kubectl get pods -n kubernetes-dashboard -o wide || true
+	@echo "\n🧩 Services:" && kubectl get svc || true
+	@echo "\n🌐 Ingress:" && kubectl get ingress || true
 
-	@echo "\n🌐 Application ingress:"
-	kubectl get ingress || true
+minikube-reset: minikube-delete minikube-start minikube-image-load minikube-k8s-apply minikube-status
+	@echo "✅ Minikube reset complete!"
 
 # -----------------------------------------------------------------------------
 # 🛠️ HELM CHART TASKS
 # -----------------------------------------------------------------------------
 # help: 🛠️ HELM CHART TASKS
+# help: helm-install         - Install Helm 3 CLI
 # help: helm-lint            - Lint the Helm chart (static analysis)
 # help: helm-package         - Package the chart into dist/ as mcp-stack-<ver>.tgz
 # help: helm-deploy          - Upgrade/Install chart into Minikube (profile mcpgw)
 # help: helm-delete          - Uninstall the chart release from Minikube
 # -----------------------------------------------------------------------------
 
-.PHONY: helm-lint helm-package helm-deploy helm-delete
+.PHONY: helm-install helm-lint helm-package helm-deploy helm-delete
 
 CHART_DIR      ?= charts/mcp-stack
 RELEASE_NAME   ?= mcp-stack
 NAMESPACE      ?= mcp
 VALUES         ?= $(CHART_DIR)/values.yaml
 
+helm-install:
+	@echo "📦 Installing Helm CLI…"
+	@if [ "$(shell uname)" = "Darwin" ]; then \
+	  brew install helm; \
+	elif [ "$(shell uname)" = "Linux" ]; then \
+	  curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash; \
+	elif command -v powershell.exe >/dev/null; then \
+	  powershell.exe -NoProfile -Command "choco install -y kubernetes-helm"; \
+	else \
+	  echo "❌ Unsupported OS. Install Helm manually ↗"; exit 1; \
+	fi
+
 helm-lint:
 	@echo "🔍 Helm lint..."
 	helm lint $(CHART_DIR)