Supervisión

El supervisor gestiona los ciclos de vida de los servicios, manejando el orden de inicio, reinicios automáticos, y apagado graceful. Los servicios con auto_start: true se inician cuando la aplicación arranca.

Configuración de Ciclo de Vida

Los servicios se registran con el supervisor usando un bloque lifecycle. Para procesos, use process.service para envolver una definición de proceso:

# Definición del proceso (el código)
- name: worker_process
  kind: process.lua
  source: file://worker.lua
  method: main

# Servicio supervisado (envuelve el proceso con gestión de ciclo de vida)
- name: worker
  kind: process.service
  process: app:worker_process
  host: app:processes
  lifecycle:
    auto_start: true
    start_timeout: 30s
    stop_timeout: 10s
    stable_threshold: 5s
    depends_on:
      - app:database
    restart:
      initial_delay: 2s
      max_delay: 60s
      max_attempts: 10

Resolución de Dependencias

El supervisor resuelve dependencias de dos fuentes:

1. Dependencias explícitas declaradas en depends_on
2. Dependencias extraídas del registro desde referencias de entrada (ej., database: app:db en su config)

graph LR
    A[Servidor HTTP] --> B[Router]
    B --> C[Función Handler]
    C --> D[Base de Datos]
    C --> E[Cache]

Las dependencias inician antes que los dependientes. Si el Servicio C depende de A y B, tanto A como B deben alcanzar el estado Running antes de que C inicie.

Política de Reinicio

Cuando un servicio falla, el supervisor reintenta con backoff exponencial:

lifecycle:
  restart:
    initial_delay: 1s      # Espera del primer reintento
    max_delay: 90s         # Tope máximo de delay
    backoff_factor: 2.0    # Multiplicador de delay por intento
    jitter: 0.1            # +-10% de aleatorización
    max_attempts: 0        # 0 = reintentos infinitos

Cuando un servicio se ejecuta por más tiempo que stable_threshold, el contador de reintentos se resetea. Esto previene que fallos transitorios escalen permanentemente los delays.

Errores Terminales

Estos errores detienen los intentos de reintento:

• Cancelación de contexto
• Solicitud de terminación explícita
• Errores marcados como no reintentables

Contexto de Seguridad

Los servicios pueden ejecutarse con una identidad de seguridad específica:

# Definición del proceso
- name: admin_worker_process
  kind: process.lua
  source: file://admin_worker.lua
  method: main

# Servicio supervisado con contexto de seguridad
- name: admin_worker
  kind: process.service
  process: app:admin_worker_process
  host: app:processes
  lifecycle:
    auto_start: true
    security:
      actor:
        id: "service:admin-worker"
        meta:
          role: admin
      groups:
        - app:admin_policies
      policies:
        - app:data_access

El contexto de seguridad establece:

El código ejecutándose en el servicio hereda este contexto de seguridad. El módulo security puede entonces verificar permisos:

local security = require("security")

if security.can("delete", "users") then
    -- permitido
end

Estados del Servicio

stateDiagram-v2
    [*] --> Inactive
    Inactive --> Starting
    Starting --> Running
    Running --> Stopping
    Stopping --> Stopped
    Stopped --> [*]

    Running --> Failed
    Starting --> Failed
    Failed --> Starting : reintentar

El supervisor transiciona servicios a través de estos estados:

Orden de Inicio y Apagado

Inicio: Dependencias primero, luego dependientes. Servicios al mismo nivel de dependencia pueden iniciar en paralelo.

Apagado: Dependientes primero, luego dependencias. Esto asegura que los servicios dependientes terminen antes de que sus dependencias se detengan.

Inicio:  database -> cache -> handler -> http_server
Apagado: http_server -> handler -> cache -> database

Ver También

• Modelo de Procesos - Ciclo de vida de procesos
• Configuración - Formato de configuración YAML
• Módulo Security - Verificaciones de permisos en Lua