Provision
—— XP

Практика: пройти запрос по слоям

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

Карту слоёв из урока проще всего запомнить, пройдя её руками на живом стенде. Сейчас всё работает — и это правильный момент: ты увидишь, как выглядит норма на каждом слое. В аварии будет с чем сравнить.

По ходу записывай результат каждого шага в файл ~/devops-lab/reports/layers.txt — по строке на слой. Получится карта стенда, по которой дежурный пройдёт тот же путь за пять минут.

Шаг 1. Подготовка

Работаем из каталога стенда. Длинный адрес и путь к сертификату удостоверяющего центра положим в переменные шелла, чтобы команды остались короткими.

ubuntu@stand:~$
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.

ubuntu@stand:~$
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 — какая программа.

ubuntu@stand:~$
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 — напечатать результат.

ubuntu@stand:~$
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.

ubuntu@stand:~$
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. Сколько осталось сертификату

Сертификат сейчас принят, но когда он истечёт? Перейдём в каталог с ним — так команда проверки останется короткой.

ubuntu@stand:~$
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 оставит две колонки — имя и состояние.

ubuntu@stand:~$
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- — напечатать ответ на экран, а не сохранять в файл.

ubuntu@stand:~$
docker compose exec proxy wget -qO- app:8000/health
ok

Запиши: Приложение: Up (healthy), из прокси по app:8000 ok.

Шаг 9. Что видит прокси

Последние строки лога прокси показывают, как проходят запросы. Флаг --tail 3 — три последних строки.

ubuntu@stand:~$
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: проверяет, принимает ли база соединения.

ubuntu@stand:~$
docker compose exec db pg_isready
/var/run/postgresql:5432 - accepting connections

accepting connections — база готова. Другие ответы: rejecting connections (запускается или выключается) и no response (не работает). Запиши: База: accepting connections.

Шаг 11. Карта

Открой файл и сверь, что в нём шесть строк — по одной на слой.

ubuntu@stand:~$
nano ~/devops-lab/reports/layers.txt
~/devops-lab/reports/layers.txt
DNS: 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 от прокси.

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

Проверять каждый слой запроса одной командой и знать, как на твоём стенде выглядит норма.

  • Слой DNS записан
  • Слой порта записан
  • Все шесть слоёв в карте
  • Стенд отвечает через прокси
  • База принимает соединения
Команда сдачи — выполни на своей машине
команда
cat ~/devops-lab/reports/layers.txt; echo ---; cd ~/infra/stand 2>/dev/null || echo NOSTAND; echo "HEALTH=$(curl -sS -o /dev/null -w '%{http_code}' --cacert ~/devops-lab/tls/ca.crt https://stand.provision.internal:8443/api/health)"; docker compose exec -T db pg_isready

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