このドキュメントでは、プロジェクトを Wrangler v1 から Wrangler v2 へ移行する手順を説明します。Wrangler のバージョンを更新する前に、該当する場合は Wrangler バージョン 1 の webpack プロジェクトを移行する を確認して完了してください。
Wrangler v2 には新機能と改善があり、設定の変更が必要になることがあります。
CLI がアップグレード手順を案内します。
以前 npm で Wrangler v1 をグローバルインストールしていた場合は、次でアンインストールできます。
npm uninstall -g @cloudflare/wranglerCargo で Wrangler v1 をインストールしていた場合は、次でアンインストールできます。
cargo uninstall wrangler最新バージョンの Wrangler をインストールします。
npm install -g wrangler正しい Wrangler バージョンがインストールされたかを確認するには、次を実行します。
npx wrangler --version次に、Wrangler v2 が Wrangler v1 のプロジェクトをビルドできるかを確認します。ほとんどの場合、そのままビルドできます。エラーがある場合、コマンドラインが直すべき内容を具体的に案内します。
Wrangler v2 でエラーになる、非推奨の Wrangler 設定ファイル フィールドについて詳しくは、非推奨 を参照してください。
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 "".サポートされなくなった内容の詳細は、非推奨 を参照してください。