From aa380d4b7bf000d08325e0c7500e9857a845ba55 Mon Sep 17 00:00:00 2001 From: David Martin Date: Wed, 8 Oct 2025 16:03:53 +0100 Subject: [PATCH] Add kustomize install steps Signed-off-by: David Martin --- docs/guides/how-to-install-and-configure.md | 12 +++++++++++- docs/guides/kind-cluster-setup.md | 5 +++-- docs/guides/troubleshooting.md | 17 +++++++++++++++++ 3 files changed, 31 insertions(+), 3 deletions(-) diff --git a/docs/guides/how-to-install-and-configure.md b/docs/guides/how-to-install-and-configure.md index 2a7c7eb0..a07a5031 100644 --- a/docs/guides/how-to-install-and-configure.md +++ b/docs/guides/how-to-install-and-configure.md @@ -49,7 +49,17 @@ This automatically installs: - Required CRDs and RBAC - EnvoyFilter for Istio integration -### Method 2: Standalone Installation (Advanced) +### Method 2: Kustomize + +Install using Kubernetes manifests: + +```bash +kubectl apply -k 'https://github.com/kagenti/mcp-gateway/config/install?ref=main' +``` + +This provides the same components as Helm but with less configuration flexibility. + +### Method 3: Standalone Installation (Advanced) For non-Kubernetes deployments or advanced use cases, see [Standalone Installation Guide](./binary-install.md). diff --git a/docs/guides/kind-cluster-setup.md b/docs/guides/kind-cluster-setup.md index 347a41bf..189888f6 100644 --- a/docs/guides/kind-cluster-setup.md +++ b/docs/guides/kind-cluster-setup.md @@ -78,9 +78,10 @@ Your Kind cluster is now ready with Gateway API and Istio installed! ## Next Steps -Now that you have a cluster with the prerequisites: +Now that you have a cluster with the prerequisites, choose your installation method: -- **[Install MCP Gateway via Helm](./how-to-install-and-configure.md#method-1-helm-recommended)** - Follow the Helm installation method +- **[Install MCP Gateway via Helm](./how-to-install-and-configure.md#method-1-helm-recommended)** - Recommended approach +- **[Install MCP Gateway via Kustomize](./how-to-install-and-configure.md#method-2-kustomize)** - Alternative method After installation, continue with configuration: diff --git a/docs/guides/troubleshooting.md b/docs/guides/troubleshooting.md index 14c000d5..1d107ecd 100644 --- a/docs/guides/troubleshooting.md +++ b/docs/guides/troubleshooting.md @@ -25,6 +25,23 @@ kubectl cluster-info - Check that Gateway API CRDs are installed: `kubectl get crd gateways.gateway.networking.k8s.io` - Ensure Istio is installed: `kubectl get pods -n istio-system` +### Kustomize Installation Fails + +**Symptom**: `kubectl apply -k` fails with validation errors + +```bash +# Verify Gateway API CRDs exist +kubectl get crd gateways.gateway.networking.k8s.io httproutes.gateway.networking.k8s.io + +# Check for resource conflicts +kubectl get mcpserver -A +kubectl get deployment -n mcp-system +``` + +**Solutions**: +- Install Gateway API CRDs first: `kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.2.1/standard-install.yaml` +- Delete existing resources if upgrading: `kubectl delete -k 'https://github.com/kagenti/mcp-gateway/config/install?ref=main'` + ### Pods Not Starting **Symptom**: MCP Gateway pods stuck in `Pending`, `CrashLoopBackOff`, or `ImagePullBackOff`