fastly/lucet

Lucet 镜像说明

镜像概述

Lucet是一个原生WebAssembly（Wasm）编译器和运行时，旨在安全地在应用程序内部执行非受信的WebAssembly程序。它基于Mozilla的Cranelift代码生成器开发，并为Fastly的Terrarium平台提供支持。

核心功能

Lucet包含多个关键组件：

• lucetc: 将Wasm模块（.wasm/.wat）编译为原生代码（.o/.so文件）的工具。
• lucet-runtime: 运行时库，负责加载编译后的模块、实例化并调用导出函数，管理资源（线性内存、全局变量）和异常处理，支持Rust和C语言接口。
• lucet-wasi: 提供WebAssembly系统接口（WASI）的运行时支持，可作为库或可执行文件使用。
• lucet-wasi-sdk: 封装WASI工具链的Rust crate，用于将C程序编译为Lucet模块。
• lucet-analyze: 检查lucetc生成的共享对象内容的工具。

使用场景

1. 开发和运行基于WebAssembly的应用程序。
2. 将Wasm模块集成到现有应用中，安全执行非受信代码。
3. 测试WebAssembly程序的合规性（通过lucet-spectest）。
4. 基准测试Wasm程序的性能（通过sightglass工具）。

配置说明

Lucet的Docker开发环境设置步骤如下：

前提条件

• 已安装并运行Docker服务。
• 克隆Lucet仓库到本地。

环境初始化

在仓库根目录执行：

bash
source devenv_setenv.sh

该命令会构建Docker镜像并启动容器，自动配置Lucet工具链到环境变量。

示例：编译并运行Hello World

1. 创建工作目录：

bash
mkdir -p src/hello && cd src/hello

2. 编写C代码（hello.c）：

c
#include <stdio.h>
int main(void) { puts("Hello world"); return 0; }

3. 编译为Wasm模块：

bash
wasm32-unknown-wasi-clang -Ofast -o hello.wasm hello.c

4. 转换为原生代码：

bash
lucetc-wasi -o hello.so hello.wasm

5. 运行程序：

bash
lucet-wasi hello.so

常用Docker命令

• 重建容器镜像：./devenv_build_container.sh
• 在容器中执行命令：./devenv_run.sh [command]
• 启动/停止容器：./devenv_start.sh / ./devenv_stop.sh