data-base-dumper

Qué es

Un proceso de consola que genera volcados de las bases de datos de producción, los sube a S3 y notifica el resultado a Slack.

Es una de las dos rutinas de respaldo del ecosistema. Ver la nota sobre esa duplicidad en Operación.

Tipo de sistema

Campo	Valor
Tipo	Microservicio CLI
Lenguaje	PHP 8.5, sin framework de aplicación
Componentes	Symfony Console · Symfony DependencyInjection · AWS SDK
Base de datos	Lee las bases de producción; no tiene una propia.
Ejecución	Servidor, disparado por cron
Despliegue	Deployer

Estado documental

• Estado: Borrador
• Última actualización: 2026-08-02
• Owner: Pendiente
• SME requerido: DevOps
• Fuente resumida: comandos, servicios y configuración de despliegue del repositorio.

Qué hace

cron  ──►  dumper:dump-database --provider=<servicio>
                │
                ├─ genera el volcado de la base del proveedor
                ├─ lo sube a S3
                └─ notifica el resultado a Slack

Y una rutina de limpieza que elimina los volcados locales acumulados.

El proyecto trabaja con el concepto de proveedor: cada proveedor es un servicio con su propia base de datos, configurado por separado. Así una misma rutina respalda varias bases sin duplicar código.

Comandos

Comando	Qué hace
dumper:dump-database --provider=<servicio>	Genera el volcado del proveedor indicado, lo sube a S3 y notifica.
clear:sql-dumps	Elimina los volcados locales acumulados.

Notificaciones

Cada ejecución envía un mensaje a Slack con código de color según el resultado: éxito, advertencia o error.

Es el único sistema del ecosistema con notificación proactiva de resultado documentada.

Configuración

Por variables de ambiente:

Variable	Para qué
AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_DEFAULT_REGION	Acceso a AWS.
AWS_BUCKET	Bucket destino de los volcados.
SLACK_TOKEN	Notificaciones.

Las conexiones a las bases de cada proveedor se configuran aparte. Los valores reales no se documentan aquí.

Relación con otros sistemas

Sistema	Relación
sy-energy	Se respaldan las bases de sus instancias de participante.
mem-api	Se respalda su base.
server-configs	Define una rutina de respaldo alternativa. Ver la nota de duplicidad.

Riesgos y gaps

• No está documentado el procedimiento de restauración. Es lo único que realmente importa el día que se necesite un respaldo.
• No está documentada la política de retención en S3.
• No está confirmado si esta rutina o la de server-configs es la vigente.
• No hay verificación de que el volcado sea restaurable; solo se notifica que se generó.
• No está documentado el catálogo de proveedores configurados.

Próxima revisión

Al aclarar el mecanismo de respaldo vigente y documentar la restauración.