← Cloudflare Workers / workers / wrangler / migration / v1-to-v2

2. Обновление до Wrangler v2

В этом документе описаны шаги миграции проекта с Wrangler v1 на Wrangler v2. Перед обновлением версии Wrangler ознакомьтесь и выполните Перенос проектов на базе webpack с Wrangler версии 1 если это применимо к вашему проекту.

Wrangler v2 поставляется с новыми функциями и улучшениями, которые могут потребовать изменений в вашей конфигурации.

CLI сам проведёт вас через процесс обновления.

Если ранее вы устанавливали Wrangler v1 глобально с помощью npm, удалить его можно так:

npm uninstall -g @cloudflare/wrangler

Если вы установили Wrangler v1 через Cargo, удалить его можно с помощью:

cargo uninstall wrangler

Теперь установите последнюю версию Wrangler.

npm install -g wrangler

Чтобы убедиться, что установлена правильная версия Wrangler, выполните:

npx wrangler --version

Теперь проверьте, что Wrangler v2 может собрать ваш проект Wrangler v1. В большинстве случаев сборка пройдет без проблем. Если возникнут ошибки, командная строка подскажет, что именно нужно изменить, чтобы сборка прошла успешно.

Если вы хотите узнать больше об устаревшем конфигурационный файл Wrangler полей, которые вызывают ошибку в Wrangler v2, см. Устаревшие функции.

Выполните wrangler dev команду. Она покажет предупреждения или ошибки, которые нужно устранить. Обратите внимание, что в большинстве случаев сообщения содержат конкретные инструкции по решению проблемы.

npx wrangler dev

• Прежде чем Wrangler сможет собрать ваш Worker, необходимо исправить ошибки.
• В большинстве случаев вы увидите только предупреждения. Они не мешают Wrangler собрать Worker, но рекомендуется обновить конфигурацию, чтобы их убрать.

Ниже приведён пример предупреждений и ошибок:

 ⛅️ wrangler 2.x
-------------------------------------------------------
▲ [WARNING] Processing wrangler.toml configuration:
  - 😶 Ignored: "type":
    Most common features now work out of the box with wrangler, including modules, jsx,
  typescript, etc. If you need anything more, use a custom build.
  - Deprecation: "zone_id":
    This is unnecessary since we can deduce this from routes directly.
  - Deprecation: "build.upload.format":
    The format is inferred automatically from the code.


✘ [ERROR] Processing wrangler.toml configuration:
  - Expected "route" to be either a string, or an object with shape { pattern, zone_id | zone_name }, but got "".

См. Устаревшие функции с подробностями о том, что больше не поддерживается.