2. Wrangler v2へのアップデート
この文書では、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.tomlフィールドについてもっと知りたい場合は、非推奨を参照してください。
wrangler devコマンドを実行します。これにより、対処すべき警告やエラーが表示されます。
ほとんどの場合、メッセージには問題を解決するための具体的な指示が含まれています。
npx wrangler dev- エラーは、WranglerがWorkerをビルドする前に修正する必要があります。
- ほとんどの場合、警告のみが表示されます。 これらはWranglerがWorkerをビルドするのを妨げるものではありませんが、これらを解消するために設定を更新することを検討してください。
以下は、いくつかの警告とエラーの例です。
⛅️ wrangler 2.x-------------------------------------------------------▲ [WARNING] wrangler.toml設定の処理: - 😶 無視されました: "type": 最も一般的な機能は、モジュール、jsx、typescriptなどを含め、wranglerで即座に動作します。さらに必要な場合は、カスタムビルドを使用してください。 - 非推奨: "zone_id": これは不要です。ルートから直接推測できます。 - 非推奨: "build.upload.format": フォーマットはコードから自動的に推測されます。
✘ [ERROR] wrangler.toml設定の処理: - "route"は文字列または{ pattern, zone_id | zone_name }の形状を持つオブジェクトである必要がありますが、""が得られました。サポートされなくなった内容の詳細については、非推奨を参照してください。