← Cloudflare Workers / workers / wrangler

Zastaralé funkce

Prohlédněte si rozdíly mezi verzemi Wrangler, zejména zastaralé funkce a nekompatibilní změny.

Použití Workers Sites je zastaralá. Místo toho doporučujeme přejít na Workers Static Assets. Podpora používání Workers Sites s Wrangler bude v některé z budoucích verzí Wrangler odstraněna.

Použití Service Environments ↗, povoleno prostřednictvím legacy_env vlastnost v konfiguraci Wrangler, je zastaralá. Místo toho doporučujeme přejít na Prostředí Wrangleru. Podpora používání Service Environments s Wrangler bude v některé z budoucích verzí Wrangler odstraněna.

Následující příkazy jsou od verze Wrangler v3 zastaralé. V budoucí verzi Wrangleru budou zcela odstraněny.

wrangler generate příkaz je zastaralý, ale ve verzi v3 stále funguje. wrangler generate bude ve verzi v4 zcela odstraněn.

Použijte npm create cloudflare@latest pro nové projekty Workers a Pages.

wrangler publish příkaz je zastaralý, ale ve verzi v3 stále funguje. wrangler publish bude ve verzi v4 zcela odstraněn.

Použijte npx wrangler deploy pro nasazení Workerů.

wrangler pages publish příkaz je zastaralý, ale ve verzi v3 stále funguje. wrangler pages publish bude ve verzi v4 zcela odstraněn.

Použijte wrangler pages deploy pro nasazení Pages.

Místo toho použijte wrangler --version pro kontrolu aktuální verze Wrangleru.

wrangler dev je ve v3 ve výchozím nastavení lokální, takže tato možnost už není potřeba.

wrangler dev je ve v3 ve výchozím nastavení lokální, takže tato možnost už není potřeba.

wrangler dev ve výchozím nastavení data automaticky ukládá, takže tato možnost už není potřeba.

Tyto možnosti brání wrangler pages dev od přesné emulace chování produkčního prostředí při obsluze statických assetů, a proto byly označeny jako zastaralé. Místo spoléhání na to, že Wrangler bude proxovat na nějaký jiný upstream dev server, můžete dosáhnout přesnějšího chování tak, že statické assety sestavíte do adresáře a nasměrujete Wrangler na tento adresář pomocí wrangler pages dev <directory>.

Doporučujeme, abyste migrace na Workers assets ↗

Místo toho použijte nodejs_compat příznak kompatibility ↗. Zahrnuje to funkcionalitu ze zastaralého node_compat polyfills a nativně implementovaná Node.js API.

Toto již nemá žádný účinek po zavádění Workers Standard Pricing ↗.

Wrangler v2 zavádí nová pole pro konfiguraci a nové funkce pro vývoj a nasazení Workeru a zároveň některá nadbytečná pole označuje za zastaralá.

• wrangler.toml již není povinné.
• dev a publish přijímat argumenty CLI.
• tail lze spustit pod libovolným názvem Workeru.
• init vytvoří základní strukturu projektu.
• Vazby JSON pro vars.
• Lokální režim pro wrangler dev.
• Systém modulů (pro Workers ve formátu modulů i service worker).
• DevTools.
• Podpora TypeScript.
• Sdílení vývojového prostředí přes internet.
• Širší kompatibilita s platformami.
• Klávesové zkratky pro vývojáře.
• Lepší validace konfigurace.

Následující video popisuje některé z hlavních změn ve Wrangleru v2 a ukazuje, jak vám může Wrangler v2 pomoci zrychlit práci.

Běžná pole, která už nejsou povinná, najdete v následujícím seznamu.

