Provision
—— XP

Миссия: весь стенд одним описанием

практика~50 минут+425 XP

Стенд в контейнерах пока без входа для людей: приложение опубликовано только на петле, а nginx из раздела 05 живёт на хосте своей жизнью и обслуживает свои сайты на 443. Миссия — дать стеку собственный прокси внутри того же описания, с HTTPS на 8443, так чтобы весь стенд поднимался одной командой. Пакетный nginx при этом не трогаем: порты у них разные.

Это же описание дальше станет основой курса: рядом с ним в следующих разделах поднимутся база данных, мониторинг и сбор логов, а конвейер CI/CD будет выкатывать его сам.

Требования

Задача одна, проверяется по пунктам.

Что должно получиться
Четыре сервиса
db, migrate, app, proxy — в одном описании.
Одна точка входа
Наружу опубликован только proxy: 8443 и 8082. Приложение и база — нет.
Порядок по готовности
db healthy → migrate завершилась → app healthy → proxy.
TLS
Свой сертификат на stand.provision.internal, смонтирован только на чтение.
Серверный режим
COMPOSE_FILE в .env, override на сервере не подхватывается.
Паспорт
Документ: что где слушает, в каком порядке поднимается, чего намеренно нет.

Шаг 1. Сертификат для стенда

Для HTTPS прокси понадобится сертификат на имя stand.provision.internal. Выпустим его сразу, чтобы потом не отвлекаться. Он будет самоподписанным — подписанным самим собой, как snakeoil из раздела про nginx, но на нужное имя. Параметры удобнее держать в маленьком файле настроек, чем в одной длинной команде.

ubuntu@stand:~$
mkdir -p ~/devops-lab/tls
ubuntu@stand:~$
cd ~/devops-lab/tls
nano ~/devops-lab/tls/stand.cnf
[req]
prompt = no
encrypt_key = no
default_keyfile = stand.key
distinguished_name = dn
x509_extensions = ext
[dn]
CN = stand.provision.internal
[ext]
subjectAltName = DNS:stand.provision.internal

default_keyfile — куда положить новый ключ, encrypt_key = no — не закрывать его паролем, иначе nginx не сможет его прочитать без человека. subjectAltName — имя, для которого сертификат действителен; браузеры и curl смотрят именно сюда. Выпускаем: -x509 — сразу готовый сертификат, а не заявка, -days 365 — на год.

ubuntu@stand:~$
openssl req -x509 -config stand.cnf -days 365 -out stand.crt
ubuntu@stand:~$
.....+...........+.+...+...+++++++++++++++++++++++++++*..+....
-----

Строки из точек и плюсов — это openssl подбирает числа для ключа, так и должно быть. Проверим имя в сертификате.

ubuntu@stand:~$
openssl x509 -in stand.crt -noout -ext subjectAltName
ubuntu@stand:~$
X509v3 Subject Alternative Name:
    DNS:stand.provision.internal

Самоподписанный сертификат сам себе удостоверяющий центр. Клиенту, чтобы доверять стенду, нужен он же — положим копию под именем ca.crt, этим именем пользуются проверки и следующие разделы.

ubuntu@stand:~$
cp stand.crt ca.crt

Шаг 2. Имя стенда указывает на эту машину

Имя stand.provision.internal уже есть в /etc/hosts с раздела про nginx. Убедимся.

ubuntu@stand:~$
getent hosts stand.provision.internal
ubuntu@stand:~$
127.0.0.1       stand.provision.internal

Шаг 3. Самый простой прокси

Начнём с прокси, который просто передаёт запросы приложению, без HTTPS и всего остального. Конфигурация живёт в репозитории рядом с описанием.

ubuntu@stand:~$
mkdir -p ~/infra/stand/nginx

Группа серверов из одного сервиса app — как в практике про прокси в разделе nginx, только вместо адреса имя: прокси и приложение будут в одной сети проекта.

nano ~/infra/stand/nginx/stand.conf
upstream app_backend {
    server app:8000;
}

server {
    listen 8082;
    location / {
        proxy_pass http://app_backend/;
    }
}

