Provision
—— XP

Практика: приложение и база за nginx

практика~120 минут+750 XP

Этап 3. Приложение поднимается на final-app руками — один раз, но ровно так, как потом его будет выкатывать конвейер: тем же файлом Compose, с тем же именем проекта, с паролем не в репозитории.

Приложение — то, что ты собирал в разделах про Docker и Compose. У него два важных адреса: /health отвечает «жив», не трогая базу, а /items ходит в PostgreSQL и считает строки. Проверять будем вторым: в разделе 20 ты видел, как /health зеленеет при упавшей базе.

Все файлы пишутся на рабочей машине в ~/final — правило из урока про план. На final-app ты только запускаешь команды.

Шаг 1. Код приложения в проект

Возьми приложение из раздела 07 — каталог с Dockerfile, кодом и списком библиотек. На рабочей машине:

ubuntu@stand:~$
cp -r ~/infra/app ~/final/

Флаг -r копирует каталог целиком, со всем содержимым. Если своё потерялось, подойдёт любое готовое приложение с базой — важно, чтобы у него был адрес, который ходит в базу.

Шаг 2. База в Compose

Описание сервисов живёт в deploy/compose.yaml. Начнём с минимума: первая строка и база.

deploy/compose.yaml — база
name: final

services:
  db:
    image: postgres:17
    restart: unless-stopped
    environment:
      POSTGRES_PASSWORD: ${DB_PASSWORD}
    volumes:
      - pgdata:/var/lib/postgresql/data

Строка name: final закрепляет имя проекта. Без неё Compose берёт имя каталога, а конвейер запускается из своего каталога — и поднимет вторую копию всего рядом с первой. restart: unless-stopped поднимет базу сама после перезагрузки машины, если ты не останавливал её руками.

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

Шаг 3. Приложение в Compose

Теперь второй сервис, тоже минимальный:

deploy/compose.yaml — приложение
  app:
    image: localhost:5000/final/app:${TAG:-manual}
    restart: unless-stopped
    environment:
      DATABASE_URL: postgres://postgres:${DB_PASSWORD}@db/postgres
    ports:
      - "127.0.0.1:8000:8000"
    depends_on: [db]

Тег образа приходит из переменной TAG, а запись :-manual значит «если переменная не задана, взять manual». Руками это manual, в конвейере — хеш коммита. Порт опубликован только на 127.0.0.1: доступен с самой машины, но не из сети, снаружи к приложению ходят только через nginx. depends_on: [db] — запустить приложение после базы. В конце файла объяви том строкой volumes: и под ней pgdata: {}.

Шаг 4. Пароль

Пароль базы не пишется в репозиторий. Сгенерируй случайный:

ubuntu@stand:~$
openssl rand -hex 16
ubuntu@stand:~$
3f9c1d7a52e84b0f9a6c2e1d8b7f4a03

rand выдаёт случайные байты, флаг -hex печатает их шестнадцатеричными цифрами — только буквы a–f и цифры, никаких символов, ломающих оболочку. Положи его в файл deploy/.env:

ubuntu@stand:~$
nano deploy/.env
deploy/.env
DB_PASSWORD=3f9c1d7a52e84b0f9a6c2e1d8b7f4a03

Compose сам читает .env из каталога, где лежит файл описания, а .gitignore не даст файлу попасть в историю. Сохрани этот пароль в менеджер паролей: в следующем этапе он понадобится тот же самый. PostgreSQL запоминает пароль, когда впервые создаёт том, и другой потом не примет.

Шаг 5. Файлы на машину

Конвейера пока нет, поэтому всё готовое везём на машину руками, тем же rsync:

ubuntu@stand:~$
rsync -a ~/final/ final-app:final/

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

Шаг 6. Образ

Теперь на машину. Заходим и переходим в привезённый каталог:

ubuntu@stand:~$
ssh final-app
ubuntu@stand:~$
cd final

