Wasm 工作负载（测试版）

Wasm（WebAssembly的缩写）是您今天在Docker中使用的Linux和Windows容器的快速、轻量级替代方案（带有一些权衡）。

本页面提供了关于在Docker中与Linux容器一起运行Wasm应用程序的新功能的信息。

开启 Wasm 工作负载

Wasm 工作负载需要启用 containerd 镜像存储 功能。如果您尚未使用 containerd 镜像存储， 则现有的镜像和容器将无法访问。

1. 导航到 Docker Desktop 中的设置。
2. 在常规选项卡中，勾选使用containerd拉取和存储镜像。
3. 转到开发中的功能并勾选启用Wasm选项。
4. 选择应用并重启以保存设置。
5. 在确认对话框中，选择安装以安装Wasm运行时。

Docker Desktop 下载并安装以下运行时，您可以使用它们来运行 Wasm 工作负载：

• io.containerd.slight.v1
• io.containerd.spin.v2
• io.containerd.wasmedge.v1
• io.containerd.wasmtime.v1
• io.containerd.lunatic.v1
• io.containerd.wws.v1
• io.containerd.wasmer.v1

使用示例

使用 docker run 运行 Wasm 应用程序

以下 docker run 命令在您的系统上启动一个 Wasm 容器：

$ docker run \
  --runtime=io.containerd.wasmedge.v1 \
  --platform=wasi/wasm \
  secondstate/rust-example-hello

运行此命令后，您可以访问 http://localhost:8080/ 查看此示例模块的“Hello world”输出。

如果您收到错误消息，请参阅 故障排除部分以获取帮助。

注意此命令中使用的--runtime和--platform标志：

• --runtime=io.containerd.wasmedge.v1: 通知 Docker 引擎您希望使用 Wasm containerd shim 而不是标准的 Linux 容器运行时
• --platform=wasi/wasm: 指定你想要使用的镜像架构。通过利用Wasm架构，你不需要为不同的机器架构构建单独的镜像。Wasm运行时会负责将Wasm二进制文件转换为机器指令的最后一步。

使用 Docker Compose 运行 Wasm 应用程序

相同的应用程序可以使用以下 Docker Compose 文件运行：

services:
  app:
    image: secondstate/rust-example-hello
    platform: wasi/wasm
    runtime: io.containerd.wasmedge.v1

使用正常的 Docker Compose 命令启动应用程序：

$ docker compose up

使用Wasm运行多服务应用程序

网络工作方式与您对Linux容器的期望相同，为您提供了将Wasm应用程序与其他容器化工作负载（如数据库）组合在单个应用程序堆栈中的灵活性。

在以下示例中，Wasm 应用程序利用了在容器中运行的 MariaDB 数据库。

1. 克隆仓库。

   $ git clone https://github.com/second-state/microservice-rust-mysql.git
   Cloning into 'microservice-rust-mysql'...
   remote: Enumerating objects: 75, done.
   remote: Counting objects: 100% (75/75), done.
   remote: Compressing objects: 100% (42/42), done.
   remote: Total 75 (delta 29), reused 48 (delta 14), pack-reused 0
   Receiving objects: 100% (75/75), 19.09 KiB | 1.74 MiB/s, done.
   Resolving deltas: 100% (29/29), done.
   

2. 导航到克隆的项目并使用 Docker Compose 启动项目。

   $ cd microservice-rust-mysql
   $ docker compose up
   [+] Running 0/1
   ⠿ server Warning                                                                                                  0.4s
   [+] Building 4.8s (13/15)
   ...
   microservice-rust-mysql-db-1      | 2022-10-19 19:54:45 0 [Note] mariadbd: ready for connections.
   microservice-rust-mysql-db-1      | Version: '10.9.3-MariaDB-1:10.9.3+maria~ubu2204'  socket: '/run/mysqld/mysqld.sock'  port: 3306  mariadb.org binary distribution
   

   如果你从另一个终端窗口运行docker image ls，你可以在你的镜像存储中看到Wasm镜像。

   $ docker image ls
   REPOSITORY   TAG       IMAGE ID       CREATED         SIZE
   server       latest    2c798ddecfa1   2 minutes ago   3MB
   

   检查图像显示图像具有wasi/wasm平台，这是操作系统和架构的组合：

   $ docker image inspect server | grep -A 3 "Architecture"
           "Architecture": "wasm",
           "Os": "wasi",
           "Size": 3001146,
           "VirtualSize": 3001146,
   

3. 在浏览器中打开URL http://localhost:8090 并创建一些示例订单。所有这些操作都在与Wasm服务器进行交互。

4. 当你全部完成后，通过在启动应用程序的终端中按下Ctrl+C来拆除所有内容。

构建并推送一个Wasm模块

1. 创建一个Dockerfile来构建你的Wasm应用程序。

   具体如何执行此操作取决于您使用的编程语言。

2. 在您的Dockerfile的一个单独阶段中，提取模块并将其设置为ENTRYPOINT。

   # syntax=docker/dockerfile:1
   FROM scratch
   COPY --from=build /build/hello_world.wasm /hello_world.wasm
   ENTRYPOINT [ "/hello_world.wasm" ]

3. 构建并推送指定wasi/wasm架构的镜像。Buildx使得在单个命令中轻松完成此操作。

   $ docker buildx build --platform wasi/wasm -t username/hello-world .
   ...
   => exporting to image                                                                             0.0s
   => => exporting layers                                                                            0.0s
   => => exporting manifest sha256:2ca02b5be86607511da8dc688234a5a00ab4d58294ab9f6beaba48ab3ba8de56  0.0s
   => => exporting config sha256:a45b465c3b6760a1a9fd2eda9112bc7e3169c9722bf9e77cf8c20b37295f954b    0.0s
   => => naming to docker.io/username/hello-world:latest                                            0.0s
   => => unpacking to docker.io/username/hello-world:latest                                         0.0s
   $ docker push username/hello-world
   

故障排除

本节包含如何解决常见问题的说明。

未知运行时指定

如果您尝试在没有containerd 镜像存储的情况下运行 Wasm 容器，将会显示类似于以下的错误：

docker: Error response from daemon: Unknown runtime specified io.containerd.wasmedge.v1.

启用 containerd 功能 在 Docker Desktop 设置中，然后重试。

无法启动shim：无法解析运行时路径

如果您使用的是不支持运行Wasm工作负载的旧版本Docker Desktop，您将看到类似于以下的错误信息：

docker: Error response from daemon: failed to start shim: failed to resolve runtime path: runtime "io.containerd.wasmedge.v1" binary not installed "containerd-shim-wasmedge-v1": file does not exist: unknown.

更新您的Docker Desktop到最新版本并重试。

已知问题

• Docker Compose 在被中断时可能无法干净地退出
  • 解决方法：通过发送 SIGKILL 信号清理 docker-compose 进程 (killall -9 docker-compose)。
• 推送到Hub时可能会出现错误提示 server message: insufficient_scope: authorization failed，即使在使用Docker Desktop登录后
  • 解决方法：在CLI中运行 docker login

反馈

感谢您尝试使用Docker的Wasm工作负载。请通过公共路线图项目上的问题跟踪器提供反馈或报告您可能发现的任何错误。