Provision
—— XP

Карта слоёв запроса

теория~6 минут+290 XP

Сайт не открывается, и первая мысль — открыть логи приложения. Иногда это полчаса впустую: запрос до приложения даже не дошёл, потому что имя не превратилось в адрес или истёк сертификат. Отладка начинается не с вопроса «что сломалось», а с вопроса «где искать».

Ответ на него даёт карта слоёв. Запрос пользователя — не одно действие, а цепочка: имя превращается в адрес, открывается соединение, договаривается шифрование, nginx принимает запрос, передаёт приложению, а оно идёт в базу. Каждое звено ты уже собирал руками в своих разделах курса. Карта раскладывает эту цепочку по порядку, с одной командой проверки на каждое звено, и каждая проверка отсекает всё, что выше или ниже.

Шесть слоёв

На стенде запрос проходит шесть слоёв. Порядок тот же, что в уроке про порядок диагностики из раздела про сети, только теперь к нему добавились nginx, контейнеры и база.

СлойВопросПроверка одной командой
DNSимя превращается в адрес?getent hosts stand.provision.internal
Сеть и портпорт открыт и отвечает?nc -zv stand.provision.internal 8443
TLSсертификат подходит и не истёк?curl -sSI по https
nginxпрокси принял запрос?логи прокси
Приложениеконтейнер жив и отвечает?docker compose ps, логи app
Базабаза принимает соединения?pg_isready

Возьмём вторую строку. nc (netcat) пробует открыть соединение с портом и ничего не отправляет. Флаг -z значит «только проверить, без данных», -v — печатать результат. Ответ succeeded значит, что сеть и порт в порядке, и дальше искать надо выше — в TLS или nginx.

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

Ошибка называет слой

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

Что пишет curlСлойЧто это значит
Could not resolve hostDNSимя не превратилось в адрес
Connection timed outсетьответа нет: файрвол, маршрут, машина выключена
Connection refusedпортмашина жива, но на порту никто не слушает
SSL certificate problemTLSсертификат истёк или ему не доверяют
HTTP 502 или 504nginx → приложениепрокси жив, приложение не ответило
HTTP 503приложение → базаприложение живо, но не достало то, от чего зависит
HTTP 500приложениеприложение ответило, но упало внутри

Посмотри на разницу третьей и второй строки. Refused приходит мгновенно — живая машина вежливо говорит «здесь никого нет». Timed out ждёт десятки секунд и не получает ничего: пакеты теряются по дороге. Первое ведёт к службе на машине, второе — к сети и файрволу.

И обрати внимание на три последние строки. Если пришёл любой HTTP-код, значит, DNS, сеть, порт и TLS уже работают — их можно не проверять вовсе. Код 503 (Service Unavailable, «сервис недоступен») на стенде отдаёт само приложение: адрес /items из раздела про Docker так отвечает, когда не может подключиться к базе.

Одна оговорка про сам curl. Флаг -s убирает полоску загрузки, но заодно глушит и текст ошибки: на экране пусто, и таблицу выше читать не по чему. Поэтому в отладке к нему всегда добавляют -S — «ошибки всё-таки показывай». Пишут слитно: curl -sS.

Как читать ответ

Чтобы увидеть код ответа, у curl есть флаг -I: он запрашивает только заголовки, без тела страницы. Флаги -sS — без полоски загрузки, но с текстом ошибки, если она будет.

ubuntu@stand:~$
curl -sSI https://example.ru/api/health
HTTP/2 502
server: nginx
date: Thu, 01 Oct 2026 11:05:12 GMT
content-type: text/html

Первая строка — версия протокола и код, здесь 502. Строка server: nginx говорит, кто ответил: именно nginx, а не приложение. Значит, DNS, порт, TLS и nginx живы, и поиск сужается до одного места — связи между прокси и приложением. Этому коду посвящён отдельный урок.

Сверху вниз или снизу вверх

Если ошибка ничего не подсказывает — например, страница грузится бесконечно, — идут по таблице слоёв по порядку, начиная с DNS. Каждая успешная проверка исключает свой слой. Первая неуспешная — это место поломки.

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

Словарь урока

Слой
Звено на пути запроса: DNS, сеть, TLS, прокси, приложение, база. ↩ к тексту
netcat (nc)
Утилита, которая открывает соединение с портом; -z проверяет без отправки данных.
Connection refused
Отказ от живой машины: на этом порту никто не слушает.
Connection timed out
Ответа нет совсем: пакеты теряются по дороге.

Что спросят на собеседовании

  • Пользователь пишет, что сайт не открывается. С чего начнёшь?
    Посмотрю, что отвечает curl. По тексту ошибки пойму слой: имя, сеть, порт, сертификат, прокси или приложение — и проверю его одной командой.
  • В чём разница между refused и timeout?
    Refused — машина ответила, что порт закрыт. Timeout — ответа нет вовсе: файрвол, маршрут или машина недоступна.
  • Если пришёл HTTP 502, нужно ли проверять DNS?
    Нет. Ответ пришёл от nginx, значит, имя, сеть, порт и TLS работают. Искать между прокси и приложением.

Что дальше

В практике пройдём весь путь запроса на своём стенде — по одной команде на слой — и составим карту стенда для дежурного.

Проверь себя+290 XPдве попытки
1
Шесть слоёв
В каком порядке идёт запрос пользователя на стенде?
2
Ошибка подсказывает слой
curl пишет «Could not resolve host». Где поломка?
3
Ошибка подсказывает слой
Чем «Connection refused» отличается от «Connection timed out»?
4
Ответы nginx
nginx ответил 502 Bad Gateway. Что это значит?
ответь на все вопросы, чтобы проверить

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