为何符合kubeVersion要求的Helm Chart无法在Microk8s安装？

问题场景 #

• 运行环境：Ubuntu服务器 + Microk8s Kubernetes集群
• Helm版本：

  version.BuildInfo{Version:"v3.9.2", GitCommit:"1addefbfe665c350f4daf868a9adc5600cc064fd", GitTreeState:"clean", GoVersion:"go1.17.12"}
  

• 待部署Helm Chart的Chart.yaml片段：

  apiVersion: v2
  name: myTest
  description: The test daemon (test) helm chart
  type: application
  version: 1.4.0
  appVersion: v1.18.0
  kubeVersion: ">= 1.19.0"
  

• 报错信息：

  INSTALLATION FAILED: chart requires kubeVersion: >= 1.19.0 which is incompatible with Kubernetes v1.19.15-34+c064bb32deff78

已尝试切换Microk8s 1.19、1.21、1.24版本，问题仍存在；但相同Chart在Minikube上可正常安装。

原因分析 #

Microk8s生成的Kubernetes版本号带有自定义后缀（如v1.19.15-34+c064bb32deff78），而Helm的版本校验逻辑会将这种带后缀的版本号判定为低于标准格式的v1.19.0，从而触发兼容性报错。Minikube的版本号为标准格式（无额外后缀），因此能通过校验。

解决方案 #

方案1：临时跳过版本校验 #

安装Chart时通过参数强制跳过校验或指定标准版本号：

# 方式1：指定标准版本号绕过校验
helm install my-test ./myTest --kube-version v1.19.15

# 方式2：直接跳过版本校验
helm install my-test ./myTest --no-verify

方案2：修改Chart的kubeVersion规则（长期推荐） #

更新Chart.yaml中的kubeVersion字段，兼容带后缀的版本格式：

# 原配置
kubeVersion: ">= 1.19.0"
# 修改后配置
kubeVersion: ">= 1.19.0-0"

-0是Helm版本校验的特殊写法，会忽略版本号中-之后的后缀部分，让Microk8s的自定义版本号通过校验。

方案3：修改Microk8s版本标识（不推荐） #

通过修改Microk8s内部配置去掉版本号后缀，但该操作涉及集群底层配置，风险较高，仅适合有经验的运维人员操作。

验证 #

完成上述修改后，重新执行安装命令：

helm install my-test ./myTest

若使用方案2，Chart的版本规则已兼容Microk8s格式，即可正常完成部署。

内容的提问来源于stack exchange，提问作者Navid_pdp11