Урок 9 из 10Диагностика

14 мин · теория и практика · Продвинутые

CrashLoopBackOff: конфигурация и перезапуски

Найди причину завершения контейнера и выбери между исправлением конфигурации и откатом.

Сможешь сопоставить логи, конфигурацию Deployment и историю изменения без бесконечного удаления подов.

CrashLoopBackOff показывает, что контейнер повторно завершается и очередной запуск отложен. Это описание поведения, а не диагноз. Ошибка в конфигурации, памяти или проверке жизнеспособности требует разных действий. Учебные Kubernetes-кейсы используют ограниченную симуляцию: она подходит для диагностики их манифестов, но не заменяет полноценный кластер.

Прочитай состояние и последние сообщения

Получив список Pod, возьми фактическое имя и посмотри describe и logs. В настоящем кластере logs --previous полезен для предыдущего завершившегося контейнера; учебный CLI поддерживает документированный набор команд. Ищи первую содержательную ошибку до завершения процесса.

Команды
kubectl get pods
kubectl describe pod <pod-name>
kubectl logs <pod-name>

Замени <pod-name> именем из get pods. Не вводи угловые скобки как часть команды.

Проверь конфигурацию, которую получает приложение

Сопоставь env, ссылки на ConfigMap и параметры запуска Deployment с сообщением приложения. Наличие ConfigMap ещё не доказывает наличие нужного ключа или допустимого значения. Не публикуй Secret: для диагноза обычно достаточно имени ключа и факта его наличия.

Команды
kubectl get configmap api-config -o yaml
kubectl rollout history deployment/api

В настоящем кластере дополнительно прочитай kubectl get deployment api -o yaml. Учебный CLI CrashLoop ограничен командами, перечисленными в его справке.

Выбери исправление по происхождению изменения

Откат Deployment меняет его шаблон, но не обязан вернуть отдельно отредактированную ConfigMap. Проверь историю и то, где именно произошло изменение. Если конфигурацию поправили вручную, откат не того объекта не исправит значение, получаемое приложением.

Команды
kubectl rollout history deployment/api

Учебный кейс даёт диагностические данные для своих вариантов. В реальном Kubernetes история ConfigMap не является встроенным аналогом rollout history Deployment.

Не смешивай readiness и причины рестарта

Неудачная readiness проверка сама по себе не перезапускает контейнер: она исключает его из обычного трафика Service. Неудачная liveness или startup probe может привести к перезапуску. OOMKilled требует исследования памяти; Configuration error — прежде всего параметров приложения.

Нельзя заменять диагностику удалением probe или увеличением памяти для любой ошибки. Исправление должно соответствовать причине завершения.

Проверь новый запуск и готовность

После изменения дождись Ready, проверь rollout status там, где команда поддерживается, и наблюдай счётчик рестартов. Он не должен продолжать расти. Затем проверь клиентский маршрут: Ready без рабочего запроса ещё не подтверждает восстановление сервиса.

Команды
kubectl wait --for=condition=Ready pod -l app=api --timeout=60s
kubectl get pods

У разных учебных CLI набор команд ограничен. При отсутствии вспомогательной команды используй get/describe/logs и проверку бизнес-запроса, а не считай отсутствие инструмента новой аварией.

От симптома к проверке

НаблюдениеСледующая проверкаКак читать результат
CrashLoopBackOff + Configuration errorlogs и ConfigMap/envНайди параметр, который приложение не принимает.
Running 0/1, no restartsReadiness и endpoint приложенияГотовность к трафику и перезапуск — разные механизмы.
Откат не меняет ошибкуИсточники конфигурации и изменённый объектConfigMap могла измениться независимо от Deployment.

Типовые ошибки

  • Удалять Pod снова и снова, не читая его первую ошибку.
  • Откатить Deployment, предполагая автоматический откат любой ConfigMap.
  • Удалить probe вместо проверки причины отказа.

Как доказать восстановление

  1. Проверь параметры, которые получает новый экземпляр.
  2. Дождись Ready и прекращения роста счётчика рестартов.
  3. Посмотри свежие логи после исправления.
  4. Проверь нужный клиентский маршрут и все ожидаемые экземпляры.

МИНИ-ИНЦИДЕНТ

Почему новый Pod падает так же?

После удаления Pod новый экземпляр пишет ту же Configuration error. Значение изменили в ConfigMap вручную; шаблон Deployment не менялся. Какую историю и данные сравнишь?

Данные для разбора
Deployment template: unchanged
ConfigMap setting: recently edited
new Pod: same Configuration error
Разобрать ход диагностики

Сравни актуальную ConfigMap с ожидаемым контрактом приложения и первой ошибкой в логах. История Deployment сама по себе не объясняет отдельное изменение конфигурации. После согласования значения проверь, что новый запуск получает его и остаётся Ready.

ПРАКТИКУМ

Практикум: объясни данные и выбери действие

После пересоздания Pod причина вернулась. Сравни runtime-объект и источник его конфигурации.

Учебные данные
restart count: 12
last log: invalid DATABASE_URL
ConfigMap api-config: DATABASE_URL=malformed-value
  1. Почему новый Pod повторяет тот же отказ?

    Сверить рассуждение

    Он снова получает ту же конфигурацию из источника. Удаление экземпляра меняет процесс, но не исправляет декларативный контракт, который контроллер воспроизводит.

  2. Как разделить readiness и причину завершения?

    Сверить рассуждение

    Журнал и состояние завершения объясняют exit приложения. Readiness определяет готовность получать трафик; её отказ сам по себе не является правилом рестарта процесса.

  3. Какой результат важнее одного статуса Running?

    Сверить рассуждение

    Устойчивый Ready, отсутствие новых рестартов, корректная конфигурация и запрос через ожидаемый маршрут. В симуляции проверяй поддерживаемые команды, а в настоящем кластере учитывай rollout и контроллер.

ПРОВЕРЬ СЕБЯ

Почему rollout undo Deployment может не исправить сломанную ConfigMap?

Показать объяснение

Конфигурация могла измениться отдельно от шаблона Deployment. Найди изменённый объект и значение, которое реально читает приложение; затем проверь новый запуск.

Документация

Гостевой прогресс хранится отдельно в этом браузере.

ТЕПЕРЬ В КОНСОЛЬ

Закрепи на инциденте

Останови цикл падений, сохрани корректные проверки готовности и докажи восстановление запроса.

ПОМОГЛО РАЗОБРАТЬСЯ?

Как тебе материал?

Оцени статью или напиши, где не хватило объяснения. Это поможет улучшить обучение.

Полезно 0 Не помогло 0

Войди, чтобы оценить статью и оставить комментарий.

Обсуждение

0

Войти в обсуждение →

Пока без комментариев. Поделись первым впечатлением или задай вопрос по теме.