使用overridevalue.yaml覆盖自定义Helm Chart配置时提示values.yaml不存在

触发场景 #

使用自定义overridevalue.yaml覆盖Helm Chart默认values.yaml配置，执行helm repo add添加对应Chart仓库后操作时触发该报错。

常见原因 #

• 执行命令的当前工作路径下不存在你指定的overridevalue.yaml文件，或文件路径填写错误
• 你添加的Helm仓库中对应Chart包结构不完整，根目录缺失values.yaml文件
• 执行helm install/helm upgrade指定自定义values文件时参数格式错误

排查步骤 #

• 校验本地自定义values文件路径
  执行如下命令确认指定的overridevalue.yaml真实存在，建议使用绝对路径指定文件避免相对路径寻址错误：

# 校验文件存在
ls /path/to/your/overridevalue.yaml
# 正确的values覆盖安装示例
helm install <your-release-name> <repo-name>/<chart-name> -f /path/to/your/overridevalue.yaml

• 校验仓库Chart包完整性
  拉取对应Chart到本地解压检查结构是否完整：

# 拉取Chart包并解压
helm pull <repo-name>/<chart-name> --untar
# 进入解压后的Chart目录检查是否存在values.yaml
cd <chart-dir-name>
ls | grep values.yaml

如果确认Chart包缺失values.yaml，需联系Chart维护者补全包结构后重新上传至仓库。

• 校验仓库配置正确性
  确认仓库地址添加正确且索引已更新到最新版本：

# 查看已添加的仓库列表
helm repo list
# 更新仓库索引
helm repo update

内容的提问来源于stack exchange，提问作者Onur AKKÖSE