Provision
—— XP

Поломка: 502 от прокси

практика~30 минут+725 XP

Сейчас ты сломаешь собственный стенд — нарочно и дважды. Это самый быстрый способ узнать поломку в лицо: когда то же самое случится в бою, ты вспомнишь не абзац из урока, а строку, которую сам видел в логе.

Первая поломка — приложение остановлено. Вторая — прокси настроен на порт, где никого нет. Снаружи обе выглядят одинаково: 502. Отличить их помогает только лог ошибок, и в этом весь смысл практики.

Шаг 1. Норма

Задай переменные, как в прошлой практике, и проверь, что стенд отвечает.

ubuntu@stand:~$
cd ~/infra/stand
U=https://stand.provision.internal:8443
CA=~/devops-lab/tls/ca.crt

Флаг -I у curl — только заголовки, -sS — без полоски загрузки, но с текстом ошибки, --cacert — наш удостоверяющий центр. В выводе здесь и дальше оставлены только нужные строки заголовков.

ubuntu@stand:~$
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. Первая поломка

Останавливаем приложение. Прокси при этом продолжает работать.

ubuntu@stand:~$
docker compose stop app

Шаг 3. Симптом

Повторяем тот же запрос.

ubuntu@stand:~$
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 — три последних строки.

ubuntu@stand:~$
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 покажет и остановленные контейнеры.

ubuntu@stand:~$
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. Починить

Запускаем приложение обратно.

ubuntu@stand:~$
docker compose start app

Подожди, пока проверка здоровья станет healthy, — секунд пятнадцать, — и повтори запрос из шага 1. Должно снова быть 200. Если вместо этого всё ещё 502, ты поймал ловушку с запомненным адресом из урока: перечитай настройки прокси командой docker compose exec proxy nginx -s reload.

Шаг 7. Вторая поломка

Теперь испортим настройки прокси. Открой nginx/stand.conf редактором nano и в блоке upstream поменяй порт приложения:

nginx/stand.conf, блок 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 оставит нужную строку.

ubuntu@stand:~$
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 — он ничего не применяет, только ищет ошибки.

ubuntu@stand:~$
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 проверяет, что настройки написаны правильно, а не что они верны. Неправильный порт он не заметит. Перечитываем:

ubuntu@stand:~$
docker compose exec proxy nginx -s reload

Шаг 9. Симптом тот же

Снаружи всё выглядит точно как в первый раз.

ubuntu@stand:~$
curl -sSI --cacert $CA $U/api/whoami
HTTP/1.1 502 Bad Gateway
Server: nginx/1.30.5

Если бы ты лечил по симптому, ты бы сейчас перезапустил приложение — и ничего бы не изменилось, потому что оно работает.

Шаг 10. Причина другая

Снова лог ошибок прокси:

ubuntu@stand:~$
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. Следующий урок — про машину под приложением: заполненный диск, нехватку памяти и процессор, занятый на сто процентов.

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

Находить причину ответа 502 по строке в логе ошибок прокси, а не перезапуском всего подряд.

  • Записана причина первой поломки
  • Записана причина второй поломки
  • Стенд починен
  • Неверный порт убран из настроек
  • Прокси видит исправленный файл
Команда сдачи — выполни на своей машине
команда
cat ~/devops-lab/reports/502.txt; echo ---; cd ~/infra/stand 2>/dev/null || echo NOSTAND; echo "CODE=$(curl -sS -o /dev/null -w '%{http_code}' --cacert ~/devops-lab/tls/ca.crt https://stand.provision.internal:8443/api/whoami)"; echo "BADPORT=$(grep -c 'app:8001' nginx/stand.conf)"; echo "LIVE=$(docker compose exec -T proxy grep -c 'app:8001' /etc/nginx/conf.d/stand.conf)"

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