kubernetes
install_error
ai_generated
partial
错误:Chart 需要 kubeVersion: >=1.25.0-0,这与 Kubernetes v1.24.10 不兼容
Error: chart requires kubeVersion: >=1.25.0-0 which is incompatible with Kubernetes v1.24.10
ID: kubernetes/helm-incompatible-capabilities
82%修复率
88%置信度
1证据数
2023-09-12首次发现
版本兼容性
| 版本 | 状态 | 引入 | 弃用 | 备注 |
|---|---|---|---|---|
| Helm 3.11 | active | — | — | — |
| Helm 3.12 | active | — | — | — |
| Helm 3.13 | active | — | — | — |
| Kubernetes 1.24 | active | — | — | — |
| Kubernetes 1.25 | active | — | — | — |
根因分析
Helm Chart 定义了最低 Kubernetes 版本要求 (kubeVersion),当前集群版本不满足此要求,导致无法安装或升级。
English
A Helm chart defines a minimum Kubernetes version requirement (kubeVersion) that is not met by the current cluster version, preventing installation or upgrade.
官方文档
https://helm.sh/docs/topics/charts/#the-chart-yaml-file解决方案
-
Upgrade the cluster: use kubeadm or cloud provider to upgrade nodes to a compatible version, e.g., kubectl get nodes and then upgrade to v1.25+
-
Find an older chart version that supports your Kubernetes version: helm search repo <chart-name> --versions and install with --version <older-version>
无效尝试
常见但无效的做法:
-
Downgrading the chart to an older version manually by editing Chart.yaml
70% 失败
Chart.yaml 中的 kubeVersion 是声明式的,降级版本可能不满足其他依赖
-
Ignoring the error with --force flag
95% 失败
Helm 的 --force 不绕过 kubeVersion 检查,只用于资源替换
-
Manually deleting the kubeVersion field from Chart.yaml
50% 失败
删除字段后安装可能成功,但 Chart 可能依赖集群特性导致运行时错误