Checklist de Deployment
Utiliza esta lista antes, durante y después de cada despliegue. Marca los elementos según corresponda.
1. Preparación (Pre-Deployment)
- Revisar checklist de producción y confirmar que no quedan items críticos
- Actualizar
.envdel backend con claves live (Stripe, JWT, SMTP, GHL, n8n) - Actualizar
.envdel frontend (VITE_*,PUBLIC_*) - Configurar DNS y certificados TLS para
FRONTEND_HOST,BACKEND_HOSTyDOCS_HOST - Validar migraciones pendientes (
alembic heads) - Hacer backup de base de datos y Redis (o snapshot gestionado)
- Verificar que Stripe y GHL están configurados según las guías de setup
- Actualizar imágenes Docker si aplica (
docker compose build --no-cache)
2. Ejecución (Deployment)
- Aplicar migraciones:
docker compose run --rm backend alembic upgrade head - Desplegar servicios:
docker compose up -d(o pipeline equivalente) - Confirmar healthchecks (
/health, logs de backend/frontend/docs) - Verificar reverse proxy / TLS (certificados emitidos y redirecciones correctas)
3. Verificación Post-Deployment
- Ejecutar smoke tests: login, creación de proyecto, flujo de pago con tarjeta de prueba
- Confirmar recepción de emails transaccionales
- Verificar webhooks en Stripe y GoHighLevel (dashboard sin errores)
- Revisar métricas/logs (Prometheus/Grafana si aplican)
- Completar registro en
ghl_sync_logsin fallos - Verificar que la documentación está accesible en
doc.haorp.es - Actualizar documentación interna si hubo cambios relevantes
4. Rollback / Contingencia
- Documentar el comando para revertir migraciones si fuera necesario (
alembic downgrade -1) - Mantener backups accesibles
- Tener a mano scripts
docker compose downy versiones previas de imágenes
5. Comunicación
- Avisar al equipo de soporte/marketing del despliegue
- Programar monitorización extra las primeras 24 h (alertas en Stripe/GHL/logs)