From b0f5ffeaba5a800103cf2806544a0eb963d48eca Mon Sep 17 00:00:00 2001
From: Aditya <60684641+0x0elliot@users.noreply.github.com>
Date: Wed, 26 Nov 2025 16:15:25 +0530
Subject: [PATCH] docs: basic docs on minikube and GKE

---
 functions/kubernetes/README.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/functions/kubernetes/README.md b/functions/kubernetes/README.md
index c2d2c3d1..7864eb38 100644
--- a/functions/kubernetes/README.md
+++ b/functions/kubernetes/README.md
@@ -10,3 +10,35 @@ More details in the [kubernetes/Charts/Shuffle folder.](https://github.com/Shuff
 Here is the default architecture it follows, with the "Frontend" being the exposed container you interact with.
 
 <img width="1006" height="1069" alt="image" src="https://github.com/user-attachments/assets/263369a1-6944-4ef5-8f19-14bc234130d8" />
+
+## MiniKube
+We don't support minikube yet. Please use GKE or another cloud based k8s engine to test out Shuffle.
+
+## GKE testing
+
+For testing on GKE, you can use the following command:
+
+```bash
+PROJECT_NAME="project"
+CLUSTER_NAME="cluster"
+
+# feel free to change the region and machine type
+gcloud container clusters create "$CLUSTER_NAME" \
+  --project "$PROJECT_NAME" \
+  --region "asia-south2" \
+  --release-channel "regular" \
+  --machine-type "e2-standard-2" \
+  --num-nodes "1" \
+  --node-locations "asia-south2-b,asia-south2-a,asia-south2-c"
+
+kubectl config set-context $CLUSTER_NAME
+
+# apply shuffle k8s helm chart
+helm install shuffle oci://ghcr.io/shuffle/charts/shuffle \
+  --version 2.1.1 \
+  --namespace shuffle \
+  --create-namespace
+
+# 3. Verify
+kubectl get pods -n shuffle
+```