You need to enable JavaScript to run this app. Azure AKS部署应用时出现ImagePullBackOff镜像拉取失败问题求助
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 04:51:02