CRI-O

快速开始

GitHub repo 包含 CRI-O 相关示例的脚本和 Github Actions，以下是相关链接。

在接下来的部分中，我们会展示如何使用这些脚本。

安装 CRI-O

使用以下命令在你的系统上安装 CRI-O。

1. export OS="xUbuntu_20.04"
2. export VERSION="1.21"
3. apt update
4. apt install -y libseccomp2 || sudo apt update -y libseccomp2
5. echo "deb https://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable/$OS/ /" > /etc/apt/sources.list.d/devel:kubic:libcontainers:stable.list
6. echo "deb https://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable:/cri-o:/$VERSION/$OS/ /" > /etc/apt/sources.list.d/devel:kubic:libcontainers:stable:cri-o:$VERSION.list

8. curl -L https://download.opensuse.org/repositories/devel:kubic:libcontainers:stable:cri-o:$VERSION/$OS/Release.key | apt-key add -
9. curl -L https://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable/$OS/Release.key | apt-key add -

11. apt-get update
12. apt-get install criu libyajl2
13. apt-get install cri-o cri-o-runc cri-tools containernetworking-plugins
14. systemctl start crio

配置 CRI-O 以使用 crun

CRI-O 默认使用 runc 运行时，我们需要修改配置以使用 crun 代替。 这需要添加到两个配置文件来完成。

在运行下一步之前，请确保你已经构建并安装好了支持 WasmEdge 的 crun 二进制文件。

首先，创建一个 /etc/crio/crio.conf 文件并添加以下内容，它会使 CRI-O 默认使用 crun 作为运行时。

1. [crio.runtime]
2. default_runtime = "crun"

crun 运行时在 /etc/crio/crio.conf.d/01-crio-runc.conf 文件中定义，按下面的内容修改此文件。

1. [crio.runtime.runtimes.runc]
2. runtime_path = "/usr/lib/cri-o-runc/sbin/runc"
3. runtime_type = "oci"
4. runtime_root = "/run/runc"
5. # The above is the original content

7. # Add our crunw runtime here
8. [crio.runtime.runtimes.crun]
9. runtime_path = "/usr/bin/crun"
10. runtime_type = "oci"
11. runtime_root = "/run/crun"

接下来，重新启动 CRI-O 以应用配置更改。

1. systemctl restart crio

运行简单 WebAssembly 应用

现在，我们可以使用 CRI-O 运行一个简单的 WebAssembly 程序。 另一篇文章 解释了如何编译、打包和将 WebAssembly 程序作为容器镜像发布至 Docker hub。 在本节中，我们需要先使用 CRI-O 工具将这个基于 WebAssembly 的容器镜像从 Docker hub 中拉取下来。

1. sudo crictl pull docker.io/hydai/wasm-wasi-example:with-wasm-annotation

接下来，我们需要创建两个简单的配置文件，指定 CRI-O 应该如何在 sandbox 中运行这个 WebAssembly 镜像。 我们已经有 container_wasi.json 和 sandbox_config.json 这两个文件。你可以使用下面的命令将它们下载到本地目录。

1. wget https://raw.githubusercontent.com/second-state/wasmedge-containers-examples/main/crio/sandbox_config.json
2. wget https://raw.githubusercontent.com/second-state/wasmedge-containers-examples/main/crio/container_wasi.json

现在你可以用 CRI-O 创建 pod 和容器。只需用本文的配置选项即可。

1. # 创建 POD。输出会与示例不同。
2. $ sudo crictl runp sandbox_config.json
3. 7992e75df00cc1cf4bff8bff660718139e3ad973c7180baceb9c84d074b516a4
4. # 设置一个辅助变量供之后使用。
5. $ POD_ID=7992e75df00cc1cf4bff8bff660718139e3ad973c7180baceb9c84d074b516a4

7. # 创建容器实例。输出会与示例不同。
8. $ sudo crictl create $POD_ID container_wasi.json sandbox_config.json
9. # 设置一个辅助变量供之后使用。
10. CONTAINER_ID=1d056e4a8a168f0c76af122d42c98510670255b16242e81f8e8bce8bd3a4476f

启动容器会执行 WebAssembly 程序， 你可以在控制台中看到输出。

1. # 列出容器，容器状态应为 `Created`。
2. $ sudo crictl ps -a
3. CONTAINER           IMAGE                                          CREATED              STATE               NAME                     ATTEMPT             POD ID
4. 1d056e4a8a168       hydai/wasm-wasi-example:with-wasm-annotation   About a minute ago   Created             podsandbox1-wasm-wasi   0                   7992e75df00cc

6. # 启动容器。
7. $ sudo crictl start $CONTAINER_ID

9. # 再次检查容器状态。
10. # 如果容器没有结束作业，你会看到它处于 Running 状态。
11. # 因为这个示例很小。此时你可能会看到已退出。
12. $ sudo crictl ps -a
13. CONTAINER           IMAGE                                          CREATED              STATE               NAME                     ATTEMPT             POD ID
14. 1d056e4a8a168       hydai/wasm-wasi-example:with-wasm-annotation   About a minute ago   Running             podsandbox1-wasm-wasi   0                   7992e75df00cc

16. # 当容器完成作业时，你可以看到他的状态变为已退出。
17. $ sudo crictl ps -a
18. CONTAINER           IMAGE                                          CREATED              STATE               NAME                     ATTEMPT             POD ID
19. 1d056e4a8a168       hydai/wasm-wasi-example:with-wasm-annotation   About a minute ago   Exited              podsandbox1-wasm-wasi   0                   7992e75df00cc

