Этап 3. Приложение поднимается на final-app руками — один раз, но ровно так, как потом его будет выкатывать конвейер: тем же файлом Compose, с тем же именем проекта, с паролем не в репозитории.
Приложение — то, что ты собирал в разделах про Docker и Compose. У него два важных адреса: /health отвечает «жив», не трогая базу, а /items ходит в PostgreSQL и считает строки. Проверять будем вторым: в разделе 20 ты видел, как /health зеленеет при упавшей базе.
Все файлы пишутся на рабочей машине в ~/final — правило из урока про план. На final-app ты только запускаешь команды.
Шаг 1. Код приложения в проект
Возьми приложение из раздела 07 — каталог с Dockerfile, кодом и списком библиотек. На рабочей машине:
cp -r ~/infra/app ~/final/Флаг -r копирует каталог целиком, со всем содержимым. Если своё потерялось, подойдёт любое готовое приложение с базой — важно, чтобы у него был адрес, который ходит в базу.
Шаг 2. База в Compose
Описание сервисов живёт в 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
Теперь второй сервис, тоже минимальный:
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. Пароль
Пароль базы не пишется в репозиторий. Сгенерируй случайный:
openssl rand -hex 163f9c1d7a52e84b0f9a6c2e1d8b7f4a03rand выдаёт случайные байты, флаг -hex печатает их шестнадцатеричными цифрами — только буквы a–f и цифры, никаких символов, ломающих оболочку. Положи его в файл deploy/.env:
nano deploy/.envDB_PASSWORD=3f9c1d7a52e84b0f9a6c2e1d8b7f4a03Compose сам читает .env из каталога, где лежит файл описания, а .gitignore не даст файлу попасть в историю. Сохрани этот пароль в менеджер паролей: в следующем этапе он понадобится тот же самый. PostgreSQL запоминает пароль, когда впервые создаёт том, и другой потом не примет.
Шаг 5. Файлы на машину
Конвейера пока нет, поэтому всё готовое везём на машину руками, тем же rsync:
rsync -a ~/final/ final-app:final/Команда молчит, если всё прошло хорошо. Повторять её придётся после каждой правки файлов на рабочей машине — rsync передаст только изменённое.
Шаг 6. Образ
Теперь на машину. Заходим и переходим в привезённый каталог:
ssh final-appcd finalИмя образа сразу пишем таким, каким его потом будет класть конвейер, — с адресом реестра впереди. Реестра пока нет, но Docker это не смущает: образ просто хранится локально под этим именем.
docker build -t localhost:5000/final/app:manual app/[+] Building 41.2s (12/12) FINISHED => => naming to localhost:5000/final/app:manual
Флаг -t задаёт имя и тег, app/ — каталог с Dockerfile. Тег manual честно говорит, что этот образ собран руками, а не конвейером.
Шаг 7. Запуск
Поднимаем сервисы. Флаг -f указывает файл описания, -d отпускает терминал и оставляет контейнеры работать в фоне.
docker compose -f deploy/compose.yaml up -d✔ Container final-db-1 Started ✔ Container final-app-1 Started
Спроси приложение о данных. Флаг -s убирает индикатор загрузки.
curl -s http://127.0.0.1:8000/items<title>500 Internal Server Error</title>Ошибка 500 — приложение упало при обработке запроса. Почему, расскажет его журнал. Флаг -p final выбирает проект по имени из строки name:, файл указывать не нужно.
docker compose -p final logs app | grep Errorapp-1 | psycopg2.errors.UndefinedTable: relation "visits" does not existДо базы приложение достучалось, но база новая и пустая: таблицы visits в ней нет. В разделе 08 её создавал сервис миграции — здесь он нужен тот же.
Шаг 8. Миграция
Выйди с машины (exit): файлы пишутся на рабочей. Создай каталог миграций и файл в нём:
mkdir -p ~/final/deploy/migrationsCREATE TABLE IF NOT EXISTS visits (id serial PRIMARY KEY);В compose.yaml, перед строкой volumes: в конце, — сервис, как в разделе 08, только пользователь postgres и пароль из DB_PASSWORD. Блока networks нет: здесь все сервисы в сети по умолчанию.
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. База пока пустая, терять нечего.
rsync -a ~/final/ final-app:final/ ssh final-app
cd final docker compose -p final down -v
✔ Volume final_pgdata Removed ✔ Network final_default Removed
Том удалён — следующий запуск начнётся с чистой базы.
docker compose -f deploy/compose.yaml up -d✔ Container final-app-1 Started ✔ Container final-migrate-1 Started
Через несколько секунд посмотри на все контейнеры — флаг -a показывает и завершившиеся:
docker compose -p final ps -aSERVICE STATUS app Up 8 seconds (health: starting) db Up 8 seconds migrate Exited (2) 8 seconds ago
docker compose -p final logs migratemigrate-1 | psql: error: connection to server at "db" (192.168.64.2), port 5432 failed: Connection refusedМиграция стартовала сразу после контейнера базы, а сама база ещё создавала свои файлы и соединений не принимала. depends_on: [db] ждёт только запуска контейнера — урок «Запущен не значит готов» из раздела про Compose.
Шаг 9. Проверка здоровья и порядок
Пусть база сама сообщает о готовности. Допиши к сервису db:
healthcheck: test: ["CMD", "pg_isready", "-U", "postgres"] interval: 5s retries: 10
pg_isready — маленькая утилита из состава PostgreSQL, она отвечает «принимаю соединения» или нет. Каждые пять секунд, до десяти попыток. Теперь замени короткие depends_on на длинные, с условием. У migrate:
depends_on: db: { condition: service_healthy }
У app — ждать не базу, а успешного конца миграции, иначе приложение снова начнёт отвечать 500, пока таблицы нет:
depends_on: migrate: { condition: service_completed_successfully }
Выйди с машины, допиши файл, отвези его тем же rsync и снова зайди. Подними сервисы из каталога final:
docker compose -f deploy/compose.yaml up -d✔ Container final-db-1 Healthy ✔ Container final-migrate-1 Exited ✔ Container final-app-1 Started
Сначала база дошла до Healthy, потом миграция создала таблицу и вышла, и только потом стартовало приложение. Посмотрим, что получилось:
docker compose -p final psSERVICE 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 завершившиеся контейнеры не показываются.
curl -s http://127.0.0.1:8000/items{"visits":0}Ноль — таблица пока пустая, но ответ пришёл из базы. Если вместо этого {"error":"database unavailable"}, приложение не достучалось до базы: смотри журнал командой docker compose -p final logs app, чаще всего там неверный пароль или адрес. Другие способы ждать базу — повторы подключения в самом приложении или утилиты вроде wait-for-it в команде запуска; условие service_healthy проще, потому что ничего не меняет в коде.
Шаг 10. Что слушает машина
Последняя проверка изнутри: какие порты открыты на машине. Это ss из раздела про сети:
ss -tlnState 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, чтобы и он жил в коде. Главная часть:
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 ограничивает прогон группой:
ansible-playbook ansible/site.yml --limit appfinal-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:
158.160.40.21 final.provision.internalЗатем:
cd ~/final/tlscurl --cacert ca.crt https://final.provision.internal/items{"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 и без ключей. Вернись в корень проекта:
cd ~/finalgit add app/ deploy/ ansible/ tls/ca.crtgit status --shortA app/Dockerfile A app/main.py A deploy/compose.yaml A tls/ca.crt
Буква A значит «добавлено в индекс». Строк больше, чем здесь, но deploy/.env и tls/final.key среди них быть не должно — их скрыл .gitignore. Фиксируй:
git commit -m "app: приложение и база за nginx"Флаг -m задаёт сообщение коммита. Вставь команду сдачи в блок ниже.
Что дальше
Выкат пока делается руками: rsync, сборка, up -d. Следующий этап — поставить свой GitLab, зарегистрировать раннер и превратить эти шаги в конвейер.