Skip to content

[Bug]: Helm install does not work when kubeVersion has vendor specific suffixΒ #931

@AvniWala-AWN

Description

@AvniWala-AWN

🐞 Bug Summary

Helm install does not work when the kubeVersion has vendor-specific suffix. For example, my AWS EKS version is: 1.31.10-eks-931bdca

🧩 Affected Component

Select the area of the project impacted:

  • mcpgateway - API
  • mcpgateway - UI (admin panel)
  • mcpgateway.wrapper - stdio wrapper
  • Federation or Transports
  • CLI, Makefiles, or shell scripts
  • Container setup (Docker/Podman/Compose)
  • Other (explain below)

πŸ” Steps to Reproduce

  1. On AWS EKS running v1.31, try helm install as instructed in doc here: https://ibm.github.io/mcp-context-forge/deployment/helm/#install-upgrade-the-stack
  2. Install will fail due with kubeVersion mismatch error

πŸ€” Expected Behavior

Helm install should have been successful


πŸ““ Logs / Error Output

$ helm upgrade --install mcp-stack .   --namespace mcp-private   --create-namespace=false   -f my-values.yaml   --wait --timeout 30m --debug --dry-run
history.go:56: [debug] getting history for release mcp-stack
Release "mcp-stack" does not exist. Installing it now.
install.go:222: [debug] Original chart version: ""
install.go:239: [debug] CHART PATH: <---snip--->

Error: chart requires kubeVersion: >=1.21.0 which is incompatible with Kubernetes v1.31.10-eks-931bdca
helm.go:84: [debug] chart requires kubeVersion: >=1.21.0 which is incompatible with Kubernetes v1.31.10-eks-931bdca
helm.sh/helm/v3/pkg/action.(*Configuration).renderResources
	helm.sh/helm/v3/pkg/action/action.go:117
helm.sh/helm/v3/pkg/action.(*Install).RunWithContext
	helm.sh/helm/v3/pkg/action/install.go:312
main.runInstall
	helm.sh/helm/v3/cmd/helm/install.go:314
main.newUpgradeCmd.func2
	helm.sh/helm/v3/cmd/helm/upgrade.go:157
github.com/spf13/cobra.(*Command).execute
	github.com/spf13/[email protected]/command.go:983
github.com/spf13/cobra.(*Command).ExecuteC
	github.com/spf13/[email protected]/command.go:1115
github.com/spf13/cobra.(*Command).Execute
	github.com/spf13/[email protected]/command.go:1039
main.main
	helm.sh/helm/v3/cmd/helm/helm.go:83
runtime.main
	runtime/proc.go:271
runtime.goexit
	runtime/asm_arm64.s:1222

🧠 Environment Info

You can retrieve most of this from the /version endpoint.

Key Value
Version or commit v0.6.0
Runtime Python 3.11, Gunicorn 23.0.0
Platform / OS Linux AMD64
Container EKS v1.31

🧩 Additional Context (optional)

This fix works for me, but unable to raise a PR due to write permission issues:

diff --git a/charts/mcp-stack/Chart.yaml b/charts/mcp-stack/Chart.yaml
index bd6a8b60..cd141461 100644
--- a/charts/mcp-stack/Chart.yaml
+++ b/charts/mcp-stack/Chart.yaml
@@ -46,4 +46,4 @@ maintainers:
     url: https://github.com/IBM

 # Require Kubernetes β‰₯1.21 for networking v1 and recent securityContext fields
-kubeVersion: ">=1.21.0"
+kubeVersion: ">=1.21.0-0"

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingtriageIssues / Features awaiting triage

    Type

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions