Docker推送至Azure ACR的镜像在门户显示无标签且清单被隔离求助
2026-6-29
Azure ACR推送镜像后标签不显示、清单隔离的解决思路
- 确认ACR地址格式：打标签时必须使用ACR的完整域名（例如
xxx.azurecr.io），避免简写或错误地址导致标签与镜像清单关联失败。 - 查看推送详细日志：执行
docker push --verbose registry/target:tag重新推送，通过 verbose 级别的输出确认清单和标签是否真正完成上传，排查隐性的上传异常细节。 - 检查镜像架构与清单类型：
- 用
docker inspect <本地镜像ID>查看本地镜像的架构信息，确认是否与ACR支持的架构匹配； - 执行
docker manifest inspect registry/target:tag查看本地缓存的清单内容，对比Azure门户中隔离的清单，判断是否存在格式不兼容问题（比如OCI与Docker V2清单的差异）。
- 用
- 清理缓存后重新推送：删除本地已关联的镜像标签
docker rmi registry/target:tag，重新登录ACR、打标签、推送，避免本地缓存干扰上传流程。 - 验证ACR权限：确认用于登录的账号拥有
AcrPush权限，权限不足可能导致标签无法正确关联到镜像清单。 - 手动修复清单关联：如果确认清单已成功上传，可尝试使用Azure CLI命令
az acr repository show-manifests --name <acr-name> --repository <repo-name>查看所有清单，再通过az acr repository update-manifest手动为隔离的清单绑定标签。
内容的提问来源于stack exchange，提问作者Saurabh Sheth
相关产品推荐
相关产品推荐
