Provision
—— XP

Практика: под и его разбор

практика~25 минут+625 XP

Под — первое, что ты увидишь в кластере, и первое, что сломается. В этой практике ломать будешь сам: так ты узнаешь две самые частые поломки в лицо раньше, чем встретишь их в работе.

Поды здесь создаются командой kubectl run — без файла и без контроллера. Так делают только для проб и отладки, и в конце практики ты увидишь почему.

Шаг 1. Запустить под

Запусти под с веб-сервером nginx — тем самым, что ты настраивал в разделе 05.

ubuntu@stand:~$
kubectl run web --image=nginx:1.30
ubuntu@stand:~$
pod/web created

Параметр --image задаёт образ. Кластер сам скачает его из Docker Hub на тот узел, куда планировщик поставит под.

Шаг 2. Посмотреть, как он поднимается

Сразу после создания под проходит несколько состояний. Посмотри на них в реальном времени.

ubuntu@stand:~$
kubectl get pods -w
ubuntu@stand:~$
NAME   READY   STATUS              RESTARTS   AGE
web    0/1     ContainerCreating   0          2s
web    1/1     Running             0          9s

Флаг -w не выходит и дописывает строку при каждом изменении; выйти — Ctrl+C. ContainerCreating — узел выбран, образ скачивается. 1/1 Running — контейнер работает.

Шаг 3. На каком узле

Узнай, куда планировщик поставил под.

ubuntu@stand:~$
kubectl get pods -o wide
ubuntu@stand:~$
NAME   READY   STATUS    RESTARTS   AGE   IP          NODE
web    1/1     Running   0          40s   10.42.1.5   k3d-stand-agent-0

Адрес 10.42.1.5 — внутренний, из сети кластера: с твоей машины по нему не достучаться. Узел — один из рабочих.

Шаг 4. Подробности

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

ubuntu@stand:~$
kubectl describe pod web
ubuntu@stand:~$
Name:         web
Node:         k3d-stand-agent-0/172.18.0.4
Status:       Running
Containers:
  web:
    Image:          nginx:1.30
    State:          Running
Events:
  Normal  Scheduled  60s  Successfully assigned provision/web to k3d-stand-agent-0
  Normal  Pulling    59s  Pulling image "nginx:1.30"
  Normal  Pulled     52s  Successfully pulled image "nginx:1.30"
  Normal  Started    52s  Started container web

В событиях вся жизнь пода по шагам: назначен на узел, образ скачан, контейнер запущен. Все строки Normal — значит, всё шло по плану.

Шаг 5. Внутрь

Зайди в контейнер и спроси nginx изнутри.

ubuntu@stand:~$
kubectl exec -it web -- sh
ubuntu@stand:~$
# curl -s localhost | grep title
<title>Welcome to nginx!</title>
# exit

Флаги -i и -t дают терминал, -- отделяет команду для контейнера. Внутри пода nginx отвечает на localhost — у пода свой адрес и своя сеть.

Шаг 6. Сломать образом

Запусти под с тегом, которого не существует. Так ошибаются в номере версии каждый день.

ubuntu@stand:~$
kubectl run broken --image=nginx:9.9.9
ubuntu@stand:~$
pod/broken created

Шаг 7. Увидеть поломку

Посмотри на список через полминуты.

ubuntu@stand:~$
kubectl get pods
ubuntu@stand:~$
NAME     READY   STATUS             RESTARTS   AGE
broken   0/1     ImagePullBackOff   0          35s
web      1/1     Running            0          3m

ImagePullBackOff значит: образ не скачался, и кластер делает паузы между попытками, всё длиннее и длиннее. Первые секунды вместо этого бывает ErrImagePull — это то же самое, только до паузы.

Шаг 8. Найти причину

Логов здесь нет: контейнер не запускался. Причина — в событиях.