• type již není vyžadováno. Wrangler automaticky odvodí správný typ projektu.
• zone_id již není vyžadováno. Lze jej odvodit přímo z cest.
• build.upload.format se již nepoužívá. Formát se nyní automaticky odvozuje z kódu.
• build.upload.main a build.upload.dir už nejsou potřeba. Použijte klíč na nejvyšší úrovni main pole, které nyní slouží jako vstupní bod Workeru.
• site.entry-point již není vyžadováno. Vstupní bod by měl být zadán prostřednictvím main .
• webpack_config a webpack vlastnosti již nejsou podporovány. Viz Migrace projektů s webpackem z Wrangleru verze 1. Zde jsou příkazy Wrangler v1, které už nejsou podporovány:
• wrangler preview - Použijte wrangler dev příkaz, kterým worker spustíte v lokálním prostředí.
• wrangler generate - Pokud chcete použít startovací šablonu, naklonujte její repozitář GitHub a inicializujte ji ručně.
• wrangler route - Routes jsou definovány v Konfigurační soubor Wrangler.
• wrangler report - Pokud najdete chybu, nahlaste ji na Problémy s Wranglerem ↗.
• wrangler build - Pokud chcete získat přístup k výstupu z bundlování vašeho Workeru, použijte wrangler deploy --outdir=path/to/output.

Jedná se o nová pole, která lze přidat do vašeho Konfigurační soubor Wrangler.

• main: string, volitelné

  main pole se používá k určení vstupního bodu Workeru. Může být v zavedeném formátu service worker nebo v novějším, preferovaném formátu modulů. Vstupní bod je nyní vyžadován explicitně a lze ho nakonfigurovat buď pomocí main pole, nebo předat přímo na příkazovém řádku, například wrangler dev index.js. Toto pole nahrazuje zastaralé build.upload.main pole (které platilo jen pro Workery ve formátu modulů).

• rules: array, volitelné

  rules pole je pole mapování mezi typy modulů a vzory souborů. Říká Wrangleru, aby konkrétní soubory interpretoval jinak než jako JavaScript. To se hodí například pro čtení textového obsahu jako textových souborů nebo zkompilovaného WASM jako připraveného k instanciaci a spuštění. Tato pravidla lze použít jak u zavedeného formátu service worker, tak u novějšího formátu modulů. Toto pole nahrazuje starší build.upload.rules pole (které platilo jen pro Workery ve formátu modulů).

Několik konfiguračních polí, která byla dříve povinná, je nyní v určitých situacích volitelných. Mohou být buď odvozena, nebo přidána jako optimalizace. Od Wrangleru v2 už není povinné žádné pole a konfiguraci můžete přidávat postupně podle potřeby.

• name: string

  name konfigurační pole už není povinné pro wrangler dev, nebo kteroukoli z wrangler kv:* příkazy. Kromě toho jej lze předat i jako argument příkazové řádky jako --name <name>. I nadále je to vyžadováno pro wrangler deploy.

• account_id: string

  account_id pole není u žádného z příkazů povinné. Příslušné příkazy zkontrolují, zda jste přihlášeni, a pokud ne, vyzvou vás k přihlášení. Po přihlášení se použije vaše ID účtu a znovu se nezeptá, dokud nevyprší vaše přihlašovací relace. Pokud máte více ID účtů, zobrazí se vám seznam účtů, ze kterého můžete vybrat.

  Stále můžete nakonfigurovat account_id ve vašem souboru Wrangler, nebo jako proměnná prostředí CLOUDFLARE_ACCOUNT_ID. Díky tomu je spuštění rychlejší a přeskočí se výběr ze seznamu, pokud máte více ID. CLOUDFLARE_API_TOKEN proměnná prostředí je užitečná také v situacích, kdy se nelze přihlásit interaktivně. Další informace najdete na Spouštění v CI/CD.

• workers_dev boolean, výchozí: true pokud nejsou přítomny žádné routes

  workers_dev pole se používá k označení, že se má Worker publikovat do *.workers.dev subdoména. Například pro Worker s názvem my-worker a dříve nakonfigurovaný *.workers.dev subdoména username, Worker se publikuje do my-worker.username.workers.dev.com. Toto pole není povinné a jeho výchozí hodnota je true když route nebo routes nejsou nakonfigurovány. Pokud jsou trasy zadány, výchozí hodnotou je false. Pokud ho nechcete publikovat ani do *.workers.dev subdoménu ani žádné trasy, nastavte workers_dev na false. Toto se hodí, když publikujete Worker jako samostatnou službu, ke které lze přistupovat pouze z jiného Workeru pomocí (services).

Několik konfiguračních polí je zastaralých, ale jejich přítomnost zatím nepředstavuje závažnou změnu. Doporučujeme si přečíst varovné zprávy a postupovat podle pokynů pro přechod na novou konfiguraci. V budoucí verzi budou odstraněna a přestanou fungovat.

• zone_id: string, zastaralé

  zone_id pole je zastaralé a v budoucí verzi bude odstraněno. Nyní se odvozuje z route/routes, a volitelně z dev.host při použití wrangler dev. Díky tomu je také jednodušší nasadit jeden Worker na více domén.

• build.upload: object, zastaralé

  build.upload pole je zastaralé a v budoucí verzi bude odstraněno. Jeho použití vyvolá varování s návrhy, jak konfigurační soubor přepsat, aby varování zmizela.

  • build.upload.main/build.upload.dir se nahrazují main pole a platí jak pro formát service worker, tak pro formát modules u Workerů.
  • build.upload.rules je nahrazeno rules pole a platí pro Workery ve formátu service worker i ve formátu modulů.
  • build.upload.format se již nezadává a automaticky jej odvozuje wrangler.

Několik konfiguračních polí je zastaralých a už nebudou fungovat podle očekávání. Doporučujeme si přečíst chybové zprávy a postupovat podle pokynů pro přechod na novou konfiguraci.

• site.entry-point: string, zastaralé

  site.entry-point konfigurace sloužila k určení vstupního bodu pro Workery s [site] konfigurace. Ta byla nahrazena vlastností nejvyšší úrovně main .

• type: rust | javascript | webpack, zastaralé

  type konfigurace sloužila k určení typu Workeru. Od té doby se stala nadbytečnou a nyní se odvozuje z použití. Pokud jste používali type = "webpack" (a volitelný webpack_config pole), měli byste si přečíst průvodce migrací webpacku abyste upravili svůj projekt a místo toho použili vlastní sestavení.

Následující příkazy jsou od verze Wrangler v2 zastaralé.

wrangler build příkaz už není možné použít k sestavení Workeru.

Stejné funkce lze dosáhnout pomocí wrangler publish --dry-run --outdir=path/to/build.

wrangler config příkaz už není možné použít k ověření pomocí API tokenu.

Použijte wrangler login / wrangler logout ke správě OAuth autentizace, nebo poskytněte API token prostřednictvím CLOUDFLARE_API_TOKEN proměnná prostředí.

wrangler preview příkaz už není možné použít k vytvoření dočasné náhledové instance Workeru.

Zkuste použít wrangler dev k vyzkoušení workeru během vývoje.

wrangler subdomain příkaz už není možné použít k vytvoření workers.dev subdoména.

Vytvořte workers.dev subdoména v Workers & Pages > vyberte svůj Worker > Your subdomain > Změna.

wrangler route příkaz už není možné použít k nastavení trasy Workeru.

Trasy jsou zadány v Konfigurační soubor Wrangler.

• Trasy definované v dashboardu Cloudflare se nepřidají vedle tras definovaných ve Wrangler. Trasy definované ve Wrangler jsou route nebo routes klíč ve vašem wrangler.toml. Pokud jsou definovány obě možnosti, použijí se pouze trasy definované v wrangler.toml bude platné. Pokud chcete trasy spravovat pouze přes dashboard Cloudflare, odstraňte veškeré route a routes klíče z a přidejte workers_dev = false do souboru Wrangler.

• Wrangler už nebude používat index.js v adresáři, kde wrangler dev je volána jako vstupní bod Workeru. Použijte main konfigurační pole, nebo ho výslovně předejte jako argument příkazové řádky, například: wrangler dev index.js.

• Wrangler už nebude předpokládat, že holé specifikátory (bare specifiers) jsou názvy souborů, pokud nejsou zapsány jako cesta. Například ve složce podobné této:

  project
  ├── index.js
  └── some-dependency.js

  kde obsah index.js je:

  import SomeDependency from "some-dependency.js";
  
  addEventListener("fetch", (event) => {
    // ...
  });

  Wrangler v1 by přeložil import SomeDependency from "some-dependency.js"; do souboru some-dependency.js. Toto bude fungovat i ve Wrangleru v2, ale zaznamená se varování o zastarání. V budoucnu už to skončí chybou. Místo toho byste měli import přepsat tak, aby jasně určoval relativní cestu, například takto:

  - import SomeDependency from "some-dependency.js";
  + import SomeDependency from "./some-dependency.js";