Servicios Activos

Section titled “Servicios Activos”
ServicioPuertoDescripciónEstado
ailab-gateway.service8008Gateway OpenAI-compatible con sanitización✅ Enabled
ailab-router.service8083Router API (API interna)✅ Enabled
ailab-live-state.service—Snapshots de estado del sistema✅ Enabled
ailab-heartbeat.service—Heartbeat persistente del cluster✅ Enabled
ailab-live-api.service8084Live API (estado vivo, embeddings)✅ Enabled
ailab-docs.service4322Portal de documentación Astro (privado)✅ Enabled
ailab-metrics.service3010Dashboard SSR (público)✅ Enabled

Nota: stacks externos (p.ej. reverse proxy) pueden existir, pero no forman parte del core runtime salvo que estén en el flujo de autoridad/evidencia.

Gestión

Section titled “Gestión”
Terminal window
# Estado de todos los servicios
systemctl status ailab-*


# Reiniciar un servicio
sudo systemctl restart ailab-gateway.service


# Ver logs
journalctl -u ailab-gateway.service -n 50 --no-pager


# Habilitar/Deshabilitar autoarranque
sudo systemctl enable ailab-gateway.service
sudo systemctl disable ailab-gateway.service

Dependencias

Section titled “Dependencias”

ailab-router.service depende de ailab-gateway.service (After). Todos los servicios core dependen de network-online.target.

Límites de Recursos

Section titled “Límites de Recursos”
ServicioMemoryMax
ailab-gateway256M
ailab-router256M
ailab-live-state128M
ailab-heartbeat128M
ailab-live-api128M
ailab-docs512M
(stacks externos)N/A

Recuperación Post-Reboot

Section titled “Recuperación Post-Reboot”

Todos los servicios systemd arrancan automáticamente al iniciar el sistema. Adicionalmente, el script scripts/startup.sh se ejecuta via cron @reboot para verificar que los componentes externos necesarios también estén operativos:

Terminal window
# Verificar último arranque
cat /opt/ai-lab/logs/startup.log


# Ejecutar manualmente
/opt/ai-lab/scripts/startup.sh

Para más detalles, consultar el runbook de post-reboot y el incidente registrado.