← Cloudflare Pages / pages / framework-guides

Blazor

Blazor ↗ je framework SPA, který v prohlížeči místo JavaScriptu používá kód v C#. V tomto návodu vytvoříte web pomocí Blazoru a nasadíte ho pomocí Cloudflare Pages.

Blazor využívá C#. Budete potřebovat nejnovější verzi .NET SDK ↗ a pokračujte ve vytváření projektu Blazor. Pokud nemáte v systému nainstalované SDK, stáhněte si instalační program a spusťte ho.

Existují dva typy hostingových modelů Blazor: Blazor Server ↗ která vyžaduje server, jenž doručuje aplikaci Blazor koncovému uživateli, a Blazor WebAssembly ↗ která běží v prohlížeči. Blazor Server není kompatibilní s modelem edge sítě Cloudflare, a proto se tento návod zaměřuje pouze na Blazor WebAssembly.

Vytvořte novou aplikaci Blazor WebAssembly (WASM) spuštěním následujícího příkazu:

dotnet new blazorwasm -o my-blazor-project

Aby mohl Cloudflare Pages nasazení provést, potřebuje způsob, jak sestavit projekt Blazor. V kořenovém adresáři projektu vytvořte build.sh soubor. Naplňte jej následujícím obsahem (upravte .dotnet-install.sh řádek podle potřeby, pokud nepoužíváte nejnovější .NET SDK):

#!/bin/sh
curl -sSL https://dot.net/v1/dotnet-install.sh > dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh -c 8.0 -InstallDir ./dotnet
./dotnet/dotnet --version
./dotnet/dotnet publish -c Release -o output

Váš build.sh soubor musí být spustitelný, aby sestavovací příkaz fungoval. Toho dosáhnete spuštěním chmod +x build.sh.

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ření .gitignore soubor zajistí, že se do vašeho repozitáře GitHub odešle pouze to, co je potřeba. Vytvořte .gitignore soubor spuštěním následujícího příkazu:

dotnet new gitignore

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

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 dotnet, 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 Blazor 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.

Pokud se zobrazí chybová zpráva Error: Asset "/opt/buildhome/repo/output/wwwroot/_framework/dotnet.wasm" is over the 25MiB limit, vyřešte to jednou z následujících akcí:

1. Zmenšete velikost svých assetů pomocí následujícího průvodce ↗.

Nebo

2. Odeberte *.wasm soubory z výstupu (rm output/wwwroot/_framework/*.wasm) a upravte svoji aplikaci Blazor tak, aby načíst soubory komprimované pomocí Brotli ↗ místo toho.

Dokončením tohoto návodu jste úspěšně nasadili svůj web Blazor na Cloudflare Pages. Chcete-li začít s dalšími frameworky, podívejte se na seznam návodů pro frameworky.