使用Helm3从Bitnami安装RabbitMQ时出现chart.metadata is required错误

我之前在使用旧版本Terraform和Helm时也碰到过类似的问题，咱们一步步来排查修复：

错误原因分析 #

这个错误提示说明Helm无法获取到有效的Chart元数据，结合你的配置来看，大概率是这两个原因导致的：

• 适配Terraform 0.12.x的旧版Helm Provider，对直接在helm_release里指定仓库URL的支持不够稳定，拉取Chart时出现元数据解析失败
• 配置里的Namespace存在硬编码和变量引用不一致的问题（虽然不是直接触发错误的原因，但会引发后续部署隐患）

修复方案 #

1. 显式添加Helm仓库资源 #

在你的Terraform配置里新增helm_repository资源来管理Bitnami仓库，替代直接在helm_release里写URL的方式，旧版本Provider对这种方式的兼容性更好：

# 新增Bitnami仓库配置
resource "helm_repository" "bitnami" {
  name = "bitnami"
  url  = "https://charts.bitnami.com/bitnami"
}

2. 修正helm_release配置 #

更新helm_release资源，引用上面的仓库名称，同时统一Namespace的引用方式（和Secret保持一致）：

resource "helm_release" "rabbitmq" {
  chart       = "rabbitmq"
  name        = "rabbitmq"
  version     = "8.6.1"
  timeout     = 600
  # 引用已配置的仓库名称，而非直接写URL
  repository  = helm_repository.bitnami.metadata[0].name
  # 和Secret的Namespace保持一致，避免部署到错误空间
  namespace   = kubernetes_namespace.kylas_sales.metadata[0].name
  # 依赖新增的仓库资源，确保仓库先被添加完成
  depends_on  = [kubernetes_secret.rabbitmq_load_definition, helm_repository.bitnami]
}

3. 额外验证步骤 #

• 先手动确认Chart版本存在：在本地执行helm search repo bitnami/rabbitmq --versions，检查8.6.1是否在版本列表中
• 锁定Provider版本适配：因为你用的是Terraform 0.12.18，建议在配置里指定兼容的Provider版本，避免版本不兼容问题：

terraform {
  required_providers {
    helm = {
      source  = "hashicorp/helm"
      version = "~> 1.2.0"
    }
    kubernetes = {
      source  = "hashicorp/kubernetes"
      version = "~> 1.13.0"
    }
  }
}

测试部署 #

完成配置修改后，执行以下命令验证：

terraform init
terraform plan

确认没有错误后，再执行terraform apply部署RabbitMQ。

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