Luaエントリ種別

Luaエントリ種別

Luaベースエントリの設定：関数、プロセス、ワークフロー、ライブラリ。

エントリ種別

種別	説明
function.lua	ステートレス関数、オンデマンド実行
process.lua	状態を持つ長時間実行アクター
workflow.lua	耐久性のあるワークフロー（Temporal）
library.lua	他のエントリにインポートされる共有コード
module.lua	モジュール表面（複数メソッドのライブラリ）

各種別には事前コンパイル済みのバイトコード対応版（function.lua.bc、library.lua.bc、process.lua.bc、workflow.lua.bc）があり、wippy pack --bytecode によって生成されます。作成者は .lua エントリを書き、バイトコード種別はパック時に自動生成されます。

共通フィールド

すべてのLuaエントリは以下のフィールドを共有：

フィールド	必須	説明
name	yes	名前空間内で一意の名前
kind	yes	上記のLua種別の1つ
source	yes	Luaファイルパス（file://path.lua）
method	function/process/workflow	エクスポートする関数（ライブラリでは使用しない）
modules	no	require()で許可されるモジュール
imports	no	ローカルモジュールとしての他のエントリ
meta	no	検索可能なメタデータ

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

再起動に耐えるdurableワークフロー。状態は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"})

関連項目

• エントリ種別 - 全エントリ種別リファレンス
• コンピュートユニット - 関数 vs プロセス vs ワークフロー
• Luaランタイム - 利用可能なモジュール