KubePodImagePullBackOff: что делать при алерте

Правило алерта

alert: KubePodImagePullBackOff
expr: kube_pod_container_status_waiting_reason{reason=~"ImagePullBackOff|ErrImagePull"} == 1
for: 10m
severity: warning

Сообщение алерта: Pod {{ $labels.namespace }}/{{ $labels.pod }} не может скачать образ

Что значит

Контейнер не может получить образ из реестра (ErrImagePull / ImagePullBackOff) уже 10 минут.

Частые причины

Опечатка в имени или теге образа, образа нет в реестре, нет прав (не задан или протух imagePullSecret), реестр недоступен или лимиты на скачивание, нет сети на узле.

Диагностика

kubectl -n <ns> describe pod <pod>              # сообщение об ошибке в Events
kubectl -n <ns> get pod <pod> -o jsonpath='{.spec.containers[*].image}'
kubectl -n <ns> get secret                      # imagePullSecrets
ssh <узел> 'crictl pull <образ>'

Как исправить

Исправить имя/тег, пересоздать секрет доступа к реестру (kubectl create secret docker-registry ...) и указать его в imagePullSecrets, проверить доступность реестра с узла.

Когда можно заглушить

Нельзя, пока приложение не запущено.