在Helm应用图表中添加GitLab托管的Library Chart依赖报错求助

你配置的repository地址是GitLab的网页浏览路径（/-/tree/main），Helm无法从这个网页地址获取仓库必需的index.yaml文件，直接导致拉取依赖失败。Helm要求仓库地址必须是能直接返回index.yaml内容的有效端点。

方案1：使用GitLab Package Registry托管Helm仓库（推荐） #

这是GitLab官方推荐的规范托管方式，支持版本管理、权限控制等功能：

1. 推送Library Chart到GitLab Package Registry
   • 登录GitLab Helm仓库（替换用户名和访问令牌）：

     helm registry login gitlab.com -u <你的GitLab用户名> -p <你的GitLab访问令牌>
     

   • 打包Library Chart：

     helm package ./helm-libraryChart
     

   • 推送包到GitLab OCI仓库（替换项目路径和版本号）：

     helm push helm-libraryChart-0.1.6.tgz oci://gitlab.com/<你的项目完整路径>
     

2. 修改应用图表的依赖配置
   更新Chart.yaml中的依赖项，使用OCI仓库地址：

   dependencies:
     - name: helm-libraryChart
       version: 0.1.6
       repository: oci://gitlab.com/<你的项目完整路径>
   

3. 重新构建依赖

   helm dependency build
   

方案2：直接使用Git仓库的Raw文件地址（快速测试场景） #

如果不想使用Package Registry，需确保Git仓库根目录已生成index.yaml（可通过helm repo index .命令生成，与chart包放在同一目录）：

1. 替换为正确的Raw地址
   将原地址中的/-/tree/main替换为/raw/main，示例：

   https://gitlab.com/....../helm-base/raw/main/
   

   这个地址可以直接返回根目录下的index.yaml文件内容。
2. 更新依赖配置

   dependencies:
     - name: helm-libraryChart
       version: 0.1.6
       repository: https://gitlab.com/....../helm-base/raw/main/
   

3. 更新仓库缓存并构建依赖

   helm repo update
   helm dependency build
   

• 若GitLab仓库是私有仓库，需为Helm配置认证：可通过helm repo add命令添加--username和--password参数，或使用GitLab访问令牌。
• 执行构建前，建议删除应用图表目录下的charts文件夹和Chart.lock文件，避免缓存干扰。

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