ubuntu@stand:~$
kubectl describe pod broken | tail -5
ubuntu@stand:~$
  Warning  Failed   20s  Failed to pull image "nginx:9.9.9": not found
  Warning  Failed   20s  Error: ErrImagePull
  Normal   BackOff  5s   Back-off pulling image "nginx:9.9.9"
  Warning  Failed   5s   Error: ImagePullBackOff

tail -5 оставляет пять последних строк — как раз события. Слова not found говорят прямо: такого тега нет. Если бы было unauthorized, дело было бы в доступе к реестру, а i/o timeout — в сети узла.

Шаг 9. Сломать командой запуска

Второй вид поломки: образ есть, контейнер стартует и тут же падает. Запусти busybox — крошечный образ с базовыми командами — с файлом, которого нет.

ubuntu@stand:~$
kubectl run crash --image=busybox -- sh config.sh
ubuntu@stand:~$
pod/crash created

Всё после -- — команда для контейнера вместо той, что задана в образе.

Шаг 10. Увидеть падения по кругу

Подожди минуту и посмотри снова.

ubuntu@stand:~$
kubectl get pods
ubuntu@stand:~$
NAME     READY   STATUS             RESTARTS      AGE
broken   0/1     ImagePullBackOff   0             3m
crash    0/1     CrashLoopBackOff   3 (25s ago)   70s
web      1/1     Running            0             6m

CrashLoopBackOff — контейнер стартует, падает, кластер перезапускает его с растущей паузой. Счётчик RESTARTS растёт. Повтори команду пару раз — статус будет переключаться между CrashLoopBackOff (пауза перед новой попыткой) и Error (попытка только что упала): это одна и та же поломка. Это другая поломка, и ищут её в другом месте.

Шаг 11. Найти причину падения

Здесь логи есть: контейнер успевал стартовать. Но нужен журнал прошлого запуска.

ubuntu@stand:~$
kubectl logs crash --previous
ubuntu@stand:~$
sh: line 0: can't open config.sh: no such file

Флаг --previous показывает журнал предыдущей попытки — той, что упала. Причина названа: нет файла. Запомни пару: не стартовал — describe, стартовал и упал — logs --previous.

Если вместо ошибки пришло unable to retrieve container logs for containerd://…, ты попал в момент, когда get pods показывает у crash статус Error: последняя попытка только что упала, а журнал той, что была перед ней, кластер уже убрал. Подожди, пока статус снова станет CrashLoopBackOff, и повтори. Наш контейнер падает мгновенно, поэтому здесь и обычный kubectl logs crash покажет ту же ошибку — последняя попытка ничего, кроме неё, не успевает написать. У настоящего приложения, которое проработало час и упало, это не так: после перезапуска обычный logs покажет свежий запуск, и причина останется только в --previous.

Шаг 12. Удалить под без контроллера

Удали рабочий под и посмотри, что будет.

ubuntu@stand:~$
kubectl delete pod web
ubuntu@stand:~$
pod "web" deleted
ubuntu@stand:~$
kubectl get pods
ubuntu@stand:~$
NAME     READY   STATUS             RESTARTS      AGE
broken   0/1     ImagePullBackOff   0             5m
crash    0/1     CrashLoopBackOff   5 (40s ago)   3m

web исчез и не вернулся: за подом, созданным через run, никто не следит. Ровно то же случилось бы, если бы выключился его узел. Верни его командой из шага 1 перед сдачей — и запомни, почему в работе поды так не создают.

После сдачи убери за собой: kubectl delete pod web broken crash.

Что дальше

Под, за которым никто не следит, исчезает навсегда. Следующий урок — про Deployment, который держит нужное число подов и сам их пересоздаёт.

Практика 02+625 XP

Отличать под, который не скачал образ, от пода, который падает при старте, и находить причину каждого через describe и logs --previous.

  • Рабочий под запущен
  • Под с несуществующим образом разобран
  • Падающий под разобран
  • Причина падения найдена
Команда сдачи — выполни на своей машине
команда
kubectl -n provision get pods; kubectl -n provision logs crash

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.