Instalación

Requisitos

• Docker y Docker Compose
• Git

Instalación con Docker (Recomendado)

# Clonar el repositorio
git clone https://github.com/NeftaliYagua/Pasarela.git
cd Pasarela

# Cambiar a la rama v2
git checkout feature/v2-redis-kafka

# Levantar el stack completo
cd infraestructura
docker compose up -d

Servicios incluidos

Servicio	Puerto	Descripción
Pasarela	5000	Gateway principal (4 instancias balanceadas)
Ejemplos	8000	Aplicaciones de ejemplo
Grafana	3000	Dashboards (admin/admin)
Prometheus	9090	Métricas
Kafka UI	8080	Administrador de Kafka
Redis Commander	8081	Administrador de Redis

Verificar instalación

# Health check
curl http://localhost:5000/health

# Debería responder:
# {"status":"ok","instance":"1","connections":0}

Instalación para desarrollo

cd pasarela
npm install
npm run dev

Variables de entorno

Variable	Default	Descripción
PORT	5000	Puerto del servidor
REDIS_URL	redis://localhost:6379	URL de Redis
KAFKA_BROKERS	(vacío)	Brokers de Kafka (opcional)
INSTANCE_ID	PID	ID de la instancia

Estructura del stack

infraestructura/
├── docker-compose.yml      # Orquestación
├── haproxy/
│   └── haproxy.cfg         # Configuración del balanceador
├── prometheus/
│   └── prometheus.yml      # Configuración de métricas
└── grafana/
    └── provisioning/       # Dashboards y datasources