Azure Kubernetes集群Flux OCI拉取Helm Chart失败及路径未更新问题

核心问题 #

错误源于Helm仍在尝试从旧的HTTP仓库路径拉取Chart，而OCI格式仓库的结构与传统HTTP仓库完全不同，需同步更新仓库配置、推送路径及集群内的安装配置。

具体解决步骤 #

1. 清理旧仓库配置 #

先删除本地指向旧HTTP仓库的配置，避免路径冲突：

# 先查看现有仓库列表确认旧仓库名称
helm repo list
# 删除旧仓库
helm repo remove <旧仓库名称>

2. 添加新OCI仓库配置 #

用OCI格式添加目标仓库：

helm repo add <新仓库别名> oci://abc.azurecr.io/charts

示例（将新仓库别名为abc-charts）：

helm repo add abc-charts oci://abc.azurecr.io/charts

3. 确认Chart推送路径正确性 #

确保推送Chart时使用了正确的OCI路径，推送命令应为：

helm push abc-1.0.1.tgz oci://abc.azurecr.io/charts

推送完成后，可通过Azure CLI验证ACR中的Chart存在性：

az acr repository list --name abc --output table
# 检查是否存在charts/abc，且标签包含1.0.1
az acr repository show-tags --name abc --repository charts/abc --output table

4. 更新集群内的安装配置 #

如果是通过自动化工具（如Argo CD、Flux）部署，需检查：

• 工具的仓库配置已更新为oci://abc.azurecr.io/charts
• 安装配置中的Chart引用改为<新仓库别名>/abc:1.0.1，或直接使用完整OCI路径oci://abc.azurecr.io/charts/abc:1.0.1
• 确保集群服务账号拥有ACR的拉取权限（私有ACR需配置Azure AD角色或访问密钥）

5. 手动验证拉取与安装 #

在本地或集群节点测试拉取，确认路径与权限正常：

helm pull oci://abc.azurecr.io/charts/abc --version 1.0.1

拉取成功后执行安装：

helm install <发布名称> oci://abc.azurecr.io/charts/abc --version 1.0.1

常见注意事项 #

• OCI仓库路径格式为oci://<镜像仓库域名>/<仓库前缀>/<Chart名称>:<版本>，不要与传统HTTP仓库路径混淆
• 推送Chart时必须指定完整OCI前缀，否则会推送到默认路径导致无法找到
• 自动化工具可能缓存旧配置，需重启或刷新配置生效

内容的提问来源于stack exchange，提问作者Pratik Palashikar