技術 · 實用指南
Kubernetes 出現 ImagePullBackOff?改 Secret 前先讀 Pod event
ImagePullBackOff 是 retry state,不是診斷。保存精確 event,再核 image identity、namespace Secret、node network、platform 與 runtime storage。

ImagePullBackOff 表示 kubelet 拉取失敗並退避重試。真正原因在 Pod 的 Failed event:image 名稱、權限、Secret、DNS/TLS、architecture 或 unpack/node resource。
保存實際部署的 image reference、namespace、node 與 message,只測一個 failure class;digest 拉取成功且 workload Ready 才結案。
保存 Pod、node 與 event
記錄 namespace、Pod、owner、container、node、精確 image 與最新 Failed message。
重建 Pod 只改 retry timing,不證明 registry 或 runtime 已修好。
先核 image identity
比較最終 Pod template 的 registry、repo、tag/digest 與實際 pushed artifact。
分開 not found、denied、platform mismatch,確認 manifest 支援 node architecture。
核同 namespace credential
只有 unauthorized 或 missing secret 才核 Secret 名稱、namespace、type 與 reference。
別輸出 credential;workstation login 不能證明 kubelet 權限。
測 node path 與 runtime
DNS、timeout、TLS、connection 要在失敗 node context 測,不要關閉 TLS。
unpack、disk、schema、architecture 要查 storage、runtime log、manifest。
單一修正與 exit test
只改 event 支持的事實,保存舊 manifest/metadata 供 rollback。
確認新 pull digest、舊 event 消失且 workload 在相關 node Ready。
