feat(console): add runtime management and WIT Registry
- embed wasmeld-runtime behind an Axum management API - persist service metadata, metrics, and events with Toasty and libSQL - register immutable component artifacts with platform-owned limits - publish, list, inspect, and download binary WIT package versions - verify Runtime lifecycle, persistence, Registry immutability, and transitive fetch
This commit is contained in:
@@ -0,0 +1,65 @@
|
||||
# Wasmeld Console
|
||||
|
||||
`wasmeld-console` 是 `wasmeld-runtime` 的本地 HTTP 管理适配器。它负责:
|
||||
|
||||
- 接收 `.wasmpkg`,校验并保存 `component.wasm` 与运行时 manifest
|
||||
- 发布、查询和下载不可变的二进制 WIT Package
|
||||
- 启动、停止和重启内嵌的 `wasmeld-runtime`
|
||||
- 启动、停止和重启常驻 Actor
|
||||
- 转发二进制调用
|
||||
- 暴露调用计数、状态和最近事件
|
||||
|
||||
Wasm 制品保存在本地文件系统。服务 manifest、调用计数和最近 256 条事件通过
|
||||
[Toasty](https://github.com/tokio-rs/toasty) 写入本地 libSQL 数据库,默认路径是
|
||||
`var/wasmeld/console.db`。
|
||||
|
||||
`wasmeld-console` 启动时会在同一进程内创建 `wasmeld-runtime`、加载 Wasmtime Engine,
|
||||
并重新注册已保存的 Component。Runtime 停止后 Console HTTP 和数据库仍然在线;
|
||||
再次启动 Runtime 会重新注册 Component,但 Actor 内存不做快照,服务运行状态统一
|
||||
恢复为 `stopped`。
|
||||
|
||||
## 启动
|
||||
|
||||
`wasmeld-console` 需要 Rust 1.95 或更高版本;Wasm 组件继续使用项目约定的 Rust 1.90
|
||||
工具链构建。
|
||||
|
||||
```bash
|
||||
cargo +stable run -p wasmeld-console
|
||||
```
|
||||
|
||||
默认监听 `127.0.0.1:8080`。
|
||||
|
||||
可用环境变量:
|
||||
|
||||
- `WASMELD_ADDR`
|
||||
- `WASMELD_ARTIFACT_DIR`
|
||||
- `WASMELD_DATABASE_PATH`
|
||||
- `WASMELD_WIT_REGISTRY_DIR`
|
||||
- `WASMELD_ALLOWED_ORIGINS`,多个 Origin 使用逗号分隔
|
||||
- `RUST_LOG`
|
||||
|
||||
## API
|
||||
|
||||
| 方法 | 路径 | 用途 |
|
||||
| --- | --- | --- |
|
||||
| `GET` | `/healthz` | 健康检查 |
|
||||
| `GET` | `/api/v1/runtime` | Runtime 状态 |
|
||||
| `POST` | `/api/v1/runtime/start` | 启动 Runtime 并重新注册受管 Component |
|
||||
| `POST` | `/api/v1/runtime/stop` | 停止 Runtime 并释放所有 Actor |
|
||||
| `POST` | `/api/v1/runtime/restart` | 重建 Runtime,服务恢复为停止状态 |
|
||||
| `GET` | `/api/v1/services` | 服务版本列表 |
|
||||
| `POST` | `/api/v1/services` | multipart 上传单个 `package` 字段(`.wasmpkg`) |
|
||||
| `POST` | `/api/v1/services/{id}/{revision}/start` | 启动 Actor |
|
||||
| `POST` | `/api/v1/services/{id}/{revision}/stop` | 停止 Actor |
|
||||
| `POST` | `/api/v1/services/{id}/{revision}/restart` | 重启 Actor |
|
||||
| `POST` | `/api/v1/services/{id}/{revision}/invoke` | Base64 二进制调用 |
|
||||
| `GET` | `/api/v1/events` | 最近 256 条持久化事件 |
|
||||
| `GET` | `/api/v1/wit/packages` | WIT 包版本列表 |
|
||||
| `POST` | `/api/v1/wit/packages` | multipart 发布单个二进制 WIT `package` 字段 |
|
||||
| `GET` | `/api/v1/wit/packages/{namespace}/{name}/{version}` | WIT 包元数据 |
|
||||
| `GET` | `/api/v1/wit/packages/{namespace}/{name}/{version}/content` | 下载 WIT 包 |
|
||||
|
||||
组件包的构建与格式说明见
|
||||
[`docs/design/wasmeld-component-package.md`](../../docs/design/wasmeld-component-package.md)。
|
||||
WIT 依赖、Registry 和本地 replace 说明见
|
||||
[`docs/design/wit-package-management.md`](../../docs/design/wit-package-management.md)。
|
||||
Reference in New Issue
Block a user