使用Terraform的helm_release部署Keycloak时遇Chart.yaml缺失错误求助

问题核心 #

Terraform plan执行正常，但apply时提示Chart.yaml文件缺失，试过codecentric和bitnami仓库都出现这个问题，根源是helm拉取或解析chart的配置有误，或是本地缓存异常。

解决步骤 #

1. 修正Chart名称配置 #

你的chart字段写法错误：当通过repository指定仓库地址时，chart只需要写chart的纯名称，不需要带仓库前缀。比如codecentric的chart名就是keycloak，不是codecentric/keycloak。

修正后的codecentric仓库配置：

resource "helm_release" "keycloak" {
  name       = "keycloak"
  repository = "https://codecentric.github.io/helm-charts"
  version    = "15.0.2"
  chart      = "keycloak"  # 移除codecentric/前缀
  namespace  = "default"
  values     = [file("values.yml")]
}

如果改用bitnami仓库，配置示例：

resource "helm_release" "keycloak" {
  name       = "keycloak"
  repository = "https://charts.bitnami.com/bitnami"
  version    = "22.0.0"  # 替换为仓库中实际存在的版本
  chart      = "keycloak"
  namespace  = "default"
  values     = [file("values.yml")]
}

2. 清理Helm本地缓存 #

本地helm缓存的chart文件损坏也会引发这个错误，执行以下命令清理缓存后重新apply：

helm repo update
rm -rf ~/.cache/helm

3. 验证指定版本的Chart是否存在 #

确认你写的version在对应仓库中确实存在，比如查询codecentric仓库的Keycloak版本：

helm search repo codecentric/keycloak --versions

如果指定的版本不存在，换成列表里可用的版本号。

4. 检查values.yml文件路径 #

确保values.yml在Terraform执行的当前目录下，或者使用绝对路径。文件不存在或路径错误可能间接导致chart解析异常。

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