← Cloudflare Pages / pages / framework-guides

Hono

Hono ↗ je malý, jednoduchý a extrémně rychlý webový framework pro Cloudflare Pages a Workers, Deno a Bun. Více o vzniku Hono se dozvíte od sledování rozhovoru s jeho tvůrcem, Yusuke Wada ↗.

V tomto průvodci vytvoříte novou aplikaci Hono a nasadíte ji pomocí Cloudflare Pages.

Použijte create-cloudflare ↗ CLI (C3) k vytvoření nového projektu. C3 vytvoří nový adresář projektu, spustí oficiální nástroj pro nastavení Hono a nabídne možnost okamžitého nasazení.

Chcete-li použít create-cloudflare k vytvoření nového projektu Hono spusťte následující příkaz:

npm create cloudflare@latest -- my-hono-app --framework=hono --platform=pages

Ve svém novém projektu Hono najdete public/static adresář pro vaše statické soubory a src/index.ts soubor, který slouží jako vstupní bod pro kód na straně serveru.

Svou aplikaci vyvíjejte lokálně spuštěním:

npm run dev

Vygenerovanou webovou aplikaci byste si měli moct prohlédnout na http://localhost:8788.

Všechny průvodce frameworky předpokládají, že již máte základní znalosti Git ↗. Pokud s Gitem začínáte, podívejte se na tento shrnutá příručka ke Gitu ↗ jak nastavit Git na svém lokálním počítači.

Pokud klonujete přes SSH, musíte vygenerujte SSH klíče ↗ na každém počítači, který používáte pro push nebo pull z GitHubu.

Viz dokumentace GitHub ↗ a Dokumentace Git ↗ s dalšími informacemi.

Vytvořte nový repozitář GitHub na repo.new ↗. Po vytvoření nového repozitáře přejděte do adresáře nově vytvořeného projektu a v terminálu spusťte následující příkazy, kterými připravíte a odešlete svou místní aplikaci na GitHub:

git init
git remote add origin https://github.com/<your-gh-username>/<repository-name>
git add .
git commit -m "Initial commit"
git branch -M main
git push -u origin main

Pokud používáte create-cloudflare(C3) ↗ k vytvoření nového projektu Hono nainstaluje C3 všechny závislosti, které projekt potřebuje, a vyzve vás k nasazení projektu přes CLI. Pokud jej nasadíte, web se zveřejní a získáte URL adresu nasazení.

Chcete-li nasadit svůj web do Pages:

1. V dashboardu Cloudflare přejděte na Workers & Pages stránce.

   Přejděte na Workers & Pages ↗

2. Vyberte Vytvoření aplikace.

3. Vyberte Pages kartě.

4. Vyberte Importujte existující repozitář Git.

5. Vyberte nově vytvořený repozitář GitHub a poté vyberte Zahájit nastavení.

6. V Nastavení sestavení a nasazení sekci uveďte následující informace:

Po nakonfigurování webu můžete spustit první nasazení. Měli byste vidět, jak Cloudflare Pages instaluje my-hono-app, závislosti projektu a sestavuje web, než ho nasadí.

Po nasazení webu získáte pro svůj projekt jedinečnou subdoménu na *.pages.dev. Pokaždé, když do svého webu Hono committnete nový kód, Cloudflare Pages automaticky znovu sestaví váš projekt a nasadí ho. Získáte také přístup k náhledová nasazení u nových pull requestů, takže si můžete prohlédnout, jak změny na vašem webu vypadají, než je nasadíte do produkce.