Skip to main content

Guía de Despliegue

Todo lo que necesitas saber para desplegar Camarauth SDK en producción de forma segura y escalable.

Preparación

Checklist Pre-Deploy

  • JWT_SECRET configurado y seguro (mínimo 32 caracteres)
  • Base de datos PostgreSQL configurada
  • Evolution API funcionando y accesible
  • Variables de entorno configuradas
  • CORS configurado con orígenes específicos
  • SSL/TLS habilitado
  • Rate limiting activado
  • Logs configurados
  • Monitoreo implementado

Variables de Entorno

Opciones de Despliegue

1. VPS (DigitalOcean, Linode, AWS EC2)

1

Instalar Node.js

2

Clonar repositorio

3

Configurar PM2

4

Configurar Nginx

2. Docker

3. Railway/Render/Fly.io

SSL/TLS

Certbot (Let’s Encrypt)

Configuración HTTPS

Base de Datos

PostgreSQL en Producción

Migraciones

Monitoreo

Health Checks

Logging

Sentry

Escalado

Horizontal Scaling

Para escalar horizontalmente (múltiples instancias), necesitas:
  1. Redis para sesiones: Compartir estado entre instancias
  2. Load balancer: Distribuir tráfico
  3. Base de datos compartida: Todas las instancias usan la misma DB
  4. Sticky sessions: Mantener conexiones WebSocket

Seguridad

Firewall

Headers de Seguridad

Troubleshooting

Problemas Comunes

  • Verificar firewall (puerto 3001 abierto)
  • Verificar CORS
  • Verificar SSL/TLS
  • Revisar logs del servidor
  • Verificar DATABASE_URL
  • Verificar credenciales
  • Verificar que PostgreSQL esté corriendo
  • Verificar network/security groups
  • Verificar EVOLUTION_API_URL
  • Verificar EVOLUTION_API_KEY
  • Verificar que la instancia esté conectada
  • Probar webhook manualmente

Checklist Post-Deploy

  • Health check responde 200
  • WebSocket conecta correctamente
  • Base de datos responde
  • Evolution API responde
  • SSL/TLS funcionando
  • Logs aparecen correctamente
  • Rate limiting activo
  • CORS configurado correctamente
  • Variables de entorno cargadas
  • Monitoreo funcionando

Referencias