#码力全开·技术π对# Spinnaker部署Kubernetes应用时镜像拉取失败（ImagePullBackOff）的排查步骤？

Spinnaker部署Kubernetes应用出现​​ImagePullBackOff​​时，需系统排查镜像访问问题。步骤如下：

确认镜像名称与标签正确
检查Spinnaker管道中定义的镜像名（如​​gcr.io/project/app:v1.2​​）是否拼写正确，标签是否存在。

验证镜像仓库可访问性
在目标集群节点上手动执行：

docker pull gcr.io/project/app:v1.2

若失败，说明网络或认证问题。

检查Kubernetes Secret配置
若使用私有仓库（如Docker Hub、ECR），确保已创建​​imagePullSecret​​，并在Spinnaker部署配置中指定：

containers:
  - name: app
    image: private.registry/app:v1
imagePullSecrets:
  - name: regcred

验证服务账户权限
GKE中确保集群节点或Workload Identity绑定的服务账户具有​​roles/storage.objectViewer​​（用于GCR）或相应仓库读取权限。

查看Pod事件定位详情

kubectl describe pod <pod-name>

观察Events中具体错误（如​​Failed to pull image: unauthorized​​​或​​manifest unknown​​）。

检查镜像仓库位置与网络策略
跨区域拉取（如GCR多地域）可能受限，确保网络连通或使用就近镜像副本。

通过以上步骤可快速定位认证、权限或配置问题，恢复部署。