Карту слоёв из урока проще всего запомнить, пройдя её руками на живом стенде. Сейчас всё работает — и это правильный момент: ты увидишь, как выглядит норма на каждом слое. В аварии будет с чем сравнить.
По ходу записывай результат каждого шага в файл ~/devops-lab/reports/layers.txt — по строке на слой. Получится карта стенда, по которой дежурный пройдёт тот же путь за пять минут.
Шаг 1. Подготовка
Работаем из каталога стенда. Длинный адрес и путь к сертификату удостоверяющего центра положим в переменные шелла, чтобы команды остались короткими.
cd ~/infra/stand U=https://stand.provision.internal:8443 CA=~/devops-lab/tls/ca.crt
Переменные живут до закрытия окна терминала. Открыл новое — задай их снова.
Шаг 2. DNS
Первый слой — превращается ли имя в адрес. Имя стенда записано в файле /etc/hosts, а не на DNS-сервере, поэтому dig его не увидит: он спрашивает только DNS. getent hosts спрашивает систему так же, как это делают браузер и curl, — с учётом /etc/hosts.
getent hosts stand.provision.internal 127.0.0.1 stand.provision.internal
Адрес есть — слой в порядке. Пустой вывод означал бы, что дальше идти бесполезно. Запиши в карту строку вида DNS: 127.0.0.1 из /etc/hosts.
Шаг 3. Кто слушает порт
Второй слой со стороны машины: кто занял порт 8443. Флаги ss: -t — только TCP, -l — только слушающие, -n — числа вместо имён, -p — какая программа.
sudo ss -tlnp | grep 8443 LISTEN 0 4096 0.0.0.0:8443 0.0.0.0:* users:(("docker-proxy",pid=2817,fd=7))
Порт слушает docker-proxy — значит, его опубликовал контейнер прокси, как и задумано в разделе про Compose. Если бы здесь был nginx без docker-proxy, это был бы пакетный nginx на хосте, забытый при переезде.
Шаг 4. Порт со стороны клиента
Теперь то же снаружи: открывается ли соединение. Флаг -z у nc — проверить без отправки данных, -v — напечатать результат.
nc -zv stand.provision.internal 8443 Connection to stand.provision.internal (127.0.0.1) 8443 port [tcp/*] succeeded!
succeeded — сеть и порт в порядке. Запиши: Порт: 8443 слушает docker-proxy, nc succeeded.
Шаг 5. TLS и nginx
Один запрос проверяет сразу несколько слоёв: договорится ли шифрование, ответит ли прокси и передаст ли он запрос дальше. Флаг -I — только заголовки, -sS — без полоски загрузки, но с текстом ошибки, --cacert — какому удостоверяющему центру доверять.
Адрес — /api/health. В миссии раздела про Compose прокси получил ровно одно правило: всё, что начинается с /api/, отдавать приложению, отрезав приставку. Поэтому /api/health доходит до маршрута /health приложения, а голый /health прокси ищет у себя среди файлов сайта и отвечает 404.
curl -sSI --cacert $CA $U/api/health HTTP/1.1 200 OK Server: nginx/1.30.5 Date: Thu, 01 Oct 2026 11:20:04 GMT Content-Type: text/html; charset=utf-8 Content-Length: 2
Код 200 и Server: nginx: сертификат принят, прокси ответил и сходил к приложению. Номер версии после косой черты у тебя может быть другим. Запиши в карту две строки: TLS: принят и nginx: 200 на /api/health.
Забудешь --cacert — увидишь curl: (60) SSL certificate problem: self-signed certificate. Это не поломка стенда: сертификат самоподписанный, и без нашего удостоверяющего центра curl ему не верит.
Шаг 6. Сколько осталось сертификату
Сертификат сейчас принят, но когда он истечёт? Перейдём в каталог с ним — так команда проверки останется короткой.
cd ~/devops-lab/tls openssl x509 -enddate -noout -in stand.crt notAfter=Sep 29 10:12:44 2027 GMT
x509 — работа с сертификатом, -enddate — напечатать дату окончания, -noout — не печатать сам сертификат, -in — из какого файла. Допиши дату к строке TLS в карте и вернись в каталог стенда командой cd ~/infra/stand.
Шаг 7. Контейнеры
Следующий слой — приложение. Сначала состояние всех сервисов стенда: флаг -a покажет и завершившиеся, а --format оставит две колонки — имя и состояние.
docker compose ps -a --format '{{.Service}} {{.Status}}' app Up 2 hours (healthy) db Up 2 hours (healthy) migrate Exited (0) 2 hours ago proxy Up 2 hours
Норма такая: три сервиса работают, миграция завершилась с кодом 0. Пометка (healthy) есть только у тех, кому задана проверка здоровья: у базы — в описании Compose, у приложения — инструкцией HEALTHCHECK в образе. У прокси проверки нет, и для него норма — просто Up. Любое Restarting или Exited с кодом не ноль — повод идти в логи этого сервиса.
Шаг 8. Приложение напрямую
Проверим приложение мимо правил прокси — прямым запросом из контейнера прокси по имени сервиса. Так видно, слышит ли прокси приложение по сети. Если здесь ответ есть, а через /api/ нет, виновато правило в настройках nginx.
curl из контейнера приложения не подойдёт: образ собран на python:3.12-slim, и curl в нём нет, ответом будет executable file not found. Зато в образе nginx на Alpine есть маленький wget. Флаг -q — без служебных сообщений, -O- — напечатать ответ на экран, а не сохранять в файл.
docker compose exec proxy wget -qO- app:8000/health ok
Запиши: Приложение: Up (healthy), из прокси по app:8000 ok.
Шаг 9. Что видит прокси
Последние строки лога прокси показывают, как проходят запросы. Флаг --tail 3 — три последних строки.
docker compose logs --tail 3 proxy proxy-1 | 172.20.0.1 - - [01/Oct/2026:11:20:04 +0000] "HEAD /api/health HTTP/1.1" 200 0 "-" "curl/8.5.0" proxy-1 | 172.20.0.1 - - [01/Oct/2026:11:20:31 +0000] "GET /api/whoami HTTP/1.1" 200 71 "-" "curl/8.5.0"
Это стандартный формат журнала доступа nginx, своего мы не настраивали. Читается слева направо: адрес клиента, время в квадратных скобках, сам запрос в кавычках, код ответа, размер ответа в байтах и в конце программа, которая спрашивала. HEAD — это наш curl -I: он просит только заголовки, поэтому размер 0. В аварии здесь первым делом появится код 502 и строка ошибки — увидим в следующей практике.
Шаг 10. База
Последний слой. pg_isready — маленькая программа из комплекта PostgreSQL: проверяет, принимает ли база соединения.
docker compose exec db pg_isready /var/run/postgresql:5432 - accepting connections
accepting connections — база готова. Другие ответы: rejecting connections (запускается или выключается) и no response (не работает). Запиши: База: accepting connections.
Шаг 11. Карта
Открой файл и сверь, что в нём шесть строк — по одной на слой.
nano ~/devops-lab/reports/layers.txtDNS: 127.0.0.1 из /etc/hosts Порт: 8443 слушает docker-proxy, nc succeeded TLS: принят, истекает Sep 29 2027 nginx: 200 на /api/health Приложение: Up (healthy), из прокси по app:8000 ok База: accepting connections
Это и есть норма твоего стенда. В аварии ты пройдёшь те же шесть команд и увидишь, на какой строке ответ разошёлся с картой.
Что дальше
Норму знаем. Дальше — самый частый ответ, который разойдётся с картой: 502 от прокси.