┌─────────────────────────────────────────────────────────────────┐
│ Internet │
└────────────────────────────┬────────────────────────────────────┘
│
▼
┌─────────────────┐
│ DNS / CDN │
│ tu-dominio.com │
└────────┬────────┘
│
▼
┌────────────────────────────────────────────────────────────────┐
│ Kubernetes Cluster │
│ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ Ingress Controller │ │
│ │ (nginx / traefik / etc.) │ │
│ └──────────────────────┬───────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ Ingress Resource │ │
│ │ (wapi.namespace) │ │
│ │ Routes: your-domain.com │ │
│ └──────────────────────┬───────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ Service (ClusterIP) │ │
│ │ Port: 80 → 3000 │ │
│ └──────────────────────┬───────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ Deployment │ │
│ │ Replicas: 1 │ │
│ │ Strategy: Recreate │ │
│ │ │ │
│ │ ┌────────────────────────────────────────────────────┐ │ │
│ │ │ Pod: wapi │ │ │
│ │ │ │ │ │
│ │ │ ┌──────────────────────────────────────────────┐ │ │ │
│ │ │ │ Container: wapi │ │ │ │
│ │ │ │ Image: your-registry/wapi:latest │ │ │ │
│ │ │ │ Port: 3000 │ │ │ │
│ │ │ │ │ │ │ │
│ │ │ │ Environment Variables: │ │ │ │
│ │ │ │ ├─ ConfigMap: wapi-config │ │ │ │
│ │ │ │ │ ├─ NODE_ENV │ │ │ │
│ │ │ │ │ ├─ BETTER_AUTH_URL │ │ │ │
│ │ │ │ │ └─ ... │ │ │ │
│ │ │ │ │ │ │ │ │
│ │ │ │ └─ Secret: wapi-secrets │ │ │ │
│ │ │ │ ├─ DATABASE_URL │ │ │ │
│ │ │ │ ├─ DATABASE_AUTH_TOKEN │ │ │ │
│ │ │ │ └─ BETTER_AUTH_SECRET │ │ │ │
│ │ │ │ │ │ │ │
│ │ │ │ Volume Mounts: │ │ │ │
│ │ │ │ ├─ /app/whatsapp_sessions │ │ │ │
│ │ │ │ └─ /app/public/media │ │ │ │
│ │ │ │ │ │ │ │
│ │ │ │ Resource Limits: │ │ │ │
│ │ │ │ ├─ CPU: 250m - 1000m │ │ │ │
│ │ │ │ └─ Memory: 512Mi - 2Gi │ │ │ │
│ │ │ │ │ │ │ │
│ │ │ │ Health Checks: │ │ │ │
│ │ │ │ ├─ Liveness Probe (HTTP GET /) │ │ │ │
│ │ │ │ └─ Readiness Probe (HTTP GET /) │ │ │ │
│ │ │ └──────────────────────────────────────────────┘ │ │ │
│ │ └─────────────────────────────────────────────────────┘ │ │
│ │ │ │ │ │
│ │ ▼ ▼ │ │
│ │ ┌──────────────────┬──────────────────┐ │ │
│ │ │ │ │ │ │
│ │ ▼ ▼ │ │ │
│ │ ┌───────────────────┐ ┌──────────────────┐ │ │ │
│ │ │ PVC: │ │ PVC: │ │ │ │
│ │ │ whatsapp-sessions│ │ media │ │ │ │
│ │ │ (5Gi) │ │ (20Gi) │ │ │ │
│ │ └─────────┬─────────┘ └────────┬─────────┘ │ │ │
│ │ │ │ │ │ │
│ │ ▼ ▼ │ │ │
│ │ ┌───────────────────┐ ┌──────────────────┐ │ │ │
│ │ │ Persistent │ │ Persistent │ │ │ │
│ │ │ Volume (PV) │ │ Volume (PV) │ │ │ │
│ │ └───────────────────┘ └──────────────────┘ │ │ │
│ └──────────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ HorizontalPodAutoscaler (HPA) │ │
│ │ Min: 1, Max: 1 (No scaling) │ │
│ └──────────────────────────────────────────────────────────┘ │
│ │
└────────────────────────────────────────────────────────────────┘
Usuario → DNS → Ingress Controller → Ingress Resource → Service → Pod → Aplicación Next.js
Aplicación Next.js → Volume Mount → PVC → PV → Storage Backend
Pod → Environment Variables → ConfigMap (públicas) + Secrets (sensibles)
- Aísla todos los recursos de la aplicación
- Facilita la gestión y el RBAC
- Variables de entorno no sensibles
- Fácilmente actualizable sin rebuild
- Ejemplos: NODE_ENV, BETTER_AUTH_URL
- Credenciales y datos sensibles
- Base64 encoded
- Ejemplos: DATABASE_URL, AUTH_SECRET
whatsapp-sessions (5Gi)
- Almacena las sesiones de WhatsApp
- Crítico - contiene las credenciales de autenticación
- Backup frecuente recomendado
media (20Gi)
- Almacena archivos multimedia
- Imágenes, videos, documentos recibidos
- Tamaño ajustable según necesidad
- Replicas: 1 (no escalar debido a sesiones de WhatsApp)
- Strategy: Recreate (evita conflictos de sesión)
- Image: Next.js standalone build
- Health Checks: Liveness + Readiness probes
- Tipo: ClusterIP (interno al cluster)
- Expone el pod en el puerto 80
- Redirige al puerto 3000 del container
- Punto de entrada externo
- Maneja routing por dominio
- Soporte TLS/SSL opcional
- Integración con cert-manager
- Configurado con min=1, max=1
- Previene escalado automático
- Necesario por limitaciones de sesiones de WhatsApp
Internet → Ingress Controller → wapi Pod → External Services (Database, APIs)
✓ Permitido ✓ Permitido ✓ Permitido
wapi Pod → Otros Namespaces
✗ Bloqueado (configurable)
- Usuario no-root (nextjs:1001)
- Read-only filesystem (excepto volúmenes)
- No privilegios escalados
- Capabilities mínimos
┌─────────────────────────────────────────────────────────────┐
│ Backup Strategy │
├─────────────────────────────────────────────────────────────┤
│ │
│ Daily: │
│ ├─ WhatsApp Sessions → Cloud Storage / NAS │
│ └─ Media Files → Cloud Storage / NAS │
│ │
│ Before Updates: │
│ ├─ Complete snapshot de PVs │
│ └─ Export de configuraciones │
│ │
│ Methods: │
│ ├─ CronJob en Kubernetes │
│ ├─ Velero (cluster backup) │
│ └─ Manual: ./deploy.sh backup │
│ │
└─────────────────────────────────────────────────────────────┘
# En tiempo real
kubectl logs -f deployment/wapi -n wapi
# Últimas 100 líneas
kubectl logs --tail=100 deployment/wapi -n wapi
# Desde hace 1 hora
kubectl logs --since=1h deployment/wapi -n wapi# CPU y Memoria
kubectl top pod -n wapi
# Eventos
kubectl get events -n wapi --sort-by='.lastTimestamp'# Estado general
kubectl get all -n wapi
# Detalles del pod
kubectl describe pod -n wapi -l app=wapi- WhatsApp sessions no son compartibles
- Storage PV no soporta ReadWriteMany
- Estado de sesión es local al pod
-
Session Storage Distribuido
- Redis/Memcached para sesiones
- Database compartida para estado
-
Sticky Sessions
- Session affinity en el Ingress
- Routing basado en cuenta de WhatsApp
-
Storage Class con RWX
- NFS o similar para múltiples pods
- EFS (AWS), Filestore (GCP), Azure Files
- 1 Pod: ~512Mi RAM, 0.25 CPU
- Storage: 25Gi (5Gi sessions + 20Gi media)
- Ingress: Varía según proveedor
AWS EKS:
- Node: t3.small ($0.0208/hr) = ~$15/mes
- EBS Volume: 25GB ($0.10/GB) = ~$2.5/mes
- ALB: ~$16/mes
- Total: ~$33-35/mes
Google GKE:
- Node: e2-small ($0.021/hr) = ~$15/mes
- PD Storage: 25GB ($0.17/GB) = ~$4.25/mes
- Ingress: Incluido
- Total: ~$19-20/mes
DigitalOcean:
- Node: Basic ($12/mes)
- Volume: 25GB ($2.50/mes)
- Load Balancer: $10/mes
- Total: ~$24-25/mes
Nota: Costos aproximados, verificar precios actuales
┌─────────────┐ ┌──────────────┐ ┌─────────────┐ ┌──────────────┐
│ Git Push │ -> │ Build Image │ -> │ Push to ECR │ -> │ Update K8s │
│ to master │ │ (Docker) │ │ / GCR / etc │ │ Deployment │
└─────────────┘ └──────────────┘ └─────────────┘ └──────────────┘
│ │
▼ ▼
┌──────────────┐ ┌──────────────┐
│ Run Tests │ │ Health Check│
│ Lint, Unit │ │ Smoke Tests │
└──────────────┘ └──────────────┘
│ │
▼ ▼
┌──────────────┐ ┌──────────────┐
│ Security │ │ Rollback if │
│ Scan Image │ │ Failure │
└──────────────┘ └──────────────┘