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:
1 parent
ae812b0dfa
commit
1d80630fb2
12 files changed
+146
-108
No files matched your search
+52
-18
@@ -1,11 +1,13 @@
|
||||
import { existsSync, readdirSync, readFileSync, writeFileSync } from 'fs';
|
||||
import { type Dirent, existsSync, readdirSync, readFileSync, writeFileSync } from 'fs';
|
||||
import * as path from 'path';
|
||||
|
||||
import { format, resolveConfig } from 'prettier';
|
||||
|
||||
export const workspaceRoot = path.resolve(__dirname, '..');
|
||||
const migrationsDir = path.join(workspaceRoot, 'apps', 'api', 'src', 'database', 'migrations');
|
||||
const outputFile = path.join(workspaceRoot, 'apps', 'api', 'src', 'database', 'migrations.ts');
|
||||
const apiSrcDir = path.join(workspaceRoot, 'apps', 'api', 'src');
|
||||
const outputFile = path.join(apiSrcDir, 'migrations.ts');
|
||||
// Миграции лежат по модулям: apps/api/src/<module>/migrations/<timestamp>-<name>.ts.
|
||||
const MIGRATIONS_DIR_NAME = 'migrations';
|
||||
|
||||
const HEADER =
|
||||
'// Файл сгенерирован автоматически (tools/buildDataSource.ts). Не редактировать вручную.';
|
||||
@@ -21,6 +23,7 @@ const TIMESTAMP_PREFIX_RE = /^(\d{13})-/;
|
||||
const COMPANION_FILE_RE = /\.(d|spec|test)\.ts$/;
|
||||
|
||||
export interface MigrationEntry {
|
||||
/** Путь относительно apps/api/src, с расширением .ts */
|
||||
file: string;
|
||||
className: string;
|
||||
}
|
||||
@@ -36,27 +39,58 @@ function failBuild(message: string): never {
|
||||
fail('buildDataSource', message);
|
||||
}
|
||||
|
||||
// Порядок — лексикографический по имени файла. Отдельная числовая сортировка не
|
||||
// нужна: ниже гарантируется, что имя каждого файла начинается ровно с 13 цифр,
|
||||
// а при фиксированной длине лексикографический порядок совпадает с числовым.
|
||||
export function readMigrations(): MigrationEntry[] {
|
||||
let files: string[];
|
||||
// Список каталогов миграций: любой apps/api/src/**/migrations.
|
||||
function findMigrationsDirs(dir: string): string[] {
|
||||
let entries: Dirent[];
|
||||
|
||||
try {
|
||||
files = readdirSync(migrationsDir);
|
||||
entries = readdirSync(dir, { withFileTypes: true });
|
||||
} catch {
|
||||
failBuild(`директория миграций не найдена: ${migrationsDir}`);
|
||||
failBuild(`не удалось прочитать директорию: ${dir}`);
|
||||
}
|
||||
|
||||
const migrationFiles = files
|
||||
.filter((file) => file.endsWith('.ts') && !COMPANION_FILE_RE.test(file))
|
||||
.sort();
|
||||
const found: string[] = [];
|
||||
|
||||
// Пустая директория — легальное состояние: проект может ещё не иметь миграций.
|
||||
// Тогда список пустой, а сборка не падает.
|
||||
for (const entry of entries) {
|
||||
if (!entry.isDirectory() || entry.name === 'node_modules') {
|
||||
continue;
|
||||
}
|
||||
|
||||
const fullPath = path.join(dir, entry.name);
|
||||
|
||||
if (entry.name === MIGRATIONS_DIR_NAME) {
|
||||
found.push(fullPath);
|
||||
continue;
|
||||
}
|
||||
|
||||
found.push(...findMigrationsDirs(fullPath));
|
||||
}
|
||||
|
||||
return found;
|
||||
}
|
||||
|
||||
// Порядок — по timestamp из имени файла (возрастание): имя файла начинается ровно с
|
||||
// 13 цифр, поэтому лексикографическая сортировка совпадает с числовой. Одинаковые
|
||||
// имена файлов в разных модулях упорядочиваются по пути.
|
||||
export function readMigrations(): MigrationEntry[] {
|
||||
const migrationFiles = findMigrationsDirs(apiSrcDir)
|
||||
.flatMap((dir) =>
|
||||
readdirSync(dir, { withFileTypes: true })
|
||||
.filter((entry) => entry.isFile())
|
||||
.map((entry) => path.posix.join(path.relative(apiSrcDir, dir), entry.name))
|
||||
.filter((file) => file.endsWith('.ts') && !COMPANION_FILE_RE.test(file)),
|
||||
)
|
||||
.sort((a, b) => {
|
||||
const byName = path.posix.basename(a).localeCompare(path.posix.basename(b));
|
||||
|
||||
return byName !== 0 ? byName : a.localeCompare(b);
|
||||
});
|
||||
|
||||
// Каталогов migrations может не быть ни одного: проект может ещё не иметь
|
||||
// миграций. Тогда список пустой, а сборка не падает.
|
||||
|
||||
const entries = migrationFiles.map((file): MigrationEntry => {
|
||||
const timestampMatch = TIMESTAMP_PREFIX_RE.exec(file);
|
||||
const timestampMatch = TIMESTAMP_PREFIX_RE.exec(path.posix.basename(file));
|
||||
|
||||
if (!timestampMatch) {
|
||||
failBuild(
|
||||
@@ -65,7 +99,7 @@ export function readMigrations(): MigrationEntry[] {
|
||||
);
|
||||
}
|
||||
|
||||
const source = readFileSync(path.join(migrationsDir, file), 'utf8');
|
||||
const source = readFileSync(path.join(apiSrcDir, file), 'utf8');
|
||||
const classNames = [...source.matchAll(EXPORT_CLASS_RE)].map((match) => match[1]);
|
||||
|
||||
if (classNames.length === 0) {
|
||||
@@ -123,7 +157,7 @@ function render(entries: MigrationEntry[]): string {
|
||||
const imports = entries
|
||||
.map(
|
||||
(entry) =>
|
||||
`import { ${entry.className} } from './migrations/${entry.file.slice(0, -'.ts'.length)}';`,
|
||||
`import { ${entry.className} } from './${entry.file.slice(0, -'.ts'.length)}';`,
|
||||
)
|
||||
.join('\n');
|
||||
|
||||
|
||||
Reference in new issue
Block a user