Имя образа сразу пишем таким, каким его потом будет класть конвейер, — с адресом реестра впереди. Реестра пока нет, но Docker это не смущает: образ просто хранится локально под этим именем.

ubuntu@stand:~$
docker build -t localhost:5000/final/app:manual app/
ubuntu@stand:~$
[+] Building 41.2s (12/12) FINISHED
 => => naming to localhost:5000/final/app:manual

Флаг -t задаёт имя и тег, app/ — каталог с Dockerfile. Тег manual честно говорит, что этот образ собран руками, а не конвейером.

Шаг 7. Запуск

Поднимаем сервисы. Флаг -f указывает файл описания, -d отпускает терминал и оставляет контейнеры работать в фоне.

ubuntu@stand:~$
docker compose -f deploy/compose.yaml up -d
ubuntu@stand:~$
 ✔ Container final-db-1   Started
 ✔ Container final-app-1  Started

Спроси приложение о данных. Флаг -s убирает индикатор загрузки.

ubuntu@stand:~$
curl -s http://127.0.0.1:8000/items
ubuntu@stand:~$
<title>500 Internal Server Error</title>

Ошибка 500 — приложение упало при обработке запроса. Почему, расскажет его журнал. Флаг -p final выбирает проект по имени из строки name:, файл указывать не нужно.

ubuntu@stand:~$
docker compose -p final logs app | grep Error
ubuntu@stand:~$
app-1  | psycopg2.errors.UndefinedTable: relation "visits" does not exist

До базы приложение достучалось, но база новая и пустая: таблицы visits в ней нет. В разделе 08 её создавал сервис миграции — здесь он нужен тот же.

Шаг 8. Миграция

Выйди с машины (exit): файлы пишутся на рабочей. Создай каталог миграций и файл в нём:

ubuntu@stand:~$
mkdir -p ~/final/deploy/migrations
deploy/migrations/001-visits.sql
CREATE TABLE IF NOT EXISTS visits (id serial PRIMARY KEY);

В compose.yaml, перед строкой volumes: в конце, — сервис, как в разделе 08, только пользователь postgres и пароль из DB_PASSWORD. Блока networks нет: здесь все сервисы в сети по умолчанию.

deploy/compose.yaml — миграция
  migrate:
    image: postgres:17
    command: ["psql", "-v", "ON_ERROR_STOP=1", "-f", "/migrations/001-visits.sql"]
    environment:
      PGHOST: db
      PGUSER: postgres
      PGPASSWORD: ${DB_PASSWORD}
    volumes:
      - ./migrations:/migrations:ro
    depends_on: [db]

Новая машина, на которую цепочку выкатят с нуля, начнёт с пустого тома. Проверим именно этот случай: отвези файлы, зайди на машину и снеси проект вместе с томом — флаг -v у down. База пока пустая, терять нечего.

ubuntu@stand:~$
rsync -a ~/final/ final-app:final/
ssh final-app
ubuntu@stand:~$
cd final
docker compose -p final down -v
ubuntu@stand:~$
 ✔ Volume final_pgdata     Removed
 ✔ Network final_default   Removed

Том удалён — следующий запуск начнётся с чистой базы.

ubuntu@stand:~$
docker compose -f deploy/compose.yaml up -d
ubuntu@stand:~$
 ✔ Container final-app-1      Started
 ✔ Container final-migrate-1  Started

Через несколько секунд посмотри на все контейнеры — флаг -a показывает и завершившиеся:

ubuntu@stand:~$
docker compose -p final ps -a
ubuntu@stand:~$
SERVICE   STATUS
app       Up 8 seconds (health: starting)
db        Up 8 seconds
migrate   Exited (2) 8 seconds ago
ubuntu@stand:~$
docker compose -p final logs migrate
ubuntu@stand:~$
migrate-1  | psql: error: connection to server at "db" (192.168.64.2), port 5432 failed: Connection refused

