Provision
—— XP

Практика: nginx перед двумя копиями приложения

практика~35 минут+350 XP

До сих пор nginx отдавал файлы с диска. Теперь за ним встанет приложение — две его копии, как это и бывает в работе. Писать приложение не будем: возьмём готовый маленький веб-сервер, встроенный в Python, он уже встречался в разделе про сети.

Продолжаем на сайте stand.provision.internal из прошлой практики. Работай в tmux из раздела про Linux: копии приложения будут жить в фоне этого окна, и при обрыве SSH без tmux они умрут вместе с ним. Понадобятся три вещи, которые узнают обычно только на проде: что приложение видит через прокси, как выглядит отказ одной копии и что получает пользователь, когда упали все.

Шаг 1. Каталоги для двух копий

Каждая копия будет отдавать свою страницу, чтобы было видно, кто ответил. Флаг -p у mkdir создаёт недостающие каталоги по пути.

ubuntu@stand:~$
mkdir -p ~/devops-lab/app-a ~/devops-lab/app-b

Шаг 2. Страница каждой копии

Знак > записывает вывод echo в файл, это разбирали в разделе про Linux.

ubuntu@stand:~$
echo "app A" > ~/devops-lab/app-a/index.html
echo "app B" > ~/devops-lab/app-b/index.html

Шаг 3. Запустить копии

Встроенный сервер Python отдаёт файлы из текущего каталога. Перейдём в каталог первой копии.

ubuntu@stand:~$
cd ~/devops-lab/app-a

Запускаем на порту 8000. Флаг -b задаёт адрес: 127.0.0.1 значит «только для этой машины», снаружи копию не увидеть. Знак & в конце отправляет программу в фон, и терминал остаётся свободным.

