Debugging checklist

docker ps -a --filter name=ИМЯ --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'
docker inspect ИМЯ --format '{{.State.Status}} {{.State.ExitCode}} {{.State.OOMKilled}}'
docker logs --tail 50 ИМЯ

# 1. С ошибкой или сделал работу и вышел?
docker inspect ИМЯ --format '{{.State.ExitCode}}'

# 2. Код 0: приложение действительно завершилось само
docker logs ИМЯ

# 3. Ненулевой код: что сказало приложение
docker logs ИМЯ 2>&1 | tail -30

# 4. Точка входа: что вообще запускается
docker image inspect ОБРАЗ --format '{{json .Config.Entrypoint}} {{json .Config.Cmd}}'

# 5. Проверить руками
docker run --rm -it --entrypoint sh ОБРАЗ

# 1. Убит ядром?
docker inspect ИМЯ --format '{{.State.ExitCode}} {{.State.OOMKilled}}'

# 2. Подтверждение со стороны ядра
dmesg | grep -i 'killed process' | tail -5
docker events --filter 'event=oom' --since 24h

# 3. Давление памяти до отказа
docker exec ИМЯ cat /sys/fs/cgroup/memory.events

max 4213        ← процесс упирался в предел 4213 раз
oom_kill 3      ← убит 3 раза

# 4. Какой лимит применён на самом деле
docker exec ИМЯ cat /sys/fs/cgroup/memory.max
docker inspect ИМЯ --format '{{.HostConfig.Memory}}'

# 1. Приложение вообще работает?
docker inspect ИМЯ --format '{{.State.Status}}'
docker top ИМЯ

# 2. Буферизация вывода — самая частая причина у Python
docker inspect ИМЯ --format '{{json .Config.Env}}' | grep -o PYTHONUNBUFFERED=. || echo "не задан"

# 3. Проверить гипотезу
docker run --rm -e PYTHONUNBUFFERED=1 ОБРАЗ

# 4. Приложение пишет в файл вместо stdout?
docker diff ИМЯ | grep -i log

# 5. Драйвер журналирования сохраняет вывод?
docker inspect ИМЯ --format '{{.HostConfig.LogConfig.Type}}'

# 1. Порт действительно опубликован?
docker port ИМЯ

# 2. Слушает ли приложение — и на каком адресе
docker exec ИМЯ python -c "
import socket
for addr in ('127.0.0.1', '0.0.0.0'):
    s = socket.socket(); s.settimeout(1)
    print(addr, 'открыт' if s.connect_ex((addr, 8000)) == 0 else 'закрыт')"

# 3. Что приложение сказало при старте
docker logs --tail 30 ИМЯ | grep -i -E 'listen|bind|serving|started'

# 4. Дошёл ли запрос до container'а
docker logs -f ИМЯ &
curl -s -o /dev/null -w '%{http_code}\n' localhost:8080/

# 1. В одной ли сети
docker inspect ПЕРВЫЙ --format '{{json .NetworkSettings.Networks}}'
docker inspect ВТОРОЙ --format '{{json .NetworkSettings.Networks}}'

# 2. Разрешается ли имя
docker exec ПЕРВЫЙ getent hosts ВТОРОЙ

# 3. Доступен ли порт
docker exec ПЕРВЫЙ python -c "
import socket
s = socket.create_connection(('ВТОРОЙ', 5432), 2); s.close(); print('доступен')"

# 4. Что в строке подключения
docker inspect ПЕРВЫЙ --format '{{json .Config.Env}}' | tr ',' '\n' | grep -i url

# 1. Что именно вернула проверка
docker inspect ИМЯ --format '{{json .State.Health}}' | python3 -m json.tool

# 2. Выполнить проверку вручную
docker exec ИМЯ python -c "import urllib.request; print(urllib.request.urlopen('http://127.0.0.1:8000/healthz').status)"

# 3. Достаточно ли start-period
docker image inspect ОБРАЗ --format '{{json .Config.Healthcheck}}'
docker logs ИМЯ | head -20      # сколько занимает старт

# 1. От кого работает процесс
docker exec ИМЯ id

# 2. Кому принадлежит каталог
docker exec ИМЯ ls -ldn /путь

# 3. Что задано в образе
docker image inspect ОБРАЗ --format '{{.Config.User}}'

# 4. Что смонтировано
docker inspect ИМЯ --format '{{json .Mounts}}' | python3 -m json.tool

# 1. Где кэш перестаёт работать
docker build -t проба . 2>&1 | grep -n -E 'CACHED|^#[0-9]+ \[' | head -30

# 2. Проверка по времени
docker build -t проба . && touch src/*.py && time docker build -t проба .

# 3. Размер контекста сборки
docker build . 2>&1 | head -3     # строка «transferring context»
cat .dockerignore || echo ".dockerignore отсутствует"

# 1. Что занимает
docker system df -v | head -20

# 2. Логи container'ов — их в system df НЕТ
du -sh /var/lib/docker/containers/*/*-json.log 2>/dev/null | sort -h | tail -5

# 3. Кэш сборки
docker builder du 2>/dev/null || docker system df --format '{{.BuildCache}}'

docker builder prune                 # кэш сборки: безопасно
docker image prune                   # безымянные образы: почти безопасно
docker container prune               # остановленные container'ы
docker volume prune                  # ДАННЫЕ: посмотреть список до запуска

# 1. На каком образе работает container
docker inspect ИМЯ --format '{{.Image}}'

# 2. На что сейчас указывает тег
docker image inspect ОБРАЗ:ТЕГ --format '{{.Id}}'

# 3. Какой digest у локального образа
docker image inspect ОБРАЗ:ТЕГ --format '{{index .RepoDigests 0}}'

# 4. Какой digest в registry сейчас
docker buildx imagetools inspect ОБРАЗ:ТЕГ | grep -i digest

# 1. Кто такой PID 1
docker exec ИМЯ ps -eo pid,ppid,cmd

  PID  PPID CMD
    1     0 /bin/sh -c python app.py     ← оболочка: сигнал не дойдёт
    7     1 python app.py

# 2. Форма точки входа в образе
docker image inspect ОБРАЗ --format '{{json .Config.Entrypoint}} {{json .Config.Cmd}}'

# 3. Замер
docker run -d --name t ОБРАЗ && sleep 2 && time docker stop t