mcpField
V
viceroy

viceroy

github.com/fastly開発3683 回インストール1 週間前に更新
リポジトリ

viceroy について

viceroyは、Fastly Computeアプリを開発・テストするためのローカル環境です。Fastly Computeをエミュレートし、fastly.tomlでローカルバックエンドやストアを設定してWASMサービスを実行できます。

主な機能

  1. 01Fastly Computeプラットフォームのエミュレート
  2. 02WASMサービスの実行とテスト
  3. 03ローカルバックエンドとストアの設定

活用シーン

  1. 01Computeアプリのローカル開発
  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 は、Compute アプリケーション向けの Fastly 公式ローカルテスト環境です。Fastly Compute プラットフォームをエミュレートするため、WASM サービスをローカルで開発、テストできます。

Viceroy のドキュメント: https://github.com/fastly/Viceroy

よくある注意点

  • Dictionaries と ConfigStores はどちらもサポートされていますが、fastly.toml での設定方法は異なります。Dictionaries はインラインのキーと値のマップまたは JSON ファイルとして [local_server.dictionaries] の下に設定します。ConfigStores は [local_server.config_stores] の下に設定します。
  • fastly.toml には [local_server] セクションが必要です。 このセクションがないと、Viceroy はバックエンド、ストア、その他のローカルオーバーライドを認識できません。アプリが呼び出すすべてのバックエンドを [local_server.backends] の下に記載する必要があります。
  • デフォルトのポートは 7676 で、Fastlike のデフォルトである 5000 ではありません。アプリには 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

参考資料

トピックファイル使用する場面
Servefastly-compute-serve.mdローカル開発サーバーの起動、プロファイリング、高度なサーバーオプション
Configfastly-compute-config.mdfastly.toml のバックエンド、ストア、ジオロケーション、デバイス検出、ACL の設定
Testfastly-compute-test.mdcargo-nextest での Rust ユニットテストの実行、Compute サービスのテスト作成
Adaptfastly-compute-adapt.mdコア WASM モジュールの Component Model への変換、カスタムビルドパイプライン

コメント

Markdown 対応