使用Terraform部署Jenkins时下载Bitnami Helm Chart失败求助

本质原因 #

本地单独执行helm install能正常安装，是因为本地helm客户端已经预先同步过bitnami仓库索引、缓存了目标Chart的元数据；但Terraform的helm_release资源运行时，是通过内置的Helm Provider客户端发起请求，完全不会复用本机helm的缓存或已配置的repo信息，它的请求上下文完全由Provider自身初始化参数决定，因此会出现本地操作正常、Terraform执行报错的差异。 #

分步解决操作 #

1. 匹配Terraform v0.12.18对应的Helm Provider版本 #

Terraform v0.12.18为已停止维护的老旧版本，可适配的最高版本Helm Provider为v1.2.5，更高版本的Provider（v2.x及以上）已完全不兼容该版本Terraform核心。

• 新增/修改versions.tf文件，显式锁定兼容版本：

terraform {
  required_version = "= 0.12.18"
  required_providers {
    helm = {
      source  = "hashicorp/helm"
      version = "1.2.5"
    }
  }
}

• 执行terraform init重新拉取对应版本的Provider缓存，避免自动拉取不兼容高版本导致的逻辑异常。

2. 显式在Helm Provider配置中注册bitnami仓库 #

旧版本Helm Provider不会自动感知本机已添加的repo，需要在Provider配置块中显式传入仓库信息，触发Terraform侧的helm客户端提前同步repo索引：

provider "helm" {
  kubernetes {
    config_path = "~/.kube/config"
  }
  # 显式将bitnami repo加入Provider上下文
  repository {
    name = "bitnami"
    url  = "https://charts.bitnami.com/bitnami"
  }
}

配置完成后执行terraform init -upgrade生效，再重新执行apply操作。

3. 绕过repo索引同步逻辑，直接指定Chart完整地址 #

如果上述配置后仍报下载错误，可以跳过Terraform侧的repo索引拉取步骤，直接将Chart的完整TGZ地址作为参数传入，和你本地直接访问URL下载的逻辑保持一致：

resource "helm_release" "jenkins-master" {
  name       = "jenkins"
  # 替换为已验证可访问的完整Chart压缩包地址
  chart      = "https://charts.bitnami.com/bitnami/jenkins-7.0.3.tgz"
  repository = ""

  set {
    name  = "jenkinsUser"
    value = "admin"
  }
  set {
    name  = "jenkinsPassword"
    value = "admin"
  }
}

4. 排查Terraform进程的网络上下文差异 #

本地helm进程可能已经配置了全局代理、企业SSL证书信任，但运行terraform apply的当前shell会话如果没有继承相同的配置，会导致Terraform内置的helm客户端访问目标URL失败：

• 执行apply前，在当前shell会话显式导出和本地helm一致的代理环境变量：
• export HTTPS_PROXY=<本地helm使用的代理地址>
• export NO_PROXY=<集群内网网段地址>
• 如果存在企业自签名SSL证书，需要提前将证书文件路径赋值给SSL_CERT_FILE环境变量，避免客户端证书校验失败。

额外校验点 #

• 当前使用的terraform apply -input=false provision-plan 命令存在路径指向问题，正常Terraform的apply命令需要传入计划文件的完整相对/绝对路径，正确写法为terraform apply -input=false ./provision-plan，路径错误会导致Provider无法读取之前初始化的本地缓存，触发下载失败。
• 避免直接照搬新版Terraform的Helm Provider配置逻辑，v0.12对应的旧版Provider语法和v2+版本差异极大，部分新版参数在旧版本中完全不生效。

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