Стенд в контейнерах пока без входа для людей: приложение опубликовано только на петле, а nginx из раздела 05 живёт на хосте своей жизнью и обслуживает свои сайты на 443. Миссия — дать стеку собственный прокси внутри того же описания, с HTTPS на 8443, так чтобы весь стенд поднимался одной командой. Пакетный nginx при этом не трогаем: порты у них разные.
Это же описание дальше станет основой курса: рядом с ним в следующих разделах поднимутся база данных, мониторинг и сбор логов, а конвейер CI/CD будет выкатывать его сам.
Требования
Задача одна, проверяется по пунктам.
Шаг 1. Сертификат для стенда
Для HTTPS прокси понадобится сертификат на имя stand.provision.internal. Выпустим его сразу, чтобы потом не отвлекаться. Он будет самоподписанным — подписанным самим собой, как snakeoil из раздела про nginx, но на нужное имя. Параметры удобнее держать в маленьком файле настроек, чем в одной длинной команде.
mkdir -p ~/devops-lab/tlscd ~/devops-lab/tls[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 — на год.
openssl req -x509 -config stand.cnf -days 365 -out stand.crt.....+...........+.+...+...+++++++++++++++++++++++++++*..+.... -----
Строки из точек и плюсов — это openssl подбирает числа для ключа, так и должно быть. Проверим имя в сертификате.
openssl x509 -in stand.crt -noout -ext subjectAltNameX509v3 Subject Alternative Name: DNS:stand.provision.internal
Самоподписанный сертификат сам себе удостоверяющий центр. Клиенту, чтобы доверять стенду, нужен он же — положим копию под именем ca.crt, этим именем пользуются проверки и следующие разделы.
cp stand.crt ca.crtШаг 2. Имя стенда указывает на эту машину
Имя stand.provision.internal уже есть в /etc/hosts с раздела про nginx. Убедимся.
getent hosts stand.provision.internal127.0.0.1 stand.provision.internalШаг 3. Самый простой прокси
Начнём с прокси, который просто передаёт запросы приложению, без HTTPS и всего остального. Конфигурация живёт в репозитории рядом с описанием.
mkdir -p ~/infra/stand/nginxГруппа серверов из одного сервиса app — как в практике про прокси в разделе nginx, только вместо адреса имя: прокси и приложение будут в одной сети проекта.
upstream app_backend { server app:8000; } server { listen 8082; location / { proxy_pass http://app_backend/; } }
Теперь сам сервис. Добавь его в раздел services файла compose.yaml, после db.
proxy: image: nginx:1.30-alpine ports: - "8082:8082" volumes: - ./nginx/stand.conf:/etc/nginx/conf.d/stand.conf networks: - stand
Файл конфигурации монтируется внутрь, в каталог, откуда nginx в образе читает настройки сайтов. Сеть stand — та же, что у приложения, иначе прокси не найдёт app по имени. Порт опубликован без адреса — на всех интерфейсах, потому что прокси и есть вход на стенд снаружи.
cd ~/infra/standdocker compose up -d[+] Running 4/4 ✔ Container provision-proxy-1 Started
curl -s http://stand.provision.internal:8082/whoami{"app":"stand","host":"c5ccde20246f","pid":8,"version":"1.0.0"}Ответ приложения, но пришёл он через прокси. Журнал nginx в образе связан с потоком вывода контейнера, поэтому запрос виден здесь.
docker compose logs --tail 1 proxyproxy-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/ уходят приложению.
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.
- "8443:8443"- ~/devops-lab/tls:/etc/nginx/tls - /var/www/provision:/var/www/provision
docker compose up -d[+] Running 4/4 ✔ Container provision-proxy-1 Started
Две переменные, чтобы команды проверки остались короткими: путь к сертификату, которому доверяем, и адрес стенда.
CA=~/devops-lab/tls/ca.crtB=https://stand.provision.internal:8443Сначала без сертификата — посмотрим, что скажет curl.
curl -sS $B/api/whoamicurl: (60) SSL certificate problem: self-signed certificatecurl не знает, кто подписал сертификат, и отказывается разговаривать. Флаг --cacert даёт ему файл, которому доверять.
curl -s --cacert $CA $B/api/whoami{"app":"stand","host":"c5ccde20246f","pid":7,"version":"1.0.0"}Другой путь — флаг -k, «не проверять сертификат вовсе». Он работает, но проверяет только то, что соединение есть, а не то, что на другом конце нужный сервер. Для проверки стенда это бессмысленно.
Шаг 5. HTTP ведёт на HTTPS
Блок на 8082 пока передаёт запросы приложению напрямую, без шифрования. Замени его целиком на перенаправление — тот же return 301, что в разделе про nginx, только на порт стенда.
server { listen 8082; return 301 https://$host:8443$request_uri; }
Правь файл редактором nano, а не sed -i: файл смонтирован в контейнер отдельно, и sed подменил бы его новым файлом, которого контейнер не увидит. Почему так — разберём в разделе про отладку. Контейнер пересоздавать не нужно: проверим новые настройки и попросим nginx их перечитать.
docker compose exec proxy nginx -tnginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful
docker compose exec proxy nginx -s reload[notice] 42#42: signal process startedФлаг -I у curl запрашивает только заголовки, head -1 оставляет первую строку.
curl -sI http://stand.provision.internal:8082 | head -1HTTP/1.1 301 Moved PermanentlyШаг 6. Свой ответ на «жив ли вход»
Если /api/ не отвечает, сразу непонятно, кто виноват — прокси или приложение. Добавим адрес, на который прокси отвечает сам, не спрашивая никого. Допиши в блок на 8443, перед закрывающей скобкой.
location = /health { return 200 "ok "; }
Знак = — точное совпадение: этот блок отвечает только на /health, но не на /health/что-то. Перечитай настройки двумя командами из прошлого шага и проверь.
curl -s --cacert $CA $B/healthokТеперь остановим приложение и спросим оба адреса.
docker compose stop appcurl -sI --cacert $CA $B/api/whoami | head -1HTTP/1.1 502 Bad Gatewaycurl -s --cacert $CA $B/healthok502 на /api/ и ok на /health: вход жив, сломано то, что за ним. Одной парой запросов ты разделил две причины. Этим адресом пользуется раздел про отладку. Возвращаем приложение.
docker compose start appШаг 7. Только на чтение
Прокси смотрит в интернет, а смонтированные каталоги сейчас открыты ему на запись. Проверим: зайдём в контейнер и допишем строку в его конфигурацию изнутри. Команда sh после exec открывает оболочку внутри контейнера.
docker compose exec proxy sh/ # echo '# чужая строка' >> /etc/nginx/conf.d/stand.conf / # exit
tail -1 nginx/stand.conf# чужая строкаСтрока появилась в файле на хосте, в твоём репозитории. Взломай кто-то прокси — сможет переписать свою конфигурацию и ключ. Убери эту строку из файла через nano и допиши :ro в конец всех трёх монтирований прокси.
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
docker compose up -d[+] 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. Прокси ждёт приложение
Проверим стенд с нуля: снимем его целиком и поднимем.
docker compose down[+] 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
docker compose up -ddocker compose ps -aNAME 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
Прокси упал. Почему — в журнале.
docker compose logs proxyproxy-1 | nginx: [emerg] host not found in upstream "app:8000" in /etc/nginx/conf.d/stand.conf:2Прокси ни от кого не зависит и стартовал первым. nginx при запуске сразу ищет адрес имени app, а контейнера приложения ещё нет. Пусть ждёт здоровое приложение — проверка объявлена в его образе инструкцией HEALTHCHECK. Допиши сервису proxy.
depends_on: app: condition: service_healthy restart: unless-stopped
restart: unless-stopped — как у остальных постоянных сервисов: упавший прокси Docker поднимет сам. Он бы и без depends_on в итоге поднялся, после нескольких падений, но порядок по готовности чище, чем надежда на перезапуски.
docker compose down[+] 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
docker compose up -d[+] 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 не подхватится.
echo 'COMPOSE_FILE=compose.yaml:compose.prod.yaml' >> .envПроверь итог: в нём должно быть ровно две публикации, обе у прокси.
docker compose config | grep publishedpublished: "8082" published: "8443"
Вместе с набором файлов сменился и источник образа приложения: в серверном режиме app берётся из реестра по APP_IMAGE (шаг 5 практики про окружения), а не собирается из Dockerfile.
docker compose config app | grep -e image -e contextimage: localhost:5000/provision/app:1.0.0 image: postgres:17-alpine image: postgres:17-alpine
Строки context нет: на сервере ничего не собирается. Применяем.
docker compose up -d[+] 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 никто не слушает.
curl -s --max-time 3 -w '%{http_code}' localhost:8012000Шаг 10. Проверка с нуля
Главное свойство описания — поднимать систему, где ничего не запущено. Снимаем стек целиком, без -v: данные базы оставляем.
docker compose down[+] 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
docker compose up -d[+] Running 4/4 ✔ Container provision-db-1 Healthy ✔ Container provision-migrate-1 Exited ✔ Container provision-app-1 Healthy ✔ Container provision-proxy-1 Started
Подожди пару секунд, пока nginx запустится, и спроси приложение через прокси.
curl -s --cacert $CA $B/api/whoami{"app":"stand","host":"043df13fc94d","pid":8,"version":"1.0.0"}Переменные CA и B живут, пока открыт терминал. Если вернулся в новом сеансе — задай их снова, как в шаге 4. Одна команда — работающий стенд.
Шаг 11. Паспорт стенда
Паспорт отвечает на вопросы дежурного без чтения файлов: что где слушает, в каком порядке поднимается, что сломается первым. Пример структуры — подставь своё.
ВХОД 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. Зафиксировать
Конфигурация прокси и описание — в репозиторий.
git -C ~/infra add standgit -C ~/infra commit -m "stand: прокси внутри стека"Если что-то не сходится
Каждый несошедшийся пункт указывает на конкретное место.
Что спросят на собеседовании
- Почему наружу публикуют только прокси?Одна точка входа проще защищается: TLS, лимиты и журнал запросов в одном месте. Приложение и база доступны только внутри сети проекта.
- Зачем монтировать конфигурацию прокси только на чтение?Прокси смотрит в интернет. Если его взломают, он не должен иметь возможности поменять свою конфигурацию и ключи на хосте.
Что дальше
Весь стенд — одна команда. Дальше урок со шпаргалкой раздела, а за ним раздел про базы данных: PostgreSQL отдельным стеком Compose рядом с этим — запросы, индексы и резервные копии.