Subscribe to receive notifications of new posts:

在 Cloudflare Workers 上使用 WASI 运行 Zig

08/01/2022

5 min read
Running Zig with WASI on Cloudflare Workers

在阅读最近关于 Workers 中的 WASI 支持的公告之后,我决定探索一下,怎样才能让 Zig 中编写的代码作为 Worker 运行,结果发现毫不费力就能做到。本文记录了我作为 Zig 的新用户所采用的过程。我惊奇地发现,Cloudflare Workers 是一个多语言平台,可以采用自己喜欢的语言或者正在学习的语言来编写程序!

你好,世界!

我绝非 Zig 专家,实不相瞒,我刚刚开始学习这门语言,但我们总归要迈出第一步。所以,如果我的 Zig 代码有疏漏之处,请多包涵。我的目标是使用 Zig 构建一个真实的小程序,并将其部署到 Cloudflare Workers 上。然后看看我从一片空白开始,到写出富有成效的代码,需要多长时间。

我的目标谈不上宏伟,就只是从 stdin 读取一些文本,然后打印到 stdout 并加上行号,就像运行 cat -n 那样。但这确实表明 Workers 范式非常简单。这个 Zig 程序在笔记本电脑的命令行上以及作为部署到 Cloudflare Workers 上的 HTTP API 时采用完全相同的方式运行。

我编写的代码如下。它从 stdin 读取一行,将其原封不动地输出,只是加上了行号前缀。没有更多输入时,程序终止。

const std = @import("std");

pub fn main() anyerror!void {
	// setup allocator
	var gpa = std.heap.GeneralPurposeAllocator(.{}){};
	defer std.debug.assert(!gpa.deinit());
	const allocator = gpa.allocator();

	// setup streams
	const stdout = std.io.getStdOut().writer();
	const in = std.io.getStdIn();
	var reader = std.io.bufferedReader(in.reader()).reader();

	var counter: u32 = 1;

	// read input line by line
	while (try reader.readUntilDelimiterOrEofAlloc(allocator, '\n', std.math.maxInt(usize))) |line| {
    	    defer allocator.free(line);
    	    try stdout.print("{d}\t{s}\n", .{counter, line});
    	    counter = counter + 1;
	}
}

要构建 Zig 代码,就需要创建一个 build.zig 文件来定义如何构建项目。就这个小案例而言,我选择从源文件构建可执行文件

const std = @import("std");

pub fn build(b: *std.build.Builder) void {
	const target = b.standardTargetOptions(.{});
	const mode = b.standardReleaseOptions();

	const exe = b.addExecutable("print-with-line-numbers", "src/main.zig");
	exe.setTarget(target);
	exe.setBuildMode(mode);
	exe.install();
}

通过运行 zig build,编译器将运行并在 zig-out/bin 下输出二进制文件

$ zig build

$ ls zig-out/bin
print-with-line-numbers

$ echo "Hello\nWorld" | ./zig-out/bin/print-with-line-numbers
1    Hello
2    World

WASI

下一步就是在 Workers 上运行此程序,但首先我需要将其编译到具有 WASI 支持的 WASM 中。

幸好,在最新版本的 Zig 中,这个功能开箱即用,所以可以直接让编译器使用 wasm32-wasi 目标构建可执行文件,这样生成的文件可以在任何兼容 WASI 的 WebAssembly 运行时上运行,例如 wasmtime

这同一个 .wasm 文件可在 wasmtime 中运行并直接部署到 Cloudflare Workers。这样一来,就可以无缝地编译、测试和部署。

$ zig build -Dtarget=wasm32-wasi

$ ls zig-out/bin
print-with-line-numbers.wasm

$ echo "Hello\nWorld" | wasmtime ./zig-out/bin/print-with-line-numbers.wasm
1    Hello
2    World

Workers 上的 Zig

二进制文件准备好之后,最后需要使用 Wrangler2 在 Cloudflare Workers 上运行它。这很简单,只需在 workers.dev 上发布 .wasm 文件即可。如果没有 workers.dev 帐户,可以按照我们入门指南上的教程,几分钟就能完成从编写代码到部署的全过程!

事实上,我注册帐户之后,只需完成前两步,即安装 Wrangler 和登录。

$ npx wrangler@wasm login
Attempting to login via OAuth...
Opening a link in your default browser: https://dash.cloudflare.com/oauth2/auth
Successfully logged in.

然后,我运行了以下命令来发布我的 Worker:

$ npx wrangler@wasm publish --name print-with-line-numbers --compatibility-date=2022-07-07 zig-out/bin/print-with-line-numbers.wasm
Uploaded print-with-line-numbers (3.04 sec)
Published print-with-line-numbers (6.28 sec)
  print-with-line-numbers.workers.dev

完成这一步之后,Worker 即可开始运行,并可通过调用上面输出中打印的 URL 来调用 Worker。

echo "Hello\nWorld" | curl https://print-with-line-numbers.workers.dev -X POST --data-binary @-
1    Hello
2    World

调用成功!

总结

整个过程十分简单,这让我惊叹不已。

首先,我为笔记本电脑的架构编译了二进制文件,然后向编译器传递一个标志来将代码编译到 WebAssembly 中,最后,不用改动任何代码,就可以让程序在 Workers 上运行。

诚然,这个程序并不怎么复杂,能够做的事情无非是从 STDIN 读取内容并写入 STDOUT,但这让我对其潜力充满信心,尤其随着 WASI 这样的技术趋于成熟,相信它能打造无限可能。

We protect entire corporate networks, help customers build Internet-scale applications efficiently, accelerate any website or Internet application, ward off DDoS attacks, keep hackers at bay, and can help you on your journey to Zero Trust.

Visit 1.1.1.1 from any device to get started with our free app that makes your Internet faster and safer.

To learn more about our mission to help build a better Internet, start here. If you're looking for a new career direction, check out our open positions.
Cloudflare Workers (CN)WebAssembly (CN)WASM (CN)简体中文

Follow on X

Cloudflare|@cloudflare

Related posts

April 05, 2024 1:01 PM

Browser Rendering API GA,推出 Cloudflare Snippets 、SWR,并向所有用户提供 Workers for Platforms

Browser Rendering API 现已向所有付费 Workers 客户提供,并改进了会话管理功能...

April 04, 2024 1:05 PM

生产安全新工具——渐进式部署、源码映射、速率限制和全新 SDK

我们今天发布了五项更新,旨在为您提供更 多功能——渐进式部署、Tail Workers 中的源映射堆栈跟踪、全新的速率限制 API、全新的 API SDK,以及对 Durable Objects 的更新——每项更新都旨在满足重要的生产服务需求...

April 02, 2024 1:01 PM

升级版 Workers AI:现已正式发布且具备更多新增功能

今天,我们欣然发布包括 Workers AI、Cloudflare 的推理平台进入 GA 阶段以及支持使用 LoRA 对模型进行微调,并支持从 HuggingFace 进行一键部署等一系列消息。 Cloudflare Workers 现已支持 Python 编程语言及更多功能...