コンテンツにスキップ

ローカル開発

Queuesは、WorkersのコマンドラインインターフェースであるWranglerを使用してローカル開発ワークフローをサポートします。Wranglerは、Cloudflareがグローバルに実行しているのと同じバージョンのQueuesを実行します。

前提条件

Queuesを使用してローカルで開発するには、以下が必要です:

  • Wrangler v3.1.0以上。

  • Node.jsのバージョンが18.0.0以上。権限の問題を避け、Nodeのバージョンを変更するために、VoltanvmのようなNodeバージョンマネージャーの使用を検討してください。

  • QueuesやCloudflare Workersが初めての場合は、Queuesチュートリアルを参照してwranglerをインストールし、最初のQueueをデプロイしてください。

ローカル開発セッションを開始する

ターミナルを開き、以下のコマンドを実行してローカル開発セッションを開始します:

Terminal window
# wrangler v3.1.0+を使用していることを確認します
wrangler --version
⛅️ wrangler 3.1.0

ローカル開発セッションを開始します

Terminal window
# ローカル開発セッションを開始します:
npx wrangler dev
------------------
wrangler devはデフォルトでローカルモードを使用し、🔥 Miniflareと👷 workerdによって動作します。
Workerのエッジプレビューセッションを実行するには、wrangler dev --remoteを使用してください。
ローカルサーバーを開始中...
[mf:inf] http://127.0.0.1:8787/で準備完了

ローカル開発セッションは、Queuesが実行される本番環境を反映したスタンドアロンのローカル専用環境を作成するため、デプロイする前にWorkersをテストできます。

ローカル開発セッションの設定方法については、wrangler devのドキュメントを参照してください。

既知の問題

Wranglerは、同じQueueにバインドされた別々のプロデューサーとコンシューマーのWorkersをローカルで実行することをまだサポートしていません。Queuesを使用してローカルで開発するには、一時的にコンシューマーのqueue()ハンドラーをプロデューサーと同じWorkerに配置し、同じWorkerがプロデューサーとコンシューマーの両方として機能するようにします。

Wranglerはまた、wrangler dev --remoteをまだサポートしていません。