ubuntu@stand:~$
python3 -m http.server 8000 -b 127.0.0.1 &
ubuntu@stand:~$
[1] 5120
Serving HTTP on 127.0.0.1 port 8000 (http://127.0.0.1:8000/) ...

[1] — номер фоновой задачи, 5120 — номер процесса. Номер задачи живёт только в этом окне, поэтому останавливать копии будем по имени, через pkill. Теперь вторая копия на 8001.

ubuntu@stand:~$
cd ~/devops-lab/app-b
ubuntu@stand:~$
python3 -m http.server 8001 -b 127.0.0.1 &
ubuntu@stand:~$
[2] 5121
Serving HTTP on 127.0.0.1 port 8001 (http://127.0.0.1:8001/) ...

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

Шаг 4. Спросить копию напрямую

Прежде чем ставить прокси, убедимся, что копия сама отвечает.

ubuntu@stand:~$
curl http://127.0.0.1:8000/
ubuntu@stand:~$
127.0.0.1 - - [01/Oct/2026 10:30:12] "GET / HTTP/1.1" 200 -
app A

Первая строка — журнал копии: запрос GET / пришёл и получил 200. Вторая — сам ответ. Если копия не отвечает напрямую, через nginx она не ответит тем более.

Шаг 5. Прокси к одной копии

Начнём с самого простого прокси — к одной копии. Открой файл сайта из прошлой практики.

ubuntu@stand:~$
sudo nano /etc/nginx/sites-available/provision

Внутри блока server, перед блоком location /, добавь новый location.

внутри server, перед location /
    location /api/ {
        proxy_pass http://127.0.0.1:8000/;
    }

location /api/ ловит все адреса, которые начинаются с /api/, а proxy_pass пересылает такой запрос копии на порту 8000 и возвращает её ответ пользователю. Сохрани файл: в nano это Ctrl+O, Enter, затем Ctrl+X. Как всегда, сначала проверка, потом применение.

ubuntu@stand:~$
sudo nginx -t
ubuntu@stand:~$
nginx: configuration file /etc/nginx/nginx.conf test is successful
ubuntu@stand:~$
sudo systemctl reload nginx

Флаг -s у curl убирает служебный шум.

ubuntu@stand:~$
curl -s http://stand.provision.internal/api/
ubuntu@stand:~$
127.0.0.1 - - [22/Oct/2026 09:56:46] "GET / HTTP/1.0" 200 -
app A

Ответила копия A — запрос прошёл через nginx. Посмотри на строку журнала копии: пришёл GET /, а не GET /api/.

Шаг 6. Зачем слэш в конце

Отрезал /api/ слэш в конце proxy_pass. Проверим это на себе: убери последний слэш, чтобы строка стала proxy_pass http://127.0.0.1:8000;, сохрани, проверь и примени — те же nginx -t и reload.

ubuntu@stand:~$
curl -sI http://stand.provision.internal/api/
ubuntu@stand:~$
127.0.0.1 - - [22/Oct/2026 09:56:47] "HEAD /api/ HTTP/1.0" 404 -
HTTP/1.1 404 File not found
Server: nginx/1.24.0 (Ubuntu)

Флаг -I просит только заголовки ответа — в первой строке код. Без слэша nginx передаёт путь как есть, копия получила GET /api/ — а такого файла у неё нет, отсюда 404. Со слэшем префикс location заменяется на путь из proxy_pass. Верни слэш на место, проверь и примени.

Шаг 7. Группа из двух копий

Одна копия — одна точка отказа: упадёт она, упадёт и сайт. Опишем группу из двух. В самое начало файла, выше блока server, вставь блок upstream.

в начало файла
upstream app {
    server 127.0.0.1:8000;
    server 127.0.0.1:8001;
}

upstream — группа серверов с именем, здесь app. Её место снаружи server: ошибка "upstream" directive is not allowed here значит, что блок попал внутрь. Теперь направь /api/ на группу — в proxy_pass вместо адреса копии впиши имя группы, слэш сохраняется.

в location /api/
        proxy_pass http://app/;

Проверь и примени, а потом спроси /api/ несколько раз подряд: стрелка вверх и Enter.

ubuntu@stand:~$
curl -s http://stand.provision.internal/api/
ubuntu@stand:~$
app B

Ответы приходят то от A, то от B — nginx раздаёт запросы по кругу. Строго через одну они идут, только если у nginx один рабочий процесс. На машине с несколькими ядрами процессов несколько, у каждого свой круг, и подряд может прийти «A, A, B, A» — это нормально: обе копии в работе.

Шаг 8. Что видит приложение

Приложению нужно знать, на какой сайт пришли и с какого адреса. Посмотрим, что nginx ему передаёт. Поможет программа nc (netcat): она слушает порт и печатает всё, что пришло. Добавь в server ещё один, отладочный location — рядом с /api/.

внутри server, перед location /api/
    location /debug/ {
        proxy_pass http://127.0.0.1:8002/;
    }

Проверь и примени. Флаг -l у nc значит «слушать», дальше адрес и порт отладочного location.

ubuntu@stand:~$
nc -l 127.0.0.1 8002 &

Ответа nc не пришлёт, поэтому флаг -m 2 велит curl сдаться через две секунды.

ubuntu@stand:~$
curl -s -m 2 http://stand.provision.internal/debug/
ubuntu@stand:~$
GET / HTTP/1.0
Host: 127.0.0.1:8002
Connection: close
User-Agent: curl/8.5.0
Accept: */*

Это ровно тот запрос, который получает приложение. В Host — не имя сайта, а адрес копии, и о клиенте ни слова: для приложения все запросы пришли от самого nginx. Сайт с несколькими доменами не поймёт, какой из них открыли, а журнал приложения будет полон одинаковых 127.0.0.1. Останавливать nc не нужно: когда curl сдался, nginx закрыл соединение, и nc завершился сам — шелл скажет об этом строкой Done.

Шаг 9. Передать заголовки

Исправим. Внутри блока server, сразу после строки index index.html;, добавь четыре заголовка. Написанные на уровне server, они действуют во всех location с proxy_pass внутри него.

внутри server, после index
    proxy_set_header Host              $host;
    proxy_set_header X-Real-IP         $remote_addr;
    proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;

Host — имя сайта из запроса пользователя. X-Real-IP — адрес клиента. X-Forwarded-For — цепочка адресов, если прокси несколько. X-Forwarded-Proto — пришли по HTTP или HTTPS, это понадобится в уроке про HTTPS. Проверь, примени и повтори опыт с nc.

ubuntu@stand:~$
nc -l 127.0.0.1 8002 &
ubuntu@stand:~$
curl -s -m 2 http://stand.provision.internal/debug/
ubuntu@stand:~$
GET / HTTP/1.0
Host: stand.provision.internal
X-Real-IP: 127.0.0.1
X-Forwarded-For: 127.0.0.1
X-Forwarded-Proto: http
Connection: close
User-Agent: curl/8.5.0

Теперь приложение знает имя сайта, адрес клиента и схему. Адрес клиента здесь 127.0.0.1, потому что curl запущен на той же машине; запрос с другого компьютера показал бы его адрес.

Шаг 10. Уронить одну копию

Теперь ломаем. Останови копию B. pkill ищет процесс, флаг -f велит сверять всю строку запуска, а не только имя программы, — так найдётся именно копия на порту 8001.

ubuntu@stand:~$
pkill -f "http.server 8001"

Спроси /api/ несколько раз.

ubuntu@stand:~$
curl -s http://stand.provision.internal/api/
ubuntu@stand:~$
app A

Сколько ни повторяй — отвечает только A, и ошибок пользователь не видит. А nginx записал, что случилось, в журнал ошибок. Флаг -n 1 у tail — последняя строка.

ubuntu@stand:~$
sudo tail -n 1 /var/log/nginx/error.log
ubuntu@stand:~$
... connect() failed (111: Connection refused) while connecting to upstream, ... upstream: "http://127.0.0.1:8001/"

Connection refused — порт 8001 никто не слушает. По полю upstream видно, какая именно копия упала.

Шаг 11. Уронить все копии

Останови и копию A.

ubuntu@stand:~$
pkill -f "http.server 8000"
ubuntu@stand:~$
curl -I http://stand.provision.internal/api/
ubuntu@stand:~$
HTTP/1.1 502 Bad Gateway
Server: nginx/1.24.0 (Ubuntu)

Вот как выглядит полный отказ: nginx жив и отвечает сам, но за ним никого нет. А /health по-прежнему отдаёт ok — его формирует nginx, без приложения. Запомни это различие: 502 значит «чинить приложение, а не nginx».

Шаг 12. Поднять копии обратно

Для сдачи обе копии должны работать. Повтори шаг 3: перейди в каталог и запусти копию, сначала A, потом B. Тот же шаг пригодится, если ты вернулся после перерыва: проверь ss -tln | grep 800 — нет строк с 8000 и 8001, значит копии умерли вместе с прошлой сессией, подними их снова.

ubuntu@stand:~$
cd ~/devops-lab/app-a
ubuntu@stand:~$
python3 -m http.server 8000 -b 127.0.0.1 &

То же для копии B в ~/devops-lab/app-b на порту 8001. После этого снова проверь шаг 7: отвечают обе копии.

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

  • Как nginx ведёт себя, если одна копия в upstream упала?
    Не дозвонившись, пробует следующую и выводит упавшую из ротации на fail_timeout, по умолчанию 10 секунд. Причина пишется в error.log.
  • Пользователи видят 502. Что делать первым?
    Открыть error.log nginx: там адрес upstream и причина — Connection refused, timeout или обрыв. 502 почти всегда значит, что упало приложение, а не nginx.
  • Почему приложение слушает только 127.0.0.1?
    Чтобы к нему нельзя было прийти в обход прокси и обойти TLS, лимиты и журнал.
Практика 02+350 XP

Настроить proxy_pass к группе из двух копий приложения, передать заголовки клиента и узнать в лицо отказ одной копии и всех сразу.

  • Конфигурация проходит проверку
  • Запросы расходятся по двум копиям
  • Группа описана через upstream
  • proxy_pass ведёт на группу со слэшем
  • Имя сайта передаётся приложению
  • Адрес клиента передаётся приложению
Команда сдачи — выполни на своей машине
команда
sudo nginx -t 2>&1 | tail -1; for i in $(seq 10); do curl -s http://stand.provision.internal/api/; done; sudo nginx -T 2>/dev/null | grep -E 'upstream|server 127|proxy_'

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