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
- Redis para sesiones: Compartir estado entre instancias
- Load balancer: Distribuir tráfico
- Base de datos compartida: Todas las instancias usan la misma DB
- Sticky sessions: Mantener conexiones WebSocket
Seguridad
Firewall
Headers de Seguridad
Troubleshooting
Problemas Comunes
WebSocket no conecta
WebSocket no conecta
- Verificar firewall (puerto 3001 abierto)
- Verificar CORS
- Verificar SSL/TLS
- Revisar logs del servidor
Base de datos no conecta
Base de datos no conecta
- Verificar DATABASE_URL
- Verificar credenciales
- Verificar que PostgreSQL esté corriendo
- Verificar network/security groups
Evolution API no responde
Evolution API no responde
- 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

