使用Helm安装gitlab-runner Chart时提示仓库未找到该Chart的问题

问题描述 #

执行以下Helm命令安装gitlab-runner Chart时出现错误：

sudo helm install gitlab-runner gitlab/gitlab-runner --namespace gitlab --create-namespace --repo https://charts.gitlab.io

返回错误信息：

Error: INSTALLATION FAILED: chart "gitlab/gitlab-runner" not found in https://charts.gitlab.io repository

执行helm repo list确认gitlab仓库已正确添加到普通用户环境：

helm repo list
NAME    URL
jfrog   https://charts.jfrog.io/
gitlab  https://charts.gitlab.io

但使用sudo执行安装命令时，Helm仍无法找到该Chart。已尝试确认仓库URL正确、Chart确实存在于gitlab仓库，但问题未解决。

解决建议 #

• 验证sudo环境下的仓库配置：普通用户和root用户的Helm配置是独立的，执行以下命令确认sudo环境中是否已添加gitlab仓库：

  sudo helm repo list
  

  如果输出中没有gitlab仓库，需要用sudo重新添加：

  sudo helm repo add gitlab https://charts.gitlab.io
  

• 更新sudo环境的仓库缓存：仓库索引可能未同步，执行命令更新缓存：

  sudo helm repo update
  

• 指定具体Chart版本安装：先查看仓库中可用的gitlab-runner版本，再指定版本安装：

  # 查看可用版本
  sudo helm search repo gitlab/gitlab-runner --versions
  # 示例：指定v0.66.0版本安装
  sudo helm install gitlab-runner gitlab/gitlab-runner --namespace gitlab --create-namespace --version v0.66.0
  

• 同步Helm配置到root用户：普通用户的Helm配置（仓库索引等）存储在~/.config/helm/，root用户无法直接读取，可复制配置到root目录：

  sudo cp -r ~/.config/helm /root/.config/
  

• 直接使用Chart归档包安装：绕过仓库索引问题，直接下载指定版本的Chart包安装（替换<版本号>为实际版本）：

  sudo helm install gitlab-runner https://charts.gitlab.io/gitlab-runner-<版本号>.tgz --namespace gitlab --create-namespace
  

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