Google Cloud Deploy步骤0失败：Helm依赖构建报错求助

可能的原因及解决办法 #

1. Helm Chart依赖配置出问题 #

• 检查Chart.yaml里的dependencies字段，确认仓库地址、版本号无拼写错误，私有仓库需验证仓库存在且版本号有效。
• 本地先执行helm dependency build测试，快速定位是否为配置本身的问题。

2. Cloud Build服务账号权限不足 #

• Cloud Deploy触发的Cloud Build默认使用[PROJECT_NUMBER]@cloudbuild.gserviceaccount.com账号，它可能缺乏拉取Helm依赖的权限：
  • 若使用Google Artifact Registry的Helm仓库，给该账号添加Artifact Registry Reader角色；
  • 外部私有仓库需在Cloud Build步骤中配置凭证，比如helm repo add时附带用户名密码，或是挂载Secret。

3. Cloud Build环境缺少Helm或版本不兼容 #

• 默认Cloud Build镜像可能未安装Helm或版本不匹配，可自定义cloudbuild.yaml，先安装对应版本Helm再执行部署：

  steps:
    - name: 'gcr.io/cloud-builders/gcloud'
      entrypoint: 'bash'
      args:
        - '-c'
        - |
          curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash
          helm version
    - name: 'gcr.io/cloud-builders/gcloud'
      args: ['deploy', 'releases', 'create', 'my-release', '--delivery-pipeline=my-pipeline', '--region=us-central1']
  

4. 依赖缓存残留问题 #

• Cloud Build的缓存可能留存旧依赖，尝试先清理缓存再重新构建：

  helm dependency clean ./your-chart-dir && helm dependency build ./your-chart-dir
  

5. 开启调试日志获取详细错误 #

• 默认日志无足够细节，可添加--verbosity=debug参数执行部署命令，获取更完整的报错信息：

  gcloud deploy releases create my-release --delivery-pipeline=my-pipeline --region=us-central1 --verbosity=debug
  

额外提示 #

• 确认Helm Chart目录结构正确，Chart.yaml需放置在Chart根目录；
• 若使用Cloud Deploy自定义构建步骤，检查工作目录是否指向正确的Chart路径。

内容的提问来源于stack exchange，提问作者Jassim Abdul Latheef