Теперь сам сервис. Добавь его в раздел services файла compose.yaml, после db.

в compose.yaml, раздел services
  proxy:
    image: nginx:1.30-alpine
    ports:
      - "8082:8082"
    volumes:
      - ./nginx/stand.conf:/etc/nginx/conf.d/stand.conf
    networks:
      - stand

Файл конфигурации монтируется внутрь, в каталог, откуда nginx в образе читает настройки сайтов. Сеть stand — та же, что у приложения, иначе прокси не найдёт app по имени. Порт опубликован без адреса — на всех интерфейсах, потому что прокси и есть вход на стенд снаружи.

ubuntu@stand:~$
cd ~/infra/stand
ubuntu@stand:~$
docker compose up -d
ubuntu@stand:~$
[+] Running 4/4
 ✔ Container provision-proxy-1  Started
ubuntu@stand:~$
curl -s http://stand.provision.internal:8082/whoami
ubuntu@stand:~$
{"app":"stand","host":"c5ccde20246f","pid":8,"version":"1.0.0"}

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

ubuntu@stand:~$
docker compose logs --tail 1 proxy
ubuntu@stand:~$
proxy-1  | 192.168.64.1 - - [23/Oct/2026:10:45:19 +0000] "GET /whoami HTTP/1.1" 200 64 "-" "curl/8.5.0" "-"

Минимальный прокси работает. Дальше по одному добавляем то, что требует миссия.

Шаг 4. HTTPS

Добавь в nginx/stand.conf второй блок server: HTTPS на 8443, сертификат из смонтированного каталога. В корне — тот же сайт, что ты собрал в разделе про nginx, а запросы на /api/ уходят приложению.

