ci: отдельная база для каждого стенда

deploy-staging создаёт роль и БД ветки через staging-db-postgres до
docker compose up, cleanup.yaml удаляет их при удалении ветки (гасит
стек раньше, иначе DROP DATABASE не пройдёт). POSTGRES_* в compose
читаются из .env, куда инструмент пишет доступы.

Попутно: DEPLOY_URL стенда из env и в summary, версия сборки — ветка и
короткий sha, в проде APP_VERSION берётся из VERSION, health в Caddyfile
одной строкой.
This commit is contained in:
arswarog committed 2026-10-29 14:59:51 +03:00
1 parent fc13c66b0d
commit ae812b0dfa
6 files changed
+63 -43

No files matched your search

+20 -22
View File
@@ -2,7 +2,7 @@
Миграции TypeORM применяются **автоматически при деплое** — и на проде (на каждый тег), и на
стейджинге (на каждый push/PR); деплой падает, если миграция не прошла. См.
[Обязательные переменные `.env` на стейджинг-хосте](#обязательные-переменные-env-на-стейджинг-хосте).
[База и переменные `.env` на стейджинг-хосте](#база-и-переменные-env-на-стейджинг-хосте).
⚠️ Перед первым прод-деплоем убедитесь, что `aigeo_app` имеет права на DDL и что таблица
`migrations` согласована со схемой — см. [Права на БД](#права-на-бд). Автоматического бэкапа перед
@@ -160,7 +160,7 @@ Job `deploy-staging` в `.gitea/workflows/ci.yaml` (запускается на
1. `migration:show` (в лог), затем `migration:run -t each` — через `docker compose exec -T api …`.
Отдельного ожидания готовности контейнера нет: живой/healthy HTTP-слой NestJS для
`typeorm migration:run` не нужен, он идёт отдельным процессом через `data-source.js`. Если
контейнер всё же не поднялся (например, при пустых `DB_*`), `docker compose exec` упадёт с
контейнер всё же не поднялся (например, при пустых `POSTGRES_*`), `docker compose exec` упадёт с
понятной ошибкой сам.
2. `docker system prune -f` — после миграций, одним вызовом в конце скрипта. Если `migration:run`
упадёт, под `set -e` prune не выполнится — почистится на следующем деплое.
@@ -168,35 +168,33 @@ Job `deploy-staging` в `.gitea/workflows/ci.yaml` (запускается на
Ненулевой код валит job: у шага стоит `script_stop: true` (штатный механизм `appleboy/ssh-action`),
а первой строкой скрипта — `set -e`.
### Обязательные переменные `.env` на стейджинг-хосте
### База и переменные `.env` на стейджинг-хосте
`docker-compose.staging.yml` берёт креды БД из `.env` в каталоге деплоя (`~/<repo>_<branch>/`) и
мапит их в `POSTGRES_*`, которые единственные читают и приложение (`app.module.ts`), и typeorm CLI.
Полный список — в [Configuration](20-configuration.md#переменные-окружения-деплоя).
Роль и базу стенда создаёт `staging-db-postgres` на стейджинг-хосте — шаг `deploy-staging` в
`ci.yaml`, до `docker compose up`:
Переменные объявлены через `${DB_HOST:-}`, то есть **не** обязательные. Обязательный синтаксис
`${DB_HOST:?…}` здесь применять нельзя: он валит любую подкоманду compose, включая `pull` и `down`.
Каталог деплоя создаётся заново для каждой новой ветки (его делает `appleboy/scp-action`), `.env`
туда не кладёт ни CI, ни кто-либо ещё — обязательные переменные означали бы красный `deploy-staging`
на первом же пуше любой новой ветки и невозможность даже погасить полуподнятый стек.
```bash
staging-db-postgres create <org/project> <branch>
```
Ценой этого при пустых `DB_*` api не подключится к БД, и `docker compose exec … migration:show`
упадёт с ошибкой подключения — это и есть сигнал, что в `.env` каталога деплоя не заданы `DB_HOST` /
`DB_USERNAME` / `DB_PASSWORD` / `DB_DATABASE`.
Имя роли и БД — `<org_project_branch>` после нормализации (всё не-алфанумерическое заменяется на
`_`, длиннее 63 байт — обрезается с хешем). Пароль генерируется при первом создании и
переиспользуется при повторных деплоях ветки. Доступы инструмент пишет в `.env` каталога деплоя
(`~/<repo>_<branch>/`): `POSTGRES_USER`, `POSTGRES_PASSWORD`, `POSTGRES_DB`, `POSTGRES_HOST`,
`POSTGRES_PORT`. Те же имена `docker-compose.staging.yml` пробрасывает в api, их единственные читают
и приложение (`typeorm.config.ts`), и typeorm CLI. При удалении ветки или закрытии PR — с вливанием
или без — `cleanup.yaml` вызывает `staging-db-postgres delete`: удаляются БД, роль и строки
`POSTGRES_*` из `.env`.
⚠️ **Ветки не делят одну базу.** Стейджинг-БД в compose не поднимается, она внешняя и общая по сети
`net`. Общая база означает, что миграция из одного PR меняет схему для всех остальных веток и для
master, а закрытый без мержа PR оставляет свою миграцию применённой навсегда — автоматического
отката нет.
В compose переменные объявлены через `${POSTGRES_HOST:-}`, то есть **не** обязательные. Обязательный
синтаксис `${POSTGRES_HOST:?…}` здесь применять нельзя: он валит любую подкоманду compose, включая
`pull` и `down`, — а полуподнятый стек надо уметь погасить.
`concurrency.cancel-in-progress` в `ci.yaml` оставлен `true` (в отличие от прода). Группа привязана
к ветке, поэтому отменяется только предыдущий прогон той же ветки, а быстрая итерация по PR важнее.
Плата реальна: отмена посреди `migration:run -t each` оставит стейджинг-БД частично мигрированной
Плата реальна: отмена посреди `migration:run -t each` оставит базу ветки частично мигрированной
(лечится повторным прогоном job).
Кроме того, TypeORM не берёт кросс-процессную блокировку: два одновременных прогона `migration:run`
по одной базе (разные PR при общей БД) попытаются применить один и тот же набор.
## Применение на проде
Job `deploy-production` в `.gitea/workflows/production.yaml`, блок `Deploy via SSH` (heredoc — не