Rак дебажить поды

Основные методы и инструменты для отладки Pod в Kubernetes

Отладка Pod в Kubernetes — комплексная задача, требующая системного подхода. Вот основные шаги и инструменты, которые я использую в своей практике.

Первичная диагностика состояния Pod

Первым делом всегда проверяю статус Pod и его контейнеров:

kubectl get pods <pod-name> -o wide --show-labels
kubectl describe pod <pod-name>

Команда describe показывает детальную информацию: события (Events), условия (Conditions), статусы контейнеров, причины остановок и сообщения об ошибках.

Анализирую логи контейнеров:

# Логи текущего контейнера
kubectl logs <pod-name>

# Логи предыдущего контейнера (если был рестарт)
kubectl logs <pod-name> --previous

# Логи конкретного контейнера в мультиконтейнерном Pod
kubectl logs <pod-name> -c <container-name>

# Логи в реальном времени
kubectl logs <pod-name> -f

Углубленный анализ проблем

Если стандартных логов недостаточно, перехожу к более детальным методам:

1. Диагностика проблем с образами контейнеров:

• Проверяю наличие образа в registry
• Анализирую политики образа (imagePullPolicy)
• Убеждаюсь в корректности тега

2. Анализ ресурсов и лимитов:

# Проверяю использование ресурсов
kubectl top pod <pod-name>

# Смотрю установленные limits/requests
kubectl describe pod <pod-name> | grep -A 5 "Limits\|Requests"

3. Проверка readiness/liveness проб:

• Анализирую конфигурацию проб в манифесте
• Проверяю логику работы эндпоинтов проб
• Тестирую пробу локально с помощью временного Pod

4. Отладка сетевых проблем:

# Проверяю DNS разрешение внутри Pod
kubectl exec <pod-name> -- nslookup <service-name>

# Тестирую сетевую связность
kubectl exec <pod-name> -- curl -v http://<service>:<port>

Расширенные техники отладки

1. Эфемерные отладочные контейнеры (Kubernetes 1.18+):

apiVersion: v1
kind: Pod
metadata:
  name: debug-pod
spec:
  ephemeralContainers:
  - name: debugger
    image: busybox
    command: ["sh"]
    stdin: true
    tty: true

2. Использование утилит отладки внутри контейнера:

# Устанавливаю отладочные инструменты в работающий Pod
kubectl exec -it <pod-name> -- apt-get update && apt-get install -y net-tools tcpdump curl

# Или использую отладочный образ
kubectl debug <pod-name> -it --image=nicolaka/netshoot -- sh

3. Анализ через временные Pod для тестирования: Создаю упрощенный Pod для изоляции проблемы:

apiVersion: v1
kind: Pod
metadata:
  name: test-pod
spec:
  containers:
  - name: test
    image: <base-image>
    command: ["sleep", "3600"]

Работа с мультиконтейнерными Pod

Для Pod с несколькими контейнерами важно:

1. Проверять логи каждого контейнера отдельно
2. Анализировать взаимодействие между sidecar-контейнерами
3. Проверять общие volumes и их монтирование

Инструменты мониторинга и трассировки

В сложных случаях подключаю дополнительные инструменты:

• kubectl debug для создания копии Pod с отладочными привилегиями
• Telepresence для локальной разработки и отладки
• Lens IDE или Octant для визуальной диагностики
• k9s как TUI для интерактивной работы

Методология решения проблем

Мой стандартный подход:

1. Быстрая диагностика через kubectl get и describe
2. Анализ логов всех контейнеров
3. Проверка зависимостей: ConfigMaps, Secrets, Volumes
4. Тестирование сетевой связности и сервис discovery
5. Воспроизведение проблемы в изолированной среде
6. Постепенное упрощение конфигурации для поиска корневой причины

Проактивные меры

Чтобы уменьшить необходимость отладки:

• Настраиваю полное логирование с корректными уровнями
• Реализую структурированные логи (JSON формат)
• Внедряю distributed tracing (Jaeger, OpenTelemetry)
• Настраиваю метрики приложения и readiness/liveness пробы
• Использую PodDisruptionBudgets для контроля доступности

Отладка Pod — это сочетание глубокого понимания Kubernetes, знания инструментов и системного подхода к анализу проблем. Ключевой момент — методичное исключение потенциальных причин, начиная с самых очевидных.