{
  "id": "kubernetes/helm-upgrade-failed-api-version-removed",
  "signature": "Error: UPGRADE FAILED: failed to install CRD: unable to recognize \"\": no matches for kind \"CustomResourceDefinition\" in version \"apiextensions.k8s.io/v1beta1\"",
  "signature_zh": "错误：升级失败：安装 CRD 失败：无法识别 \"\"：在版本 \"apiextensions.k8s.io/v1beta1\" 中找不到类型 \"CustomResourceDefinition\"",
  "regex": "no matches for kind \"CustomResourceDefinition\" in version \"apiextensions\\.k8s\\.io/v1beta1\"",
  "domain": "kubernetes",
  "category": "config_error",
  "subcategory": null,
  "root_cause": "The Helm chart references an old API version (v1beta1) that was removed in Kubernetes 1.22+, causing CRD installation to fail.",
  "root_cause_type": "generic",
  "root_cause_zh": "Helm chart 引用了旧版 API（v1beta1），该版本在 Kubernetes 1.22+ 中被移除，导致 CRD 安装失败。",
  "versions": [
    {
      "version": "Helm v3.12.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Helm v3.13.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Kubernetes v1.25.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Kubernetes v1.28.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "Downgrading the Kubernetes cluster to an older version to support v1beta1",
      "why_fails": "Downgrading a cluster is complex and risky; it's better to update the chart.",
      "fail_rate": 0.95,
      "condition": "",
      "sources": []
    },
    {
      "action": "Manually editing the cluster's API server flags to re-enable v1beta1",
      "why_fails": "The v1beta1 CRD API was fully removed in 1.22+; no flag can restore it.",
      "fail_rate": 1.0,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Update the Helm chart to use apiextensions.k8s.io/v1: run `helm pull chart-name --untar`, edit the CRD YAML to change `apiVersion: apiextensions.k8s.io/v1beta1` to `apiVersion: apiextensions.k8s.io/v1`, then `helm upgrade --install` with the local chart.",
      "success_rate": 0.9,
      "how": "Update the Helm chart to use apiextensions.k8s.io/v1: run `helm pull chart-name --untar`, edit the CRD YAML to change `apiVersion: apiextensions.k8s.io/v1beta1` to `apiVersion: apiextensions.k8s.io/v1`, then `helm upgrade --install` with the local chart.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Use a newer version of the chart: `helm repo update && helm upgrade my-release chart-name --version <new-version>`.",
      "success_rate": 0.85,
      "how": "Use a newer version of the chart: `helm repo update && helm upgrade my-release chart-name --version <new-version>`.",
      "condition": "",
      "sources": []
    },
    {
      "action": "If the chart is unmaintained, convert CRDs manually using `kubectl convert` or a migration tool like `kubepug`.",
      "success_rate": 0.7,
      "how": "If the chart is unmaintained, convert CRDs manually using `kubectl convert` or a migration tool like `kubepug`.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "更新 Helm chart 使用 apiextensions.k8s.io/v1：运行 `helm pull chart-name --untar`，编辑 CRD YAML 将 `apiVersion: apiextensions.k8s.io/v1beta1` 改为 `apiVersion: apiextensions.k8s.io/v1`，然后使用本地 chart 执行 `helm upgrade --install`。",
    "使用更新版本的 chart：`helm repo update && helm upgrade my-release chart-name --version <新版本>`。",
    "如果 chart 不再维护，使用 `kubectl convert` 或迁移工具（如 kubepug）手动转换 CRD。"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://helm.sh/docs/topics/kubernetes_apis/#removed-apis",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.85,
  "fix_success_rate": 0.9,
  "resolvable": "true",
  "first_seen": "2023-06-10",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}