Azure AKS部署应用时出现ImagePullBackOff镜像拉取失败问题求助
AKS 镜像拉取失败(ImagePullBackOff)排查方案
注意:你本地执行
az acr login成功仅代表当前本地账号有ACR操作权限,不代表AKS集群的kubelet服务账号有权限从ACR拉取镜像,这是该场景下最常见的错误原因。
1. 验证AKS与ACR的权限绑定配置
- 首先执行命令检查AKS是否有权限访问ACR:
az aks check-acr --name <AKS集群名称> --resource-group <集群所属资源组名称> --acr siddacr - 如果返回权限错误,执行官方绑定命令自动配置拉取权限:
az aks update -n <AKS集群名称> -g <集群所属资源组名称> --attach-acr siddacr
该命令会自动为AKS的kubelet身份分配ACR的AcrPull角色,无需手动创建镜像拉取Secret。
2. 校验Pod镜像地址配置
- 确认Deployment中填写的镜像地址格式完全符合要求:
<ACR名称>.azurecr.io/<镜像仓库名>:<镜像标签>,不得省略ACR域名,镜像标签需和你推送到ACR的标签完全一致(区分大小写)。 - 可先在本地执行拉取命令验证地址有效性:
docker pull <你配置的完整镜像地址>
如果本地拉取失败,优先修正Deployment中的镜像地址配置。
3. 排查Not Ready节点异常
节点处于Not Ready状态会直接影响Pod调度与镜像拉取,优先处理节点问题:
- 执行
kubectl describe node <异常节点名称>查看节点事件,确认是资源不足、kubelet服务异常还是网络故障导致节点不可用。 - 临时验证方案:给Deployment添加nodeSelector配置,将Pod调度到状态为Ready的正常节点,观察是否仍会抛出镜像拉取错误。
4. 排查集群出口网络限制
如果你的AKS集群配置了NSG、Azure防火墙或者自定义网络策略,需要确认节点可正常访问ACR:
- 登录到集群节点执行连通性测试:
curl https://siddacr.azurecr.io/v2/
正常返回401未授权代表网络连通正常,返回超时则说明ACR的443端口出向访问被拦截,需要调整网络规则放行。
5. 校验手动ImagePullSecret配置(如适用)
如果你没有使用AKS与ACR的自动绑定,而是手动创建了镜像拉取Secret:
- 确认Secret创建在Pod所属的同一个命名空间下
- 确认Deployment配置中已添加
imagePullSecrets字段,指向对应Secret名称 - 确认Secret中的凭证未过期,服务 principal 或仓库用户名密码配置正确。
内容的提问来源于stack exchange,提问作者ChallengeMe
相关产品推荐
相关产品推荐

