wrangler

Wrangler CLI — навык Cloudflare для разработки, проверки и публикации Workers и связанных сервисов платформы. В исходном SKILL.md перечислены Workers, KV, R2, D1, Vectorize, Hyperdrive, Workers AI, Containers, Queues, Workflows, Pipelines и Secrets Store. Главный принцип навыка — перед написанием команды или конфигурации сначала получить актуальные сведения из документации, потому что флаги Wrangler, поля конфигурации и формы bindings меняются. В качестве источников указаны документация Wrangler, config-schema.json из установленного пакета и общая документация Cloudflare Workers. Перед работой рекомендуется проверить установленную версию командой wrangler --version; навык ожидает ветку v4.x или новее. Если CLI отсутствует, исходная инструкция предлагает установить wrangler как dev-зависимость через npm install -D wrangler@latest. Для нового проекта доступны npx wrangler init и create-cloudflare@latest. Для конфигурации предпочтителен wrangler.jsonc, а не TOML. В минимальном примере задаются имя Worker, точка входа и compatibility_date; дополнительно можно указать compatibility_flags, переменные окружения и bindings. Навык описывает базовые команды wrangler dev, wrangler deploy, wrangler deploy --dry-run, wrangler types, wrangler check startup, wrangler tail и wrangler whoami. Команда wrangler types генерирует TypeScript-типы, а вариант wrangler types --check помогает проверить актуальность файла. wrangler check startup предназначен для оценки времени старта и поиска Worker, который превышает лимит запуска. Для staging и production предлагаются отдельные env-блоки с собственными именами и переменными. Для публикации можно выбрать окружение, сохранить dashboard-переменные через --keep-vars и включить minify. Локальная разработка по умолчанию использует локальную симуляцию storage для bindings. Режим --local явно оставляет работу локальной, --remote подключает удалённые ресурсы, а remote: true можно задать для отдельных bindings, например R2, Workers AI или Vectorize. В примере Workers AI помечен как always remote. Для браузерного или другого удалённого ресурса это существенная граница между локальной проверкой и обращением к настоящей инфраструктуре. Секреты для локальной разработки предлагается хранить в .dev.vars; пример содержит API_KEY и DATABASE_URL, но реальные значения должны задаваться оператором. Ограничение навыка — он не заменяет актуальную документацию: перед использованием нового флага, поля или binding нужно снова обратиться к указанным источникам. Compatibility date следует выбирать свежую, в пределах 30 дней, а после изменения конфигурации нужно обновлять типы. Команды deploy и delete изменяют удалённое состояние, поэтому их следует запускать только после проверки окружения и явного решения о публикации или удалении Worker.