nginx/stand.conf, в конец файла
server {
    listen 8443 ssl;
    server_name stand.provision.internal;
    ssl_certificate     /etc/nginx/tls/stand.crt;
    ssl_certificate_key /etc/nginx/tls/stand.key;
    root /var/www/provision;
    location /api/ {
        proxy_pass http://app_backend/;
        proxy_set_header Host      $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Прокси нужны порт 8443 и ещё два каталога: с сертификатом и с сайтом. Допиши их сервису proxy.

в compose.yaml, у сервиса proxy, в ports
      - "8443:8443"
в compose.yaml, у сервиса proxy, в volumes
      - ~/devops-lab/tls:/etc/nginx/tls
      - /var/www/provision:/var/www/provision
ubuntu@stand:~$
docker compose up -d
ubuntu@stand:~$
[+] Running 4/4
 ✔ Container provision-proxy-1  Started

Две переменные, чтобы команды проверки остались короткими: путь к сертификату, которому доверяем, и адрес стенда.

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

Сначала без сертификата — посмотрим, что скажет curl.

ubuntu@stand:~$
curl -sS $B/api/whoami
ubuntu@stand:~$
curl: (60) SSL certificate problem: self-signed certificate

curl не знает, кто подписал сертификат, и отказывается разговаривать. Флаг --cacert даёт ему файл, которому доверять.

ubuntu@stand:~$
curl -s --cacert $CA $B/api/whoami
ubuntu@stand:~$
{"app":"stand","host":"c5ccde20246f","pid":7,"version":"1.0.0"}

Другой путь — флаг -k, «не проверять сертификат вовсе». Он работает, но проверяет только то, что соединение есть, а не то, что на другом конце нужный сервер. Для проверки стенда это бессмысленно.

Шаг 5. HTTP ведёт на HTTPS

Блок на 8082 пока передаёт запросы приложению напрямую, без шифрования. Замени его целиком на перенаправление — тот же return 301, что в разделе про nginx, только на порт стенда.

nginx/stand.conf, вместо блока server на 8082
server {
    listen 8082;
    return 301 https://$host:8443$request_uri;
}

Правь файл редактором nano, а не sed -i: файл смонтирован в контейнер отдельно, и sed подменил бы его новым файлом, которого контейнер не увидит. Почему так — разберём в разделе про отладку. Контейнер пересоздавать не нужно: проверим новые настройки и попросим nginx их перечитать.

ubuntu@stand:~$
docker compose exec proxy nginx -t
ubuntu@stand:~$
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
ubuntu@stand:~$
docker compose exec proxy nginx -s reload
ubuntu@stand:~$
[notice] 42#42: signal process started

Флаг -I у curl запрашивает только заголовки, head -1 оставляет первую строку.

ubuntu@stand:~$
curl -sI http://stand.provision.internal:8082 | head -1
ubuntu@stand:~$
HTTP/1.1 301 Moved Permanently

Шаг 6. Свой ответ на «жив ли вход»

Если /api/ не отвечает, сразу непонятно, кто виноват — прокси или приложение. Добавим адрес, на который прокси отвечает сам, не спрашивая никого. Допиши в блок на 8443, перед закрывающей скобкой.

nginx/stand.conf, в блоке server на 8443
    location = /health {
        return 200 "ok
";
    }

Знак = — точное совпадение: этот блок отвечает только на /health, но не на /health/что-то. Перечитай настройки двумя командами из прошлого шага и проверь.

ubuntu@stand:~$
curl -s --cacert $CA $B/health
ubuntu@stand:~$
ok

Теперь остановим приложение и спросим оба адреса.

ubuntu@stand:~$
docker compose stop app
ubuntu@stand:~$
curl -sI --cacert $CA $B/api/whoami | head -1
ubuntu@stand:~$
HTTP/1.1 502 Bad Gateway
ubuntu@stand:~$
curl -s --cacert $CA $B/health
ubuntu@stand:~$
ok

502 на /api/ и ok на /health: вход жив, сломано то, что за ним. Одной парой запросов ты разделил две причины. Этим адресом пользуется раздел про отладку. Возвращаем приложение.

ubuntu@stand:~$
docker compose start app

Шаг 7. Только на чтение

Прокси смотрит в интернет, а смонтированные каталоги сейчас открыты ему на запись. Проверим: зайдём в контейнер и допишем строку в его конфигурацию изнутри. Команда sh после exec открывает оболочку внутри контейнера.

ubuntu@stand:~$
docker compose exec proxy sh
внутри контейнера
/ # echo '# чужая строка' >> /etc/nginx/conf.d/stand.conf
/ # exit
ubuntu@stand:~$
tail -1 nginx/stand.conf
ubuntu@stand:~$
# чужая строка

Строка появилась в файле на хосте, в твоём репозитории. Взломай кто-то прокси — сможет переписать свою конфигурацию и ключ. Убери эту строку из файла через nano и допиши :ro в конец всех трёх монтирований прокси.

в compose.yaml, у сервиса proxy
    volumes:
      - ./nginx/stand.conf:/etc/nginx/conf.d/stand.conf:ro
      - ~/devops-lab/tls:/etc/nginx/tls:ro
      - /var/www/provision:/var/www/provision:ro
ubuntu@stand:~$
docker compose up -d
ubuntu@stand:~$
[+] Running 4/4
 ✔ Container provision-proxy-1  Started

Та же попытка ещё раз, снова изнутри: docker compose exec proxy sh, затем строка ниже.

внутри контейнера
/ # echo x >> /etc/nginx/conf.d/stand.conf
sh: can't create /etc/nginx/conf.d/stand.conf: Read-only file system

Выйди из контейнера командой exit.

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

Шаг 8. Прокси ждёт приложение

Проверим стенд с нуля: снимем его целиком и поднимем.

ubuntu@stand:~$
docker compose down
ubuntu@stand:~$
[+] Running 5/5
 ✔ Container provision-proxy-1    Removed
 ✔ Container provision-app-1      Removed
 ✔ Container provision-migrate-1  Removed
 ✔ Container provision-db-1       Removed
 ✔ Network provision_stand        Removed
ubuntu@stand:~$
docker compose up -d
ubuntu@stand:~$
docker compose ps -a
ubuntu@stand:~$
NAME                  SERVICE   STATUS
provision-app-1       app       Up 1 second (health: starting)
provision-db-1        db        Up 7 seconds (healthy)
provision-migrate-1   migrate   Exited (0) 1 second ago
provision-proxy-1     proxy     Exited (1) 2 seconds ago

Прокси упал. Почему — в журнале.

ubuntu@stand:~$
docker compose logs proxy
ubuntu@stand:~$
proxy-1  | nginx: [emerg] host not found in upstream "app:8000" in /etc/nginx/conf.d/stand.conf:2

Прокси ни от кого не зависит и стартовал первым. nginx при запуске сразу ищет адрес имени app, а контейнера приложения ещё нет. Пусть ждёт здоровое приложение — проверка объявлена в его образе инструкцией HEALTHCHECK. Допиши сервису proxy.

в compose.yaml, у сервиса proxy
    depends_on:
      app:
        condition: service_healthy
    restart: unless-stopped

restart: unless-stopped — как у остальных постоянных сервисов: упавший прокси Docker поднимет сам. Он бы и без depends_on в итоге поднялся, после нескольких падений, но порядок по готовности чище, чем надежда на перезапуски.

ubuntu@stand:~$
docker compose down
ubuntu@stand:~$
[+] Running 5/5
 ✔ Container provision-proxy-1    Removed
 ✔ Container provision-app-1      Removed
 ✔ Container provision-migrate-1  Removed
 ✔ Container provision-db-1       Removed
 ✔ Network provision_stand        Removed
ubuntu@stand:~$
docker compose up -d
ubuntu@stand:~$
[+] Running 4/4
 ✔ Container provision-db-1       Healthy
 ✔ Container provision-migrate-1  Exited
 ✔ Container provision-app-1      Healthy
 ✔ Container provision-proxy-1    Started

Вся цепочка видна в выводе: база здорова, миграция отработала, приложение здорово, только потом прокси.

Шаг 9. Серверный режим

Пока что приложение ещё опубликовано на петле портом 8012 — это делает compose.override.yaml для разработки. На сервере набор файлов задают явно. Запишем его в .env — дальше работают обычные короткие команды, а override не подхватится.

ubuntu@stand:~$
echo 'COMPOSE_FILE=compose.yaml:compose.prod.yaml' >> .env

Проверь итог: в нём должно быть ровно две публикации, обе у прокси.

ubuntu@stand:~$
docker compose config | grep published
ubuntu@stand:~$
        published: "8082"
        published: "8443"

Вместе с набором файлов сменился и источник образа приложения: в серверном режиме app берётся из реестра по APP_IMAGE (шаг 5 практики про окружения), а не собирается из Dockerfile.

ubuntu@stand:~$
docker compose config app | grep -e image -e context
ubuntu@stand:~$
    image: localhost:5000/provision/app:1.0.0
    image: postgres:17-alpine
    image: postgres:17-alpine

Строки context нет: на сервере ничего не собирается. Применяем.

ubuntu@stand:~$
docker compose up -d
ubuntu@stand:~$
[+] Running 4/4
 ✔ Container provision-db-1       Healthy
 ✔ Container provision-migrate-1  Exited
 ✔ Container provision-app-1      Healthy
 ✔ Container provision-proxy-1    Running

Напрямую к приложению — ничего: 000 значит, что ответа не было вовсе, порт 8012 никто не слушает.

ubuntu@stand:~$
curl -s --max-time 3 -w '%{http_code}' localhost:8012
ubuntu@stand:~$
000

Шаг 10. Проверка с нуля

Главное свойство описания — поднимать систему, где ничего не запущено. Снимаем стек целиком, без -v: данные базы оставляем.

ubuntu@stand:~$
docker compose down
ubuntu@stand:~$
[+] Running 5/5
 ✔ Container provision-proxy-1    Removed
 ✔ Container provision-app-1      Removed
 ✔ Container provision-migrate-1  Removed
 ✔ Container provision-db-1       Removed
 ✔ Network provision_stand        Removed
ubuntu@stand:~$
docker compose up -d
ubuntu@stand:~$
[+] Running 4/4
 ✔ Container provision-db-1       Healthy
 ✔ Container provision-migrate-1  Exited
 ✔ Container provision-app-1      Healthy
 ✔ Container provision-proxy-1    Started

Подожди пару секунд, пока nginx запустится, и спроси приложение через прокси.

ubuntu@stand:~$
curl -s --cacert $CA $B/api/whoami
ubuntu@stand:~$
{"app":"stand","host":"043df13fc94d","pid":8,"version":"1.0.0"}

Переменные CA и B живут, пока открыт терминал. Если вернулся в новом сеансе — задай их снова, как в шаге 4. Одна команда — работающий стенд.

Шаг 11. Паспорт стенда

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

~/devops-lab/reports/stand-passport.txt
ВХОД        8443 HTTPS (proxy), 8082 редирект на 8443
ВНУТРИ      app:8000 и db:5432 — только в сети provision_stand
ПОРЯДОК     db service_healthy → migrate service_completed_successfully
            → app service_healthy → proxy
ЗАПУСК      cd ~/infra/stand и docker compose up -d
            набор файлов: COMPOSE_FILE в .env
ДАННЫЕ      том provision_pgdata; down -v его удалит
НЕТ         резервных копий базы, мониторинга, сбора логов
СЛОМАЕТСЯ   сертификат через год: ~/devops-lab/tls/stand.crt

Шаг 12. Зафиксировать

Конфигурация прокси и описание — в репозиторий.

ubuntu@stand:~$
git -C ~/infra add stand
ubuntu@stand:~$
git -C ~/infra commit -m "stand: прокси внутри стека"

Если что-то не сходится

Каждый несошедшийся пункт указывает на конкретное место.

Симптом и причина
proxy: host not found in upstream app
В upstream имя не совпадает с сервисом: у сервиса приложения имя app.
proxy: cannot load certificate
Нет ~/devops-lab/tls/stand.crt и stand.key или каталог смонтирован не в /etc/nginx/tls.
port is already allocated
8443 или 8082 занят другим процессом: ss -tlnp | grep 8443.
DIRECT отвечает 200
Стенд поднят с override: в .env нет COMPOSE_FILE или переменная задана в оболочке.
502 после up -d, хотя app healthy
Пересоздался только app и мог получить новый адрес, а nginx узнаёт адрес имени app один раз при старте. docker compose restart proxy.

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

  • Почему наружу публикуют только прокси?
    Одна точка входа проще защищается: TLS, лимиты и журнал запросов в одном месте. Приложение и база доступны только внутри сети проекта.
  • Зачем монтировать конфигурацию прокси только на чтение?
    Прокси смотрит в интернет. Если его взломают, он не должен иметь возможности поменять свою конфигурацию и ключи на хосте.

Что дальше

Весь стенд — одна команда. Дальше урок со шпаргалкой раздела, а за ним раздел про базы данных: PostgreSQL отдельным стеком Compose рядом с этим — запросы, индексы и резервные копии.

Практика 04+425 XP

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

  • Стенд работает в серверном режиме
  • Прокси работает
  • Миграция отработала
  • Приложение доступно через прокси по HTTPS
  • HTTP перенаправляет на HTTPS
  • Приложение напрямую недоступно
  • Сертификат выпущен на имя стенда
  • Конфигурация и ключи смонтированы только на чтение
  • Паспорт стенда составлен
Команда сдачи — выполни на своей машине
команда
cd ~/infra/stand 2>/dev/null || echo NOSTAND; grep COMPOSE_FILE .env; docker compose ps -a --format 'SVC={{.Service}} STATE={{.State}} EXIT={{.ExitCode}}'; echo "HTTPS=$(curl -s --cacert ~/devops-lab/tls/ca.crt -o /dev/null -w '%{http_code}' https://stand.provision.internal:8443/api/whoami)"; echo "REDIRECT=$(curl -s -o /dev/null -w '%{http_code}' http://stand.provision.internal:8082/)"; echo "DIRECT=$(curl -s --max-time 3 -o /dev/null -w '%{http_code}' localhost:8012/health)"; echo "SAN=$(openssl x509 -in ~/devops-lab/tls/stand.crt -noout -ext subjectAltName 2>&1 | grep -c stand.provision.internal)"; echo "RO=$(grep -c ':ro' compose.yaml)"; cat ~/devops-lab/reports/stand-passport.txt

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