Saltar al contenido principal

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 .env del backend con claves live (Stripe, JWT, SMTP, GHL, n8n)
  • Actualizar .env del frontend (VITE_*, PUBLIC_*)
  • Configurar DNS y certificados TLS para FRONTEND_HOST, BACKEND_HOST y DOCS_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_log sin 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 down y 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)

Más Información