INTEGRITY Dokumentace

← Cloudflare Workers / workers / get-started

CLI

Nastavte a nasaďte svého prvního Workera pomocí Wrangleru, CLI nástroje Cloudflare Developer Platform.

Tento průvodce vás provede nastavením a nasazením vašeho prvního Workeru.

Předpoklady

  1. Zaregistrujte si účet Cloudflare ↗.
  2. Nainstalujte Node.js ↗.

Správce verzí Node.js

Použijte správce verzí Node, jako je Volta ↗ nebo nvm ↗ abyste se vyhnuli problémům s oprávněními a mohli měnit verze Node.js. Wrangler, o kterém se dozvíte dále v této příručce, vyžaduje verzi Node 16.17.0 nebo novější.

1. Vytvořte nový projekt Worker

Otevřete okno terminálu a spusťte C3 pro vytvoření projektu Workeru. C3 (create-cloudflare-cli) ↗ je nástroj příkazové řádky, který vám pomůže nastavit a nasadit nové aplikace na Cloudflare.

npm create cloudflare@latest -- my-first-worker

Při nastavení vyberte následující možnosti:

Nyní máte nastavený nový projekt. Přejděte do jeho složky.

cd my-first-worker

Jaké soubory C3 vytvořil?

Ve složce projektu C3 vygeneruje následující:

Co když už mám projekt v git repozitáři?

Kromě vytváření nových projektů ze šablon C3 podporuje C3 také vytváření nových projektů z existujících repozitářů Git. Nový projekt z existujícího repozitáře Git vytvoříte tak, že otevřete terminál a spustíte:

npm create cloudflare@latest -- --template <SOURCE>

<SOURCE> může být kterýkoli z následujících:

Vaše stávající šablonová složka musí, aby splňovala požadavky Cloudflare Workers, obsahovat minimálně tyto soubory:

2. Vyvíjejte pomocí Wrangler CLI

C3 nainstaluje Wrangler, rozhraní příkazové řádky Workers, ve výchozím nastavení v projektech Workers. Wrangler vám umožňuje vytvořit, test, a deploy vaše projekty Workers.

Jakmile vytvoříte svůj první Worker, spusťte wrangler dev příkaz ve složce projektu, kterým spustíte lokální server pro vývoj Workeru. Worker si tak budete moci prohlížet lokálně už během vývoje.

npx wrangler dev

Pokud jste Wrangler ještě nikdy nepoužili, otevře webový prohlížeč, abyste se mohli přihlásit ke svému účtu Cloudflare.

Přejděte na http://localhost:8787 ↗ pro zobrazení vašeho Workeru.

Problémy s prohlížečem?

Pokud máte s tímto krokem potíže nebo nemáte přístup k rozhraní prohlížeče, přečtěte si wrangler login dokumentace.

3. Napište kód

Jakmile máte nový projekt vygenerovaný a spuštěný, můžete začít psát a upravovat svůj kód.

Najděte src/index.js soubor. index.js bude naplněn níže uvedeným kódem:

Původní index.js
export default {
	async fetch(request, env, ctx) {
		return new Response("Hello World!");
	},
};

Vysvětlení kódu

Tento blok kódu se skládá z několika různých částí.

Aktualizovaný index.js
export default {
	async fetch(request, env, ctx) {
		return new Response("Hello World!");
	},
};

export default je syntaxe JavaScriptu vyžadovaná pro definici Moduly JavaScriptu ↗. Váš Worker musí mít výchozí export objektu, jehož vlastnosti odpovídají událostem, které má Worker zpracovávat.

index.js
export default {
	async fetch(request, env, ctx) {
		return new Response("Hello World!");
	},
};

Tento fetch() handler se zavolá, když váš Worker přijme HTTP požadavek. Do exportovaného objektu můžete definovat další obslužné rutiny událostí, které reagují na různé typy událostí. Můžete například přidat scheduled() handler pro reakci na vyvolání Workeru prostřednictvím Cron Trigger.

Kromě toho fetch handleru budou vždy předány tři parametry: request, env a context.

index.js
export default {
	async fetch(request, env, ctx) {
		return new Response("Hello World!");
	},
};

Workers runtime očekává fetch handlerům vrátit Response objekt nebo Promise, který se vyřeší na Response objekt. V tomto příkladu vrátíte nový Response s řetězcem "Hello World!".

Nahraďte obsah aktuálního index.js soubor níže uvedeným obsahem, který změní textový výstup.

index.js
export default {
	async fetch(request, env, ctx) {
		return new Response("Hello Worker!");
	},
};

Poté soubor uložte a stránku znovu načtěte. Výstup vašeho Workeru se změní na nový text.

Žádné viditelné změny?

Pokud se výstup vašeho Workeru nemění, ověřte, že:

  1. Uložili jste změny do index.js.
  2. Máte wrangler dev běží.
  3. Znovu jste načetli prohlížeč.

4. Nasaďte svůj projekt

Nasaďte svůj Worker přes Wrangler na *.workers.dev subdoména nebo Custom Domain.

npx wrangler deploy

Pokud nemáte nakonfigurovanou žádnou subdoménu ani doménu, Wrangler vás během publikování vyzve k jejímu nastavení.

Zobrazte náhled svého Workeru na adrese <YOUR_WORKER>.<YOUR_SUBDOMAIN>.workers.dev.

Zobrazují se vám chyby 523?

Pokud se zobrazí 523 chyby při pushování vašeho *.workers.dev subdoménu poprvé, počkejte přibližně minutu a chyby samy zmizí.

Další kroky

Chcete-li udělat více: