Сейчас ты сломаешь собственный стенд — нарочно и дважды. Это самый быстрый способ узнать поломку в лицо: когда то же самое случится в бою, ты вспомнишь не абзац из урока, а строку, которую сам видел в логе.
Первая поломка — приложение остановлено. Вторая — прокси настроен на порт, где никого нет. Снаружи обе выглядят одинаково: 502. Отличить их помогает только лог ошибок, и в этом весь смысл практики.
Шаг 1. Норма
Задай переменные, как в прошлой практике, и проверь, что стенд отвечает.
cd ~/infra/stand U=https://stand.provision.internal:8443 CA=~/devops-lab/tls/ca.crt
Флаг -I у curl — только заголовки, -sS — без полоски загрузки, но с текстом ошибки, --cacert — наш удостоверяющий центр. В выводе здесь и дальше оставлены только нужные строки заголовков.
curl -sSI --cacert $CA $U/api/whoami HTTP/1.1 200 OK Server: nginx/1.30.5 Content-Type: application/json
200 — точка отсчёта. Открой файл отчёта ~/devops-lab/reports/502.txt в отдельном окне: туда пойдут найденные строки.
Шаг 2. Первая поломка
Останавливаем приложение. Прокси при этом продолжает работать.
docker compose stop appШаг 3. Симптом
Повторяем тот же запрос.
curl -sSI --cacert $CA $U/api/whoami HTTP/1.1 502 Bad Gateway Server: nginx/1.30.5 Content-Type: text/html
Ответ может прийти не сразу, а секунды через три: столько nginx ждёт, пока сеть Docker признает, что по старому адресу никого нет. Изредка первый запрос висит целую минуту и приходит 504 Gateway Time-out — это та же поломка, просто сеть ещё помнила остановленный контейнер. Повтори запрос, и будет 502.
Ответил nginx — строка Server: nginx на месте. Значит, DNS, порт, TLS и сам прокси живы. Остаётся связь между прокси и приложением.
Шаг 4. Причина в логе
Смотрим, что nginx написал о неудаче. Флаг --tail 3 — три последних строки.
docker compose logs --tail 2 proxy proxy-1 | 2026/10/01 11:52:18 [error] 29#29: *14 connect() failed (113: Host is unreachable) while connecting to upstream, client: 172.20.0.1, server: stand.provision.internal, request: "HEAD /api/whoami HTTP/1.1", upstream: "http://172.20.0.4:8000/whoami", host: "stand.provision.internal:8443" proxy-1 | 172.20.0.1 - - [01/Oct/2026:11:52:18 +0000] "HEAD /api/whoami HTTP/1.1" 502 0 "-" "curl/8.5.0"
Строк две: лог ошибок и журнал доступа идут в один поток. Причина — connect() failed (113: Host is unreachable): по запомненному адресу 172.20.0.4 никого нет, и в конце строки виден порт 8000. Если ты поймал 504, строка будет upstream timed out (110…) — с тем же адресом и портом. Скопируй строку с [error] в отчёт целиком: по ней проверяется сдача.
Шаг 5. Подтвердить гипотезу
Гипотеза: приложение не работает. Проверка одной командой — флаг -a покажет и остановленные контейнеры.
docker compose ps -a app NAME SERVICE STATUS PORTS provision-app-1 app Exited (0) 40 seconds ago
Exited (0): контейнер остановлен штатно. docker compose stop послал главному процессу сигнал TERM — вежливую просьбу завершиться, — и gunicorn её выполнил: доделал запросы и вышел сам, с кодом 0. Код 143 был бы, если бы программа на TERM не ответила и её завершило ядро. Гипотеза подтвердилась.
Шаг 6. Починить
Запускаем приложение обратно.
docker compose start appПодожди, пока проверка здоровья станет healthy, — секунд пятнадцать, — и повтори запрос из шага 1. Должно снова быть 200. Если вместо этого всё ещё 502, ты поймал ловушку с запомненным адресом из урока: перечитай настройки прокси командой docker compose exec proxy nginx -s reload.
Шаг 7. Вторая поломка
Теперь испортим настройки прокси. Открой nginx/stand.conf редактором nano и в блоке upstream поменяй порт приложения:
upstream app_backend { server app:8001;
Было app:8000, стало app:8001. Это частая опечатка в жизни: приложение переехало на другой порт, а настройки прокси забыли.
Почему именно nano. Файл смонтирован в контейнер прокси отдельно, одной строкой ./nginx/stand.conf:… в compose.yaml, и Docker привязал к контейнеру не имя файла, а сам файл на диске. nano переписывает содержимое того же файла — контейнер видит правку. А sed -i и vim с настройками по умолчанию сохраняют новый файл под старым именем: на хосте правка есть, а контейнер продолжает читать старый. Проверить, что видит сам nginx, можно флагом -T — большая буква, в отличие от -t: он проверяет настройки и печатает их целиком, а grep оставит нужную строку.
docker compose exec proxy nginx -T | grep 'server app' nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful server app:8001;
Первые две строки grep не фильтрует: nginx пишет их в поток ошибок, мимо трубы. Смотри на третью.
Если здесь всё ещё app:8000, перезапусти прокси: docker compose restart proxy. При запуске Docker привяжет файл заново.
Шаг 8. Проверить и перечитать
Перед перечитыванием nginx всегда проверяют настройки флагом -t — он ничего не применяет, только ищет ошибки.
docker compose exec proxy nginx -t nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful
Синтаксис в порядке — и это важный урок: nginx -t проверяет, что настройки написаны правильно, а не что они верны. Неправильный порт он не заметит. Перечитываем:
docker compose exec proxy nginx -s reloadШаг 9. Симптом тот же
Снаружи всё выглядит точно как в первый раз.
curl -sSI --cacert $CA $U/api/whoami HTTP/1.1 502 Bad Gateway Server: nginx/1.30.5
Если бы ты лечил по симптому, ты бы сейчас перезапустил приложение — и ничего бы не изменилось, потому что оно работает.
Шаг 10. Причина другая
Снова лог ошибок прокси:
docker compose logs --tail 2 proxy proxy-1 | 2026/10/01 12:03:41 [error] 63#63: *31 connect() failed (111: Connection refused) while connecting to upstream, client: 172.20.0.1, server: stand.provision.internal, request: "HEAD /api/whoami HTTP/1.1", upstream: "http://172.20.0.4:8001/whoami", host: "stand.provision.internal:8443" proxy-1 | 172.20.0.1 - - [01/Oct/2026:12:03:41 +0000] "HEAD /api/whoami HTTP/1.1" 502 0 "-" "curl/8.5.0"
Теперь 111: Connection refused, и в конце видно порт 8001. Машина жива, но на этом порту никто не слушает. Приложение работает — проверь сам: docker compose ps app покажет Up. Скопируй строку в отчёт.
Шаг 11. Починить и проверить
Верни в nginx/stand.conf порт 8000 — тоже через nano, — проверь настройки и перечитай их — те же две команды, что в шаге 8. Затем запрос из шага 1 должен снова вернуть 200.
В отчёт допиши одну фразу о разнице: в первый раз приложение не работало, во второй работало, но прокси ходил не туда. Одинаковый код, разные причины, и различает их только строка в логе ошибок.
Что дальше
Не всякая поломка видна в nginx. Следующий урок — про машину под приложением: заполненный диск, нехватку памяти и процессор, занятый на сто процентов.