Миграция стартовала сразу после контейнера базы, а сама база ещё создавала свои файлы и соединений не принимала. depends_on: [db] ждёт только запуска контейнера — урок «Запущен не значит готов» из раздела про Compose.

Шаг 9. Проверка здоровья и порядок

Пусть база сама сообщает о готовности. Допиши к сервису db:

deploy/compose.yaml — продолжение db
    healthcheck:
      test: ["CMD", "pg_isready", "-U", "postgres"]
      interval: 5s
      retries: 10

pg_isready — маленькая утилита из состава PostgreSQL, она отвечает «принимаю соединения» или нет. Каждые пять секунд, до десяти попыток. Теперь замени короткие depends_on на длинные, с условием. У migrate:

у сервиса migrate
    depends_on:
      db: { condition: service_healthy }

У app — ждать не базу, а успешного конца миграции, иначе приложение снова начнёт отвечать 500, пока таблицы нет:

у сервиса app
    depends_on:
      migrate: { condition: service_completed_successfully }

Выйди с машины, допиши файл, отвези его тем же rsync и снова зайди. Подними сервисы из каталога final:

ubuntu@stand:~$
docker compose -f deploy/compose.yaml up -d
ubuntu@stand:~$
 ✔ Container final-db-1       Healthy
 ✔ Container final-migrate-1  Exited
 ✔ Container final-app-1      Started

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

ubuntu@stand:~$
docker compose -p final ps
ubuntu@stand:~$
SERVICE   STATUS                            PORTS
app       Up 3 seconds (health: starting)   127.0.0.1:8000->8000/tcp
db        Up 9 seconds (healthy)            5432/tcp

У базы (healthy). В колонке PORTS у неё 5432/tcp без адреса слева: порт открыт внутри сети Docker, но не на машине. У приложения слева 127.0.0.1 — ровно то, что задумано. Миграции в списке нет: без -a завершившиеся контейнеры не показываются.

ubuntu@stand:~$
curl -s http://127.0.0.1:8000/items
ubuntu@stand:~$
{"visits":0}

Ноль — таблица пока пустая, но ответ пришёл из базы. Если вместо этого {"error":"database unavailable"}, приложение не достучалось до базы: смотри журнал командой docker compose -p final logs app, чаще всего там неверный пароль или адрес. Другие способы ждать базу — повторы подключения в самом приложении или утилиты вроде wait-for-it в команде запуска; условие service_healthy проще, потому что ничего не меняет в коде.

Шаг 10. Что слушает машина

Последняя проверка изнутри: какие порты открыты на машине. Это ss из раздела про сети:

ubuntu@stand:~$
ss -tln
ubuntu@stand:~$
State   Local Address:Port
LISTEN  0.0.0.0:22
LISTEN  127.0.0.1:8000

Флаги: -t — только TCP, -l — только слушающие сокеты, -n — цифры вместо имён. Порта 5432 нет вообще, 8000 — только на локальном адресе. Наружу пока смотрит лишь SSH. Выйди с машины командой exit — дальше снова рабочая машина.

Шаг 11. nginx перед приложением

nginx на машину уже поставила роль Ansible, осталось описать сайт. Конфиг кладётся в шаблон роли ansible/roles/web/templates/final.conf.j2, чтобы и он жил в коде. Главная часть:

final.conf.j2 — главное
server {
    listen 443 ssl;
    server_name final.provision.internal;
    ssl_certificate     /etc/nginx/tls/final.crt;
    ssl_certificate_key /etc/nginx/tls/final.key;
    location / { proxy_pass http://127.0.0.1:8000; }
}

Сертификат выпусти в ~/final/tls так же, как в миссии раздела 08: самоподписанный, через файл настроек с subjectAltName, только для имени final.provision.internal. Его копию назови ca.crt — этому файлу будет доверять curl. Сертификат не секрет, а ключ final.key — секрет, и правило *.key в .gitignore уже стоит. Заголовки proxy_set_header и перенаправление с 80 на 443 добавь так же, как в разделе 05.

В задачи роли web допиши четыре, по порядку:

  • file с state: directory создаёт каталог /etc/nginx/tls — модуль copy сам родительский каталог не создаёт и падает с Destination directory … does not exist;
  • copy кладёт туда сертификат, путь к нему пиши от плейбука: {{ playbook_dir }}/../tls/final.crt;
  • второй copy — ключ, с mode: "0600", чтобы его читал только владелец;
  • template для final.conf.j2 в /etc/nginx/sites-enabled/ с тем же notify, что у страницы в разделе 13, — nginx перечитает настройки сам.

Примени роль только к машине приложения — флаг --limit ограничивает прогон группой:

ubuntu@stand:~$
ansible-playbook ansible/site.yml --limit app
ubuntu@stand:~$
final-app : ok=29  changed=4  unreachable=0  failed=0

Четыре изменения — ровно четыре новые задачи. Повтори команду: второй раз должно быть changed=0.

Шаг 12. Проверка снаружи

Теперь с рабочей машины, как пользователь. Имени final.provision.internal нет ни в каком DNS, поэтому пропиши его в /etc/hosts рабочей машины, как provision.internal в разделе 04: sudo nano /etc/hosts и строка с публичным адресом final-app из output ips:

/etc/hosts рабочей машины
158.160.40.21 final.provision.internal

Затем:

ubuntu@stand:~$
cd ~/final/tls
ubuntu@stand:~$
curl --cacert ca.crt https://final.provision.internal/items
ubuntu@stand:~$
{"visits":0}

Флаг --cacert говорит curl доверять твоему центру. Ответ значит, что прошла вся цепочка: имя, порт 443 в группе безопасности и в ufw, сертификат, nginx, приложение, база. Если пусто — добавь -v и смотри, на каком месте оборвалось: зависание на Trying — закрыт порт, ошибка про сертификат — не тот центр или имя.

Браузер на твоём ноутбуке этого имени пока не знает. Если хочешь открыть сайт в нём, добавь ту же строку в файл hosts ноутбука: на Windows это C:\Windows\System32\drivers\etc\hosts, на Mac и Linux — /etc/hosts. Браузер предупредит о неизвестном центре — это нормально для учебного сертификата.

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

Этап закончен. В коммит уходят код приложения, описание Compose, шаблон nginx и публичный сертификат центра — без .env и без ключей. Вернись в корень проекта:

ubuntu@stand:~$
cd ~/final
ubuntu@stand:~$
git add app/ deploy/ ansible/ tls/ca.crt
ubuntu@stand:~$
git status --short
ubuntu@stand:~$
A  app/Dockerfile
A  app/main.py
A  deploy/compose.yaml
A  tls/ca.crt

Буква A значит «добавлено в индекс». Строк больше, чем здесь, но deploy/.env и tls/final.key среди них быть не должно — их скрыл .gitignore. Фиксируй:

ubuntu@stand:~$
git commit -m "app: приложение и база за nginx"

Флаг -m задаёт сообщение коммита. Вставь команду сдачи в блок ниже.

Что дальше

Выкат пока делается руками: rsync, сборка, up -d. Следующий этап — поставить свой GitLab, зарегистрировать раннер и превратить эти шаги в конвейер.

Практика 02+750 XP

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

  • Сайт отвечает по HTTPS и достаёт данные из базы
  • База не слушает порт на машине
  • Приложение слушает только локальный адрес
  • База здорова
  • Файл с паролем не в репозитории
  • Код приложения в репозитории
Команда сдачи — выполни на своей машине
команда
cd ~/final; curl -s --cacert tls/ca.crt https://final.provision.internal/items; echo; ssh final-app ss -tln; ssh final-app docker compose -p final ps --format '{{.Service}} {{.Status}}'; echo ENV=$(git ls-files | grep -c 'env$'); echo APP=$(git ls-files app | wc -l)

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