mcpField
V
viceroy

viceroy

github.com/fastly开发3683 次安装1 周前更新
代码仓库

关于 viceroy

viceroy 是 Fastly Compute 应用的本地测试环境，面向开发和测试 WASM 服务的开发者。它模拟 Fastly Compute 平台，并通过 fastly.toml 配置本地后端与存储。

主要功能

  1. 01本地模拟 Fastly Compute 平台
  2. 02运行和测试 WASM 服务
  3. 03配置本地后端与存储

适用场景

  1. 01本地开发 Compute 应用
  2. 02测试调用本地后端的服务

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/fastly/fastly-agent-toolkit --skill viceroy

安装后在 Claude Code 中输入/viceroy确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
fastly-compute-adapt.md
fastly-compute-config.md
fastly-compute-serve.md
fastly-compute-test.md

详细介绍

Viceroy — Fastly Compute 本地运行时

Viceroy 是 Fastly 官方的 Compute 应用本地测试环境。它可以模拟 Fastly Compute 平台，让你在本地开发和测试 WASM 服务。

Viceroy 文档：https://github.com/fastly/Viceroy

常见注意事项

  • Dictionaries 和 ConfigStores 均受支持，但在 fastly.toml 中的配置方式不同。Dictionaries 配置在 [local_server.dictionaries] 下，可以使用内联键值映射或 JSON 文件。ConfigStores 配置在 [local_server.config_stores] 下。
  • fastly.toml 必须包含 [local_server] 部分。 如果没有此部分，Viceroy 将无法识别你的后端、存储或其他本地覆盖配置。应用调用的每个后端都必须列在 [local_server.backends] 下。
  • 默认端口是 7676，不是 5000（Fastlike 的默认端口）。请通过 http://127.0.0.1:7676 访问应用。
  • 本地开发时，后端应指向本地服务。 避免代理到远程生产源站，以防意外泄露请求数据。

快速开始

# Install Viceroy
cargo install --locked viceroy

# Build your Compute app
fastly compute build

# Start local server (default: 127.0.0.1:7676)
viceroy -C fastly.toml bin/main.wasm

# Or use the Fastly CLI wrapper
fastly compute serve

参考资料

主题文件适用场景
提供服务fastly-compute-serve.md启动本地开发服务器、性能分析、高级服务器选项
配置fastly-compute-config.md配置 fastly.toml 后端、存储、地理位置、设备检测、ACL
测试fastly-compute-test.md使用 cargo-nextest 运行 Rust 单元测试、为 Compute 服务编写测试
适配fastly-compute-adapt.md将核心 WASM 模块转换为 Component Model、自定义构建流水线

评论

支持 Markdown