跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

本地开发

最后更新 查看 MarkdownAgent 设置

Queues 支持使用 Wrangler(Workers 的命令行接口)进行本地开发工作流。Wrangler 运行与 Cloudflare 全球部署相同版本的 Queues。

前提条件

要在本地使用 Queues 进行开发,您需要:

启动本地开发会话

打开终端并运行以下命令以启动本地开发会话:

npx wrangler@latest dev
------------------
Your Worker and resources are simulated locally via Miniflare. For more information, see: https://developers.cloudflare.com/workers/testing/local-development.

Your worker has access to the following bindings:
- Queues: <QUEUE-NAME>

本地开发会话会创建独立的、仅本地的环境,镜像 Queues 在生产中运行的环境,以便在部署到生产环境之前测试 Worker。

请参阅 wrangler dev 文档 了解如何配置本地开发会话。

分离生产者与消费者 Worker

Wrangler 支持通过单条命令同时运行多个 Worker。若您的架构将生产者和消费者分为不同的 Worker,可使用此功能在本地测试完整的消息流。

例如,若项目具有以下目录结构:

producer-worker/
├── wrangler.jsonc
├── index.ts
└── consumer-worker/
    ├── wrangler.jsonc
    └── index.ts

可使用以下命令同时为两个 worker 启动开发服务器:

npx wrangler@latest dev -c wrangler.jsonc -c consumer-worker/wrangler.jsonc --persist-to .wrangler/state

当生产者 Worker 向队列发送消息时,消费者 Worker 将自动被调用来处理它们。

已知问题

  • Queues 不支持 Wrangler 远程模式(wrangler dev --remote)。

这篇文档对您有帮助吗?