Naplánování statické webové aplikace Azure

3 min

Vaším konečným cílem je hostování vytvořené aplikace v Azure. Služba Azure Static Web Apps se za vás postará o zřízení všech potřebných prostředků Azure.

Než ale budete moct aplikaci hostovat, potřebujete něco, co ji znovu sestaví, když v ní uděláte nějaké změny. Úpravy lze provádět prostřednictvím potvrzení změn nebo žádostí o přijetí změn do vašeho úložiště. Klíčovou funkcí služby Azure Static Web Apps je, že nastaví pracovní postup GitHub Actions pro sestavování a publikování aplikace.

Prostředek Azure Static Web Apps, který si vytvoříte, tedy nastaví pracovní postup GitHub Actions. Tento pracovní postup se okamžitě aktivuje a postará se o sestavení a publikování vaší aplikace. Aktivuje se také vždy, když provedete změnu ve sledované větvi ve vašem úložišti.

Azure Static Web Apps

Nasazení webové aplikace zahrnuje dva automatizovanými procesy. Při prvním se zřídí základní prostředky Azure, které tvoří vaši aplikaci. Druhým je právě pracovní postup GitHub Actions, který vytvoří a publikuje vaši aplikaci.

Publikováním aplikace na web pomocí Azure Static Web Apps získáváte rychlé hostování webové aplikace a škálovatelná rozhraní API. Dále získáváte sjednocený pracovní postup sestavení a nasazení na bázi GitHub Actions.

Připojení instance Static Web Apps ke GitHubu

Služba Azure Static Web Apps je navržená pro hostování aplikací, zatímco zdrojový kód se nachází na GitHubu. Když vytvoříte instanci Static Web Apps, přihlásíte se k GitHubu a zadáte úložiště obsahující kód vaší aplikace.

Je také potřeba zadat cesty ke třem složkám v úložišti, aby bylo možné aplikaci automaticky sestavit a nasadit:

Umístění	Příklad umístění	Popis	Povinní účastníci
Umístění aplikace	Klient	Umístění zdrojového kódu vaší webové aplikace	Ano
Umístění výstupu	wwwroot	Umístění artefaktů sestavení vaší aplikace	No
Umístění rozhraní API	API	Umístění zdrojového kódu vašeho rozhraní API	No

Umístění výstupu je relativní cesta k adresáři publikování vaší aplikace. Předpokládejme například, že máme aplikaci v Client, která své sestavené prostředky odesílá jako výstup do bin/<build profile>/<framework>/publish/wwwroot. V tomto případě stačí zadat wwwroot pouze pro toto umístění, protože systém publikování se postará o zbytek předpony.

Od zdrojového kódu ke statickým prostředkům pomocí GitHub Actions

Úložiště GitHubu obsahuje zdrojový kód, ne statické prostředky, takže je potřeba ho vytvořit, aby bylo možné ho publikovat.

Když si vytvoříte instanci Static Web Apps, Azure ve vašem úložišti vytvoří pracovní postup GitHub Actions. Pokaždé, když nasdílíte změny nebo vytvoříte žádost o přijetí změn ve větvi, ze které vydáváte, pracovní postup sestaví vaši aplikaci. Tento proces změní zdrojový kód na statické prostředky, které Azure obsluhuje. Po dokončení sestavení akce nasadí prostředky.

Akce GitHubu se přidá do složky .github/workflows ve vašem úložišti. Tento soubor si můžete podle potřeby zkontrolovat nebo upravit. Nastavení, které zadáte při vytváření prostředku, se ukládá do souboru akce GitHubu.

Integrované rozhraní API na bázi Azure Functions

Pokud vaše aplikace vyžaduje rozhraní API, můžete ji implementovat jako projekt Azure Functions ve vašem úložišti a instance Static Web Apps ji automaticky nasadí a hostuje. Pracovní postup GitHub Actions, který sestaví a nasadí vaši aplikaci, vyhledá rozhraní API v úložišti pomocí názvu složky, kterou jste zadali v cestě k umístění rozhraní API.

Co když rozhraní API nemáte? Buďte bez obav. Pokud Azure Static Web Apps nemůže najít rozhraní API ve složce, kterou označíte, nepublikuje rozhraní API, ale stále publikuje vaši aplikaci.

Další kroky