Lua 엔트리 종류

Lua 기반 엔트리 설정: 함수, 프로세스, 워크플로우, 라이브러리.

엔트리 종류

종류 설명
function.lua 상태 없는 함수, 요청 시 실행
process.lua 상태를 가진 장기 실행 액터
workflow.lua 내구성 있는 워크플로우 (Temporal)
library.lua 다른 엔트리가 임포트하는 공유 코드
module.lua 모듈 표면 (다중 메서드 라이브러리)

각 종류에는 wippy pack --bytecode로 생성되는 사전 컴파일된 바이트코드 대응 항목(function.lua.bc, library.lua.bc, process.lua.bc, workflow.lua.bc)이 있습니다. 작성자는 .lua 엔트리를 작성하고, 바이트코드 종류는 패킹 시 자동으로 생성됩니다.

공통 필드

모든 Lua 엔트리는 이 필드를 공유합니다:

필드 필수 설명
name 예 네임스페이스 내 고유 이름
kind 예 위의 Lua 종류 중 하나
source 예 Lua 파일 경로 (file://path.lua)
method function/process/workflow 내보낼 함수 (라이브러리는 사용하지 않음)
modules 아니오 require()에 허용된 모듈
imports 아니오 로컬 모듈로 사용할 다른 엔트리
meta 아니오 검색 가능한 메타데이터

function.lua

요청 시 호출되는 상태 없는 함수. 각 호출은 독립적입니다.

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

용도: HTTP 핸들러, 데이터 변환, 유틸리티.

process.lua

메시지 간 상태를 유지하는 장기 실행 액터. 메시지 전달을 통해 통신합니다.

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

용도: 백그라운드 워커, 서비스 데몬, 상태를 가진 액터.

슈퍼바이즈되는 서비스로 실행하려면:

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

workflow.lua

재시작에도 유지되는 내구성 있는 워크플로우. 상태는 Temporal에 지속됩니다.

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

용도: 다단계 비즈니스 프로세스, 장기 실행 오케스트레이션.

library.lua

다른 엔트리가 임포트할 수 있는 공유 코드.

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

다른 엔트리에서 imports로 참조합니다:

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

Lua 코드에서:

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

모듈

modules 필드는 require()로 로드할 수 있는 모듈을 제어합니다:

modules:
  - http
  - json
  - sql
  - process

channel, print, subscribe, unsubscribe는 Lua 전역으로 로드되어 modules:에 나열할 필요가 없습니다.

나열된 모듈만 사용 가능합니다. 이를 통해 다음을 보장합니다:

  • 보안: 시스템 모듈 접근 방지
  • 명시적 의존성: 코드에 필요한 것이 명확함
  • 결정론: 워크플로우는 결정론적 모듈만 사용

사용 가능한 모듈은 Lua 런타임을 참조하세요.

임포트

다른 엔트리를 로컬 모듈로 임포트합니다:

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

키가 Lua 코드의 모듈 이름이 됩니다. 값은 엔트리 ID (namespace:name)입니다.

풀 설정

함수의 실행 풀을 설정합니다:

- name: handler
  kind: function.lua
  source: file://handler.lua
  method: main
  pool:
    type: adaptive    # 기본값
    size: 4           # 초기 워커 수
    max_size: 16      # 탄력적 풀의 상한
필드 풀 설명
type 모두 스케줄러 구현 (아래 표 참조)
size static, lazy, adaptive 초기 워커 수
workers engine v2 워커 스레드 수
buffer static, adaptive 작업 큐 용량 (기본값 workers * 64)
warm_start adaptive 시작 시 엔트리 사전 컴파일
max_size lazy, adaptive 탄력적 확장 상한 (기본값 16)
유형 동작
inline 호출자의 고루틴에서 동기 실행. 최저 지연, 호출 간 격리 없음.
lazy 유휴 시 워커 없음, 요청 시 생성, 유휴 시 제거.
static 채널 기반 고정 크기 풀. 안정 부하에서 예측 가능.
adaptive 자동 확장 풀 — 부하 시 증가, 유휴 시 감소. 기본값.

메타데이터

라우팅 및 발견을 위해 meta를 사용합니다:

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

메타데이터는 레지스트리를 통해 검색 가능합니다:

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

참고