db (migraciones)

Contenedor de un solo uso que aplica las migraciones de base de datos con Alembic. Se ejecuta al arrancar el stack y termina con código 0 al completar. El orquestador Docker reinicia en caso de error.

Comportamiento

Conecta a PostgreSQL.
Adquiere un advisory lock para evitar ejecuciones concurrentes.
Aplica todas las migraciones pendientes.
Termina.

Los demás servicios tienen depends_on: db-migrations: condition: service_completed_successfully, por lo que no arrancan hasta que las migraciones terminen.

Variables de entorno

Variable	Descripción
`DATABASE_URL`	PostgreSQL (`postgresql+psycopg://...`)

Esquema de base de datos

jobs              — contenedor de un trabajo del usuario (multimódulo)
tasks             — ejecución de un módulo dentro de un job
                    type: counting | extraction | cleaning
count_job_files   — resultado de conteo por PDF (job_module_id → tasks.id)
extraction_batches — lote de extracción (job_module_id → tasks.id)
extraction_rows   — fila extraída (batch_id → extraction_batches.id)
cleaning_jobs     — job de limpieza (task_id → tasks.id)
cleaned_rows      — fila limpiada (cleaning_job_id → cleaning_jobs.id)

Documentación completa en docs/database.dbml.

Estructura del código

Dockerfile          — imagen Python slim + alembic + psycopg
alembic.ini         — configuración de Alembic
alembic/
  env.py            — entorno de migraciones con advisory lock
  versions/
    0001_initial_schema.py
    0002_add_jobs_and_count.py
run_migrations.py   — script principal con manejo de errores
requirements.txt

Añadir una migración

# Generar una nueva revisión
docker run --rm -e DATABASE_URL=... ipsextractor-db-migrations \
  alembic revision --autogenerate -m "descripcion"

1.9 KiB Raw Blame History