ci: перенос миграций к модулям, деплой стендов через jt4d-lab/ssh-action и caddy-лейблы

- миграции лежат по модулям в `apps/api/src/<module>/migrations/`; `tools/buildDataSource.ts`
  сканирует `apps/api/src/**/migrations/` и генерирует список в `apps/api/src/migrations.ts`
- `deploy-staging` накатывает миграции шагами `migration:show` и `migration:run -t each`
- стенды получают маршрутизацию через лейблы `caddy` и `caddy.reverse_proxy`, web-образ стенда
  собирается с `CADDYFILE=Caddyfile.staging`

## Мотивация

Миграции нужно накатывать на стендах автоматически и держать рядом с модулем, которому они
принадлежат, а деплой — сводить к одному шагу, который сам копирует компоуз-файл на хост и выполняет
скрипт.

## Ключевые моменты реализации

- `Caddyfile.staging` слушает `:80` без хостового матчера и HTTPS: имена стендов динамические,
  маршрутизацию и TLS берёт внешний caddy-docker-proxy по лейблам

Reviewed-on: jt4d/jt4d#2
Co-authored-by: Arswarog <arswarog@yandex.ru>
This commit is contained in:
arswarog authored and Евгений committed 2026-10-31 16:13:13 +03:00
1 parent ae812b0dfa
commit 1d80630fb2
12 files changed
+146 -108

No files matched your search

+5 -4
View File
@@ -56,14 +56,15 @@ yarn nx run api:db-migrations-list # Перегенерировать спис
#### Миграции БД
- Миграции лежат в `apps/api/src/database/migrations/`
- Список миграций **генерируется статически** (`tools/buildDataSource.ts` →
`apps/api/src/database/migrations.ts`), потому что webpack не умеет runtime-glob
- Миграции лежат по модулям: `apps/api/src/<module>/migrations/`
- Список миграций **генерируется статически** (`tools/buildDataSource.ts` сканирует
`apps/api/src/**/migrations/` → `apps/api/src/migrations.ts`), потому что webpack не умеет
runtime-glob
- Имя файла обязано начинаться с **13-значного** timestamp, а имя класса — оканчиваться тем же
timestamp: TypeORM берёт его как `parseInt(className.substr(-13))`. Расхождение валит сборку
- **После добавления или удаления миграции список нужно перегенерировать и закоммитить**
(`yarn nx run api:db-migrations-list`, либо это сделает `yarn nx run api:build` через
`dependsOn`). Иначе CI упадёт на шаге `Check migrations list` (`git diff --exit-code`)
`dependsOn`). Иначе CI упадёт на шаге `Check migrations list`
- Деплой применяет миграции автоматически (`migration:run -t each` через `docker exec` на проде /
`docker compose exec` на стейджинге) — на каждый тег на проде и на каждый push/PR на стейджинге.
Автоматического бэкапа перед миграцией нет. Подробнее: `docs/90-deploy/10-migrations.md`