К содержимому
Войти

PHP Road Map

🔎 Как найти причину сбоя

Когда после выката API перестал отвечать, начни с наблюдений: какой образ запущен, готов ли Pod, были ли перезапуски и что происходило перед ошибкой. Lens и kubectl показывают одни и те же объекты через API Kubernetes. Они помогают найти причину, если проверять конкретную гипотезу, а не удалять Pod наугад

🧭 Сначала найди нужное окружение

Приложение может существовать сразу в staging и prod. Namespace разделяет именованные объекты внутри кластера, поэтому одинаковое имя user-service допустимо в разных namespace. Контекст kubectl определяет кластер и учётные данные; namespace сам по себе не означает отдельную машину или сетевую изоляцию

В своём учебном кластере проверь контекст и список Pod:

kubectl config current-context
kubectl -n staging get pods -o wide

В Lens сначала выбери кластер и namespace, затем Workloads → Pods. Сверь имя приложения, образ и время появления проблемного экземпляра. Если ошибка возникла после релиза, сравни новый Pod со старым: рабочая старая реплика не подтверждает исправность новой

Для следующих команд замени POD_NAME именем найденного Pod, а CONTAINER_NAME именем его контейнера. У Pod с sidecar это особенно важно: логи помощника не заменяют логи приложения

kubectl -n staging describe pod POD_NAME
kubectl -n staging logs POD_NAME -c CONTAINER_NAME --tail=100
kubectl -n staging logs POD_NAME -c CONTAINER_NAME --previous --tail=100
kubectl -n staging get events --sort-by=.metadata.creationTimestamp

Events объясняют действия Kubernetes: не удалось разместить Pod, скачать образ, подключить том или пройти пробу. Логи объясняют поведение процесса: не найден файл, неверный пароль, ошибка подключения. --previous запрашивает предыдущий завершившийся экземпляр контейнера, если его логи ещё доступны

Events и локальные логи не вечный архив. Если команда собирает их централизованно, для старого инцидента используй хранилище логов и временной диапазон релиза. Сохрани полезный текст ошибки до перезапуска или отката

⏳ Pending: контейнер ещё не дошёл до работы

Pod принят кластером, но пока не готов к запуску контейнеров. Это может включать ожидание размещения и подготовку окружения. Сначала посмотри поле Node и Events в describe

Если Node не выбран и есть FailedScheduling, прочитай причину: не хватает заявленных CPU/памяти, не подходят метки узлов, мешают taints или нет нужного тома. В упражнении слишком большой request не помещается ни на один узел. Свободная память по метрике «прямо сейчас» ещё не доказывает, что scheduler может выдать требуемые ресурсы

Если узел уже выбран, проверь скачивание образа, подключение томов и init-контейнеры. Логи основного приложения не помогут, пока оно ни разу не стартовало. Не увеличивай requests без проверки: так можно сделать размещение ещё труднее

🔄 CrashLoopBackOff: повторяется неудачный запуск

Контейнер завершается, Kubernetes повторяет запуск с задержкой между попытками. CrashLoopBackOff описывает ожидание перед новой попыткой, а не первопричину и не отдельную фазу Pod

Начни с Last State, Reason, exit code и логов предыдущего запуска. Затем сравни команду старта, образ, конфигурацию и пробы. В примере User Service 1.1.0 падает, потому что при сборке не добавили /app/config/routes.json

Удаление Pod не добавит файл в образ. Новый экземпляр того же Deployment получит ту же ошибку. Решение в упражнении: зафиксировать сообщение, вернуть рабочий образ и проверить завершение отката

📦 ImagePullBackOff: образ не скачан

Kubernetes не смог получить образ и откладывает повторную попытку. Начни с сообщения Events: оно поможет отличить неверный тег или repository от отказа авторизации, сетевой ошибки или ограничения registry

Сравни полную ссылку на образ с опубликованным артефактом. Для закрытого registry проверь привязку нужного image pull Secret в этом namespace и права на repository. Логи приложения обычно ещё пусты: контейнер не начал работу. Перезапуск без исправления ссылки или доступа только повторит попытку

🧠 OOMKilled: процесс остановлен из-за памяти

В Last State контейнера может стоять Reason: OOMKilled. Начни с memory limit, графика потребления перед остановкой и изменений в обработке данных. Причиной может быть слишком низкий лимит, утечка или большой разовый запрос

Увеличение лимита иногда временно восстанавливает работу, но требует свободных ресурсов и проверки причины роста. CPU limit обычно ограничивает скорость исполнения, а не вызывает OOM. Один exit code 137 без контекста ещё не доказывает нехватку памяти: смотри Reason и события узла

🩺 Running, но запросы не идут

Если контейнер не перезапускается, проверь Ready и ответ readiness. У Notification Service недоступная БД вызывает 503 на /ready, хотя процесс жив. Если все нужные Pod готовы, переходи к Service: selector, адресаты, targetPort, затем Ingress или Gateway

Сравни запрос через port-forward к одному Pod с обычным входом. Различие результатов помогает локализовать проблему, но не заменяет полную проверку маршрута

🎯 Вопросы с собеседований

Чем Events отличаются от логов?

Events показывают, что Kubernetes делал с объектом и почему действие не получилось. Логи выводит процесс контейнера. При ImagePullBackOff начну с Events, а при падении уже запущенного приложения посмотрю состояние завершения и логи, включая предыдущий запуск

Почему перезапуск не исправил CrashLoopBackOff?

Он снова запустил тот же образ с той же конфигурацией. Если в образе отсутствует файл, ошибка повторится. Я ищу причину завершения и исправляю артефакт или настройки, либо возвращаю известную рабочую версию

📚 Что почитать

К началу раздела Kubernetes · Дальше: Ресурсы и типы нагрузки