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

2. Aktualizujte na Wrangler v2

Tento dokument popisuje kroky migrace projektu z Wrangler v1 na Wrangler v2. Před aktualizací verze Wrangler si projděte a dokončete Migrace projektů s webpackem z Wrangleru verze 1 pokud se to týká vašeho projektu.

Wrangler v2 přináší nové funkce a vylepšení, která si mohou vyžádat úpravy vaší konfigurace.

Samotné CLI vás provede procesem aktualizace.

Pokud jste dříve nainstalovali Wrangler v1 globálně pomocí npm, můžete ho odinstalovat pomocí:

npm uninstall -g @cloudflare/wrangler

Pokud jste k instalaci Wrangler v1 použili Cargo, můžete ho odinstalovat pomocí:

cargo uninstall wrangler

Nyní nainstalujte nejnovější verzi Wrangleru.

npm install -g wrangler

Chcete-li zkontrolovat, že máte nainstalovanou správnou verzi Wrangler, spusťte:

npx wrangler --version

Nyní otestujete, zda Wrangler v2 dokáže sestavit váš projekt z Wrangler v1. Ve většině případů se sestavení podaří bez problémů. Pokud dojde k chybám, příkazová řádka vám přesně sdělí, co je potřeba změnit, aby sestavení proběhlo úspěšně.

Pokud si chcete přečíst více o zastaralém Konfigurační soubor Wrangler pole, kvůli kterým Wrangler v2 vrátí chybu, viz Zastaralé funkce.

Spustit wrangler dev příkaz. Zobrazí všechna varování nebo chyby, které je potřeba vyřešit. Vezměte na vědomí, že zprávy ve většině případů obsahují konkrétní pokyny, jak problém vyřešit.

npx wrangler dev

• Než Wrangler bude moci sestavit váš Worker, je nutné opravit chyby.
• Ve většině případů uvidíte pouze varování. Ta Wrangleru nebrání v sestavení Workeru, ale zvažte úpravu konfigurace, abyste je odstranili.

Následující příklad ukazuje varování a chyby:

 ⛅️ 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 "".

Viz Zastaralé funkce další podrobnosti o tom, co už není podporováno.