21. # 检查容器的日志，它应该显示 WebAssembly 程序的输出。
22. $ sudo crictl logs $CONTAINER_ID

24. Test 1: Print Random Number
25. Random number: 960251471

27. Test 2: Print Random Bytes
28. Random bytes: [50, 222, 62, 128, 120, 26, 64, 42, 210, 137, 176, 90, 60, 24, 183, 56, 150, 35, 209, 211, 141, 146, 2, 61, 215, 167, 194, 1, 15, 44, 156, 27, 179, 23, 241, 138, 71, 32, 173, 159, 180, 21, 198, 197, 247, 80, 35, 75, 245, 31, 6, 246, 23, 54, 9, 192, 3, 103, 72, 186, 39, 182, 248, 80, 146, 70, 244, 28, 166, 197, 17, 42, 109, 245, 83, 35, 106, 130, 233, 143, 90, 78, 155, 29, 230, 34, 58, 49, 234, 230, 145, 119, 83, 44, 111, 57, 164, 82, 120, 183, 194, 201, 133, 106, 3, 73, 164, 155, 224, 218, 73, 31, 54, 28, 124, 2, 38, 253, 114, 222, 217, 202, 59, 138, 155, 71, 178, 113]

30. Test 3: Call an echo function
31. Printed from wasi: This is from a main function
32. This is from a main function

34. Test 4: Print Environment Variables
35. The env vars are as follows.
36. PATH: /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
37. TERM: xterm
38. HOSTNAME: crictl_host
39. PATH: /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
40. The args are as follows.
41. /var/lib/containers/storage/overlay/006e7cf16e82dc7052994232c436991f429109edea14a8437e74f601b5ee1e83/merged/wasi_example_main.wasm
42. 50000000

44. Test 5: Create a file `/tmp.txt` with content `This is in a file`

46. Test 6: Read the content from the previous file
47. File content is This is in a file

49. Test 7: Delete the previous file

接下来，你可尝试在 Kubernetes 中运行这个应用!

运行 HTTP 服务端应用

最后，我们可以在 CRI-O 中运行一个简单的基于 WebAssembly 的 HTTP 微服务。 另一篇文章 解释了如何编译、打包和将 WebAssembly 程序作为容器镜像发布至 Docker hub 。 在本节中，我们需要先使用 CRI-O 工具将这个基于 WebAssembly 的容器镜像从 Docker hub 中拉取下来。

1. sudo crictl pull docker.io/avengermojo/http_server:with-wasm-annotation

接下来，我们需要创建两个简单的配置文件，指定 CRI-O 应该如何在 sandbox 中运行这个 WebAssembly 镜像。 我们已经有 container_http_server.json 和 sandbox_config.json 这两个文件。你可以使用下面的命令将它们下载到本地目录。

HTTP 服务端示例和 WASI 简单示例使用的 sandbox_config.json 文件是相同的。 但另一个 container_*.json 文件是特定的，因为它包含应用程序的 Docker Hub 链接。

1. wget https://raw.githubusercontent.com/second-state/wasmedge-containers-examples/main/crio/sandbox_config.json
2. wget https://raw.githubusercontent.com/second-state/wasmedge-containers-examples/main/crio/http_server/container_http_server.json

现在你可以用 CRI-O 创建 pod 和容器。只需用本文的配置选项即可。

1. # 创建 POD。输出会与示例不同。
2. $ sudo crictl runp sandbox_config.json
3. 7992e75df00cc1cf4bff8bff660718139e3ad973c7180baceb9c84d074b516a4
4. # 设置一个辅助变量供之后使用。
5. $ POD_ID=7992e75df00cc1cf4bff8bff660718139e3ad973c7180baceb9c84d074b516a4

7. # 创建容器实例。输出会与示例不同。
8. $ sudo crictl create $POD_ID container_wasi.json sandbox_config.json
9. # 设置一个辅助变量供之后使用。
10. CONTAINER_ID=1d056e4a8a168f0c76af122d42c98510670255b16242e81f8e8bce8bd3a4476f

启动容器会执行 WebAssembly 程序， 你可以在控制台中看到输出。

1. # 启动容器
2. $ sudo crictl start $CONTAINER_ID

4. # 检查容器状态。它应该正在运行。
5. # 如果没有，请等待几秒钟，然后再次检查。
6. $ sudo crictl ps -a
7. CONTAINER           IMAGE                                          CREATED                  STATE               NAME                ATTEMPT             POD ID
8. 4eeddf8613691       avengermojo/http_server:with-wasm-annotation   Less than a second ago   Running             http_server         0                   1d84f30e7012e

10. # 检查容器的日志以查看 HTTP 服务器正在监听端口为 1234 。
11. $ sudo crictl logs $CONTAINER_ID
12. new connection at 1234

14. # 获取分配给容器的 IP 地址。
15. $ sudo crictl inspect $CONTAINER_ID | grep IP.0 | cut -d: -f 2 | cut -d'"' -f 2
16. 10.85.0.2

18. # 在该 IP 地址测试 HTTP 服务状态。
19. $ curl -d "name=WasmEdge" -X POST http://10.85.0.2:1234
20. echo: name=WasmEdge

接下来，你可尝试在 Kubernetes 中运行这个应用!