← Cloudflare Workflows / workflows / build

Локальная разработка

Workflows поддерживают локальную разработку с использованием Wrangler, интерфейс командной строки для Workers. Wrangler запускает эмулированную версию Workflows, отличающуюся от той, что Cloudflare использует в глобальной сети.

Для локальной разработки с Workflows вам потребуется:

• Wrangler v3.89.0 ↗ или более поздней версии.

• Node.js-версия 18.0.0 или более поздней версии. Рассмотрите возможность использования менеджера версий Node, например Volta ↗ или nvm ↗ , чтобы избежать проблем с правами доступа и переключаться между версиями Node.

• Если вы только начинаете работать с Workflows и/или Cloudflare Workers, обратитесь к Руководство по Workflows чтобы установить wrangler и развернуть свои первые Workflows.

Откройте терминал и выполните следующие команды, чтобы запустить локальную сессию разработки:

# Confirm we are using wrangler v3.89.0+
npx wrangler --version

⛅️ wrangler 3.89.0

Запуск локальной сессии разработки

# Start a local dev session:
npx wrangler dev

------------------
Your worker has access to the following bindings:
- Workflows:
  - MY_WORKFLOW: MyWorkflow
⎔ Starting local server...
[wrangler:inf] Ready on http://127.0.0.1:8787/

Сеансы локальной разработки создают автономное окружение, доступное только локально и повторяющее продакшен-среду, в которой выполняется Workflows, чтобы вы могли тестировать свои Workflows до вы развернёте в продакшене.

См. wrangler dev документация чтобы узнать больше о настройке локальной сессии разработки.

Пока wrangler dev сессия запущена, можно использовать все wrangler workflows команды на --local флаг для взаимодействия с локальными инстансами Workflow.

Например, чтобы вывести список локальных Workflows:

npx wrangler workflows list --local

Чтобы запустить Workflow локально:

npx wrangler workflows trigger my-workflow --local

Чтобы просмотреть конкретный экземпляр:

npx wrangler workflows instances describe my-workflow <INSTANCE_ID> --local

Все команды принимают --port для обращения к конкретному wrangler dev сессия (по умолчанию 8787).

Local Explorer это браузерный интерфейс для просмотра и управления локальными инстансами Workflow во время разработки. Вместо выполнения команд CLI вы можете открыть Local Explorer в браузере и напрямую взаимодействовать со своими Workflows.

Пока wrangler dev сессия запущена, нажмите e в терминале, чтобы открыть Local Explorer, либо перейдите на http://localhost:8787/cdn-cgi/explorer в вашем браузере.

С Local Explorer вы можете:

• Просмотр всех Workflows, определённых в вашем проекте, и их экземпляров.
• Просмотр истории шагов и текущего статуса каждого экземпляра.
• Создавайте новые запуски Workflow и отправляйте события работающим экземплярам.
• Приостановка, возобновление, завершение и перезапуск экземпляров.
• Удаляйте отдельные экземпляры или очищайте их все сразу.

Для Local Explorer требуется Wrangler версии 4.82.1 или более поздней версии, или Cloudflare Vite plugin версия 1.32.0 или более поздней версии.

Workflows не поддерживаются в качестве удаленные привязки или при использовании npx wrangler dev --remote.