Wasm

WebAssembly 绑定组件的详细文档

概述

借助 WebAssembly，你可以安全地运行以其他语言编译的代码。运行时执行 WebAssembly 模块（Wasm），它们通常是带有 .wasm 扩展名的二进制文件。

Wasm 绑定允许你通过向其传递命令行参数或环境变量来调用编译为 Wasm 的程序，就像使用普通子进程一样。例如，即使 Dapr 是用 Go 编写的，并且运行在未安装 Python 的平台上，你也可以使用 Python 来满足调用请求！

Wasm 二进制文件必须是使用 WebAssembly 系统接口（WASI）编译的程序。该二进制文件可以是你编写的程序（例如 Go），或者是你用于运行内联脚本的解释器（例如 Python）。

你至少需要指定一个使用规范 WASI 版本 wasi_snapshot_preview1（也称为 wasip1）编译的 Wasm 二进制文件，通常简称为 wasi。

注意： 如果使用 Go 1.21+ 编译，这是 GOOS=wasip1 GOARCH=wasm。在 TinyGo、Rust 和 Zig 中，这是目标 wasm32-wasi。

你也可以重用现有的二进制文件。例如，Wasm Language Runtimes 分发了已编译为 WASI 的解释器（包括 PHP、Python 和 Ruby）。

Wasm 二进制文件从 URL 加载。例如，URL file://rewrite.wasm 从进程的当前目录加载 rewrite.wasm。在 Kubernetes 上，请参阅如何：将 Pod 卷挂载到 Dapr 边车以配置可以包含 Wasm 二进制文件的文件系统挂载。 也可以从远程 URL 获取 Wasm 二进制文件。在这种情况下，URL 必须精确指向一个 Wasm 二进制文件。例如：

  • http://example.com/rewrite.wasm，或
  • https://example.com/rewrite.wasm。

Dapr 使用 wazero 来运行这些二进制文件，因为它没有依赖项。这使得除了 Dapr 本身之外，无需安装任何东西即可使用 WebAssembly。

Wasm 输出绑定支持使用 wasi-http 规范进行 HTTP 客户端调用。 你可以在以下位置找到多种语言进行 HTTP 调用的示例代码：

组件格式

要配置 Wasm 绑定，请创建类型为 bindings.wasm 的组件。请参阅本指南了解如何创建和应用绑定配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: wasm
spec:
  type: bindings.wasm
  version: v1
  metadata:
    - name: url
      value: "file://uppercase.wasm"

规范元数据字段

字段详情必填示例
url包含要实例化的 Wasm 二进制文件的资源 URL。支持的协议包括 file://、http:// 和 https://。file:// URL 的路径相对于 Dapr 进程，除非它以 / 开头。truefile://hello.wasm, https://example.com/hello.wasm

绑定支持

此组件支持 输出绑定，具有以下操作：

  • execute

示例请求

data 字段（如果存在）将是程序的 STDIN。你可以选择在每个请求中传递元数据属性：

  • args 任何 CLI 参数，以逗号分隔。这不包括程序名称。

例如，考虑将 url 绑定到 Ruby 解释器，例如来自 webassembly-language-runtimes：

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: wasm
spec:
  type: bindings.wasm
  version: v1
  metadata:
  - name: url
    value: "https://github.com/vmware-labs/webassembly-language-runtimes/releases/download/ruby%2F3.2.0%2B20230215-1349da9/ruby-3.2.0-slim.wasm"

假设你想在端口 3500 上启动 Dapr 并使用 Wasm 绑定，你可以运行：

$ dapr run --app-id wasm --dapr-http-port 3500 --resources-path components

以下请求返回 Hello "salaboy"：

$ curl -X POST http://localhost:3500/v1.0/bindings/wasm -d'
{
  "operation": "execute",
  "metadata": {
    "args": "-ne,print \"Hello \"; print"
  },
  "data": "salaboy"
}'

相关链接