ImagePullBackOff (وقرينه ErrImagePull) يعني أنّ Kubernetes لم يستطع سحب صورة الحاوية. المشكلة في الوصول إلى الصورة، لا في تشغيلها. درس تشخيص يبني على الـ Pods.
ماذا يعني الخطأ؟
عند إنشاء pod، يحاول Kubernetes تنزيل صورة الحاوية من السجلّ (Registry). إن فشل التنزيل، يعلّق الـ pod بهذه الحالة ويعيد المحاولة بفواصل متزايدة.
الخطوة 1: اقرأ الأحداث
kubectl describe pod <اسم-الـ pod>
انظر إلى قسم Events في الأسفل — يذكر غالبًا السبب الدقيق (اسم غير موجود، رفض مصادقة، تعذّر الوصول للسجلّ).
الأسباب الشائعة وحلولها
- اسم أو وسم خاطئ: خطأ إملائي في اسم الصورة، أو وسم (tag) غير موجود مثل نسخة غير منشورة. الحلّ: تحقّق من الاسم والوسم الصحيحين في السجلّ (مثل Docker Hub).
- صورة في سجلّ خاصّ دون مصادقة: العنقود لا يملك بيانات اعتماد للسجلّ الخاصّ. الحلّ: أنشئ سرًّا من نوع
docker-registryواربطه عبرimagePullSecretsفي الـ pod. - السجلّ غير قابل للوصول: مشكلة شبكة أو عنوان سجلّ خاطئ. الحلّ: تأكّد من صحّة عنوان السجلّ ووصول العنقود إليه.
latestمضلّل: الاعتماد على الوسمlatestقد يجلب نسخة غير متوقّعة أو مفقودة. الحلّ: ثبّت وسمًا صريحًا (مثلnginx:1.27).
منهجية التشخيص
describe pod → اقرأ الأحداث → صنّف السبب (اسم/وسم؟ مصادقة؟ شبكة؟) → صحّح الصورة أو أضف بيانات اعتماد السجلّ.
الخطوات التالية
لتشخيص انهيار الحاوية بعد سحبها راجع CrashLoopBackOff، ولتشخيص الخدمات راجع خدمة غير قابلة للوصول.