Tipos de Entrada Lua

Configuración para entradas basadas en Lua: funciones, procesos, flujos de trabajo y bibliotecas.

Tipos de Entrada

Tipo Descripción
function.lua Función sin estado, se ejecuta bajo demanda
process.lua Actor de larga duración con estado
workflow.lua Flujo de trabajo durable (Temporal)
library.lua Código compartido importado por otras entradas
module.lua Superficie de módulo (biblioteca con múltiples métodos)

Cada tipo tiene una contraparte de bytecode precompilado (function.lua.bc, library.lua.bc, process.lua.bc, workflow.lua.bc) producida por wippy pack --bytecode. Los autores escriben entradas .lua; los tipos de bytecode se emiten automáticamente al empaquetar.

Campos Comunes

Todas las entradas Lua comparten estos campos:

Campo Requerido Descripción
name sí Nombre único dentro del namespace
kind sí Uno de los tipos Lua anteriores
source sí Ruta del archivo Lua (file://path.lua)
method function/process/workflow Función a exportar (las bibliotecas no la usan)
modules no Módulos permitidos para require()
imports no Otras entradas como módulos locales
meta no Metadatos buscables

function.lua

Función sin estado llamada bajo demanda. Cada invocación es independiente.

- name: handler
  kind: function.lua
  source: file://handler.lua
  method: main
  modules:
    - http
    - json

Usar para: Manejadores HTTP, transformaciones de datos, utilidades.

process.lua

Actor de larga duración que mantiene estado entre mensajes. Se comunica mediante paso de mensajes.

- name: worker
  kind: process.lua
  source: file://worker.lua
  method: main
  modules:
    - process
    - sql

Usar para: Trabajadores en segundo plano, demonios de servicio, actores con estado.

Para ejecutar como servicio supervisado:

- name: worker_service
  kind: process.service
  process: app:worker
  host: app:processes
  lifecycle:
    auto_start: true
    restart:
      max_attempts: 10

workflow.lua

Flujo de trabajo durable que sobrevive a reinicios. El estado se persiste en Temporal.

- name: order_processor
  kind: workflow.lua
  source: file://order_workflow.lua
  method: main
  modules:
    - workflow
    - time

Usar para: Procesos de negocio de múltiples pasos, orquestaciones de larga duración.

library.lua

Código compartido que puede ser importado por otras entradas.

- name: helpers
  kind: library.lua
  source: file://helpers.lua
  modules:
    - json
    - base64

Otras entradas lo referencian vía imports:

- name: handler
  kind: function.lua
  source: file://handler.lua
  method: main
  imports:
    helpers: app.lib:helpers

En código Lua:

local helpers = require("helpers")
helpers.format_date(timestamp)

Módulos

El campo modules controla qué módulos pueden cargarse con require():

modules:
  - http
  - json
  - sql
  - process

channel, print, subscribe y unsubscribe se cargan como globales de Lua y no necesitan aparecer en modules:.

Solo los módulos listados están disponibles. Esto proporciona:

  • Seguridad: Prevenir acceso a módulos del sistema
  • Dependencias explícitas: Claro qué necesita el código
  • Determinismo: Los flujos de trabajo solo obtienen módulos determinísticos

Consulte Runtime de Lua para módulos disponibles.

Imports

Importe otras entradas como módulos locales:

imports:
  utils: app.lib:utils       # require("utils")
  auth: app.auth:helpers     # require("auth")

La clave se convierte en el nombre del módulo en código Lua. El valor es el ID de entrada (namespace:name).

Configuración de Pool

Configure el pool de ejecución para funciones:

- name: handler
  kind: function.lua
  source: file://handler.lua
  method: main
  pool:
    type: adaptive    # por defecto
    size: 4           # workers iniciales
    max_size: 16      # tope para pools elásticos
Campo Pools Descripción
type todos Implementación del scheduler (ver tabla abajo)
size static, lazy, adaptive Cantidad inicial de workers
workers engine v2 Cantidad de hilos worker
buffer static, adaptive Capacidad de la cola de tareas (por defecto workers * 64)
warm_start adaptive Precompilar entradas al inicio
max_size lazy, adaptive Tope superior para crecimiento elástico (por defecto 16)
Tipo Comportamiento
inline Ejecución síncrona en la goroutine del llamador. Mínima latencia, sin aislamiento entre llamadas.
lazy Cero workers en reposo, se crean bajo demanda y se eliminan cuando están inactivos.
static Pool de tamaño fijo basado en canales. Predecible bajo carga estable.
adaptive Pool auto-escalable — crece bajo carga, se reduce cuando está inactivo. Predeterminado.

Metadatos

Use meta para enrutamiento y descubrimiento:

- name: api_handler
  kind: function.lua
  meta:
    type: handler
    version: "2.0"
    tags: [api, users]
  source: file://api.lua
  method: handle
  modules:
    - http
    - json

Los metadatos son buscables vía el registro:

local registry = require("registry")
local handlers = registry.find({type = "handler"})

Vea También