proxy_wasm_lua_resolver

Директива `proxy_wasm_lua_resolver` позволяет указать Lua-резолвер для модулей WebAssembly в NGINX, обеспечивая динамическое разрешение модулей Wasm.

Синтаксисproxy_wasm_lua_resolver name;
По умолчаниюnone
Контекст
Аргументы1

Описание

Директива proxy_wasm_lua_resolver объединяет возможности Lua-скриптинга с функциональностью Proxy-Wasm в NGINX, работающем на рантайме Wasmtime. Она позволяет динамически разрешать модули WebAssembly (Wasm) на основе кода Lua, обеспечивая более гибкие и программируемые конфигурации. Используя Lua для определения того, какой модуль Wasm загружать, администраторы могут реализовывать сложную логику, выходящую за рамки статической конфигурации.

Эта директива особенно полезна, когда выбор модуля Wasm зависит от данных во время выполнения, таких как URL запроса или заголовки. Ожидается, что Lua-резолвер вернёт имя или путь модуля Wasm, который должен быть выполнен для конкретного запроса, обеспечивая бесшовное взаимодействие в потоке обработки NGINX. Введение этой директивы добавляет уровень программируемости, который может использовать мощные возможности скриптинга Lua в контексте веб-сервера NGINX.

Параметры директивы proxy_wasm_lua_resolver включают имя резолвера, которое обычно указывает на Lua-скрипт, ответственный за разрешение путей к модулям Wasm. Директива используется в контекстах, где решения о выполнении Wasm должны приниматься на основе динамических условий, что делает её неоценимой для разработчиков, стремящихся создавать модульные и адаптируемые веб-службы с использованием NGINX.

Пример конфига

http {
    # Define a Lua resolver for resolving Wasm modules
    proxy_wasm_lua_resolver my_lua_resolver;

    server {
        listen 8080;

        location /myapi {
            # Use the specified Lua resolver to determine the Wasm module
            proxy_wasm  my_filter;
            proxy_pass  http://backend;
        }
    }
}

Убедитесь, что скрипт резолвера Lua правильно определён и доступен в контексте NGINX.

Проверьте, что возвращаемый путь от резолвера Lua указывает на действительный Wasm‑модуль.

Отладка скриптов Lua может потребовать дополнительных инструментов или логирования в конфигурации NGINX.

← Ко всем директивам