Guía de Instalación On-Premise

Requirements for installing the EKB platform in your environment.

Este documento describe los prerrequisitos previos al despliegue, los pasos de verificación y las consideraciones necesarias para la instalación y despliegue exitoso del producto EKB On-Premise. Está destinado a servir como una lista de verificación completa para garantizar que el entorno del cliente esté configurado correctamente y cumpla con todos los requisitos necesarios antes de proceder con el despliegue.

​

Prerrequisitos

​

Requisitos de Acceso

• Acceso al Servidor:
  • Confirme el acceso a los servidores de despliegue con privilegios sudo.
  • Verifique que todas las rutas de red necesarias estén establecidas a través de una VPN segura o una configuración de red dedicada.
• Permisos de Usuario:
  • Asegúrese de que el equipo de despliegue haya recibido los permisos de acceso necesarios.
  • Valide que cualquier autenticación de dos factores (2FA) o token de seguridad requerido esté configurado.

​

Requisitos del Sistema

Sistema Operativo: Ubuntu 22 o RHEL 8.10

Especificaciones de Hardware:

Para cada nivel de despliegue, asegúrese de que el hardware cumpla o supere los siguientes requisitos:

Nivel	Nucleos	RAM (GB)	SSD
PEQUEÑO	16	64	1TB
MEDIANO	32	128	2TB
GRANDE	Personalizado	Personalizado	Personalizado

• GPU (Requerida cuando se despliega un LLM en la misma máquina que la plataforma EKB.)
• PEQUEÑO: ~500 (100 Concurrentes) usuarios pueden ser soportados por una sola VM de 16 núcleos, 64gb ram, 1 TB SSD. Estas máquinas cuestan ~$600 al mes. Este es un despliegue de tamaño mínimo.
• MEDIANO: ~2000 (500 Concurrentes) usuarios pueden ser soportados por una máquina más grande de 32 núcleos, 128gb ram, 2 TB SSD. Estas máquinas cuestan aproximadamente ~$1,200 al mes.
• GRANDE: ~10000 (1000+ Concurrentes) usuarios deben ser desplegados a través de contenedores para que la infraestructura pueda escalar según las necesidades, esto típicamente cuesta un mínimo de $2,000 al mes. Se sugiere calcular$2,000 al mes por cada 1,000 Usuarios Activos adicionales. Este es un despliegue completamente distribuido.

​

Herramientas de Despliegue y Dependencias de Software

• Scripts de Despliegue:
  • Scripts de despliegue Bash verificados y controlados por versiones.
• Herramientas de Gestión de Dependencias:
  • Python 3
  • Git (versión actual)
  • Docker (v27.1.1) o Podman
• Herramientas Adicionales (Opcional):
  • Herramientas de registro y monitoreo (por ejemplo, ELK Stack, Prometheus, Grafana) según los requisitos de monitoreo del cliente.

​

Credenciales y Claves

• Credenciales del Servidor:
  • Asegúrese de que todas las credenciales de acceso al servidor estén actualizadas y almacenadas de forma segura.
• Claves API y Licencias de la Aplicación:
  • Verifique que todas las claves API y licencias específicas de la aplicación (por ejemplo, OpenAI, SERP, Sentry) estén disponibles y sean válidas.

​

Lista de Verificación Previa al Despliegue

​

Verificación de Hardware y Sistema

Asegúrese de que la configuración de hardware y sistema del cliente coincida con las especificaciones:

# Verificar información de CPU

lscpu                         # Funciona tanto en Ubuntu como en RHEL

cat /proc/cpuinfo             # Información de CPU más detallada


# Verificar uso de memoria

free -h                       # Formato legible para uso de memoria

cat /proc/meminfo             # Información de memoria detallada


# Verificar uso de almacenamiento

df -h                         # Muestra el uso de disco

lsblk                         # Lista dispositivos de bloques y particiones

​

3.2 Verificación de Software y Dependencias

Verifique que todos los componentes de software necesarios estén instalados y con las versiones correctas:

# Verificar versión de Docker

docker --version              # Aplicable tanto para Ubuntu como para RHEL


# Verificar versión de Docker Compose

docker compose version        # Para configuraciones modernas de Docker
docker-compose --version      # Para instalaciones anteriores

```

# Verificar versión de Python

python3 --version             # Verificación preferida para Python 3

python --version              # Alternativa si python3 no está disponible


# Verificar versión de Git

git --version                 # Válido tanto para Ubuntu como para RHEL

​

3.3 Verificación de Red y Conectividad

Asegúrese de que la red esté configurada correctamente y de que haya conectividad de Internet adecuada para dependencias externas o actualizaciones:

# Verificar disponibilidad de conexión a Internet

ping -c 4 google.com          # Ping a Google para verificar la conectividad de red
curl -Is https://www.google.com | head -n 1  # Verificación alternativa usando curl

​

3.4 Verificaciones Adicionales

Servicios y puertos

Servicio	Ruta	Parámetro	Puertos internos	Puertos externos
Frontend	/	FRONTEND_SUFFIX	3000	—
Nginx	/	—	—	80, 443
Backend	/backend	BACKEND_SUFFIX	8001	—
Automator	/automator	AUTOMATOR_SUFFIX	8002	—
Redis	—	—	6379	—
RabbitMQ	—	—	5672, 15672	—
Supabase Kong API Gateway	/supabase	SUPABASE_SUFFIX	8000, 8443	8000, 8443 (solo admin)
Supabase Postgres	—	—	6543	—
PostgreSQL (automator)	—	—	5433	—
Redis (automator)	—	—	6380	—
Ollama	—	—	11434	— (solo si se despliega Ollama localmente)

Soporte de protocolos

Servicio	HTTP	HTTPS	WebSocket
Frontend	✓	✓	—
Nginx	✓	✓	—
Backend	✓	✓	—
Automator	✓	✓	—
Redis	✓	✓	—
RabbitMQ	✓	✓	—
Supabase Kong API Gateway	✓	✓	✓
Supabase Postgres	✓	✓	—
PostgreSQL (automator)	✓	✓	—
Redis (automator)	✓	✓	—
Ollama	✓	✓	—

Notas: Todas las máquinas internas deben poder comunicarse libremente entre sí. Recomendamos usar conexiones SSL (HTTPS); HTTP es compatible durante las PoC.

Configuraciones de Firewall y Seguridad:

Valide que las reglas del firewall o los grupos de seguridad permitan el tráfico requerido.

​

Arquitectura General

​

Diagrama de Arquitectura – On-Premise

Flujo de arquitectura de despliegue para una máquina virtual individual con la asignación de recursos prerequisito mencionada

​

Flujo de arquitectura de despliegue para despliegue en AWS Cloud