"""Применение версионируемых SQL-миграций: python -m app.migrate Свойства: * повторный запуск ничего не делает (таблица schema_migrations); * одновременный запуск нескольких экземпляров безопасен (advisory lock); * каждая миграция — одна транзакция вместе с записью о применении; * ждёт готовности PostgreSQL до MIGRATE_WAIT_SECONDS. """ import asyncio import hashlib import os import sys import time import asyncpg from . import config from .web import log LOCK_ID = 7352001 async def connect(deadline): while True: try: return await asyncpg.connect(config.DATABASE_URL, timeout=3) except (OSError, asyncpg.PostgresError, asyncio.TimeoutError) as exc: if time.monotonic() > deadline: raise log("info", "waiting_for_database", error_type=type(exc).__name__) await asyncio.sleep(1) async def main(): wait = float(os.environ.get("MIGRATE_WAIT_SECONDS", "60")) conn = await connect(time.monotonic() + wait) try: await conn.execute("SELECT pg_advisory_lock($1)", LOCK_ID) await conn.execute("CREATE TABLE IF NOT EXISTS schema_migrations (" "version text PRIMARY KEY, checksum text NOT NULL, applied_at timestamptz NOT NULL DEFAULT now())") applied = {r["version"]: r["checksum"] for r in await conn.fetch("SELECT version, checksum FROM schema_migrations")} directory = os.path.abspath(config.MIGRATIONS_DIR) files = sorted(f for f in os.listdir(directory) if f.endswith(".sql")) count = 0 for name in files: sql = open(os.path.join(directory, name), encoding="utf-8").read() checksum = hashlib.sha256(sql.encode("utf-8")).hexdigest() if name in applied: if applied[name] != checksum: log("error", "migration_modified", version=name) sys.exit(2) continue async with conn.transaction(): await conn.execute(sql) await conn.execute("INSERT INTO schema_migrations (version, checksum) VALUES ($1, $2)", name, checksum) count += 1 log("info", "migration_applied", version=name) log("info", "migrations_done", applied=count, total=len(files)) finally: await conn.close() if __name__ == "__main__": asyncio.run(main())