Wasm 工作负载(测试版)
测试版
Wasm 功能目前处于 测试版。建议您不要在生产环境中使用此功能,因为此功能可能会在将来的版本中发生更改或被删除。
Wasm(WebAssembly 的缩写)是您今天在 Docker 中使用的 Linux 和 Windows 容器(带有一些 权衡)的快速、轻量级替代方案。
本页提供有关在 Docker 中与 Linux 容器一起运行 Wasm 应用程序的新功能的信息。
启用 Wasm 工作负载
Wasm 工作负载需要 containerd 镜像存储 功能处于启用状态。如果您尚未使用 containerd 镜像存储,则现有镜像和容器将无法访问。
- 在 Docker Desktop 中导航到“设置”。
- 在“常规”选项卡中,选中“使用 containerd 拉取和存储镜像”。
- 转到“开发中的功能”并选中“启用 Wasm”选项。
- 选择“应用并重启”以保存设置。
- 在确认对话框中,选择“安装”以安装 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
运行此命令后,您可以访问 https://127.0.0.1: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 数据库。
克隆存储库。
$ 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.
导航到克隆的项目中,并使用 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,
在浏览器中打开 URL
https://127.0.0.1:8090
,并创建一些示例订单。所有这些都与 Wasm 服务器交互。完成后,在启动应用程序的终端中按
Ctrl+C
,将所有内容都拆卸。
构建和推送 Wasm 模块
创建一个 Dockerfile 来构建您的 Wasm 应用程序。
具体操作方法取决于您使用的编程语言。
在
Dockerfile
中的另一个阶段,提取模块并将其设置为ENTRYPOINT
。# syntax=docker/dockerfile:1 FROM scratch COPY --from=build /build/hello_world.wasm /hello_world.wasm ENTRYPOINT [ "/hello_world.wasm" ]
构建并推送镜像,并指定
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.
在 Docker Desktop 设置中启用 containerd 功能,然后重试。
无法启动 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(
killall -9 docker-compose
)清理docker-compose
进程。
- 解决方法:通过向它们发送 SIGKILL(
- 推送至 Hub 可能会显示错误
server message: insufficient_scope: authorization failed
,即使在使用 Docker Desktop 登录后也是如此- 解决方法:在 CLI 中运行
docker login
- 解决方法:在 CLI 中运行
反馈
感谢您尝试使用 Docker 运行 Wasm 工作负载。通过 公共路线图项目 上的 issue 跟踪器提供反馈或报告您可能遇到的任何错误。