Publikování rozhraní API pomocí GitHub Actions
Do své webové aplikace jste přidali rozhraní API a obě tyto komponenty běží místně. Teď nastal čas publikovat rozhraní API i aplikaci do Azure Static Web Apps.
Když jste vytvořili instanci Azure Static Web Apps a dali jí pokyn ke sledování větve main, vygenerovala se vám akce GitHubu. Akce GitHubu naslouchá hlavní větvi úložiště pro potvrzení a žádosti o přijetí změn. Když akce GitHubu tyto změny detekuje, přistoupí k sestavení a publikování vaší aplikace.
Když jste vytvořili prostředek Azure Static Web Apps, zadali jste umístění složky pro projekt rozhraní API tím, že přijmete výchozí hodnotu rozhraní API. Služba Azure Static Web Apps vytvořila a nasadila aplikaci Azure Functions do této složky. Aplikace ale nefungovala, protože rozhraní API HTTP GET ještě není vytvořené.
Aktivace akce GitHubu
Akce GitHubu je připravena začít sestavovat a publikovat webovou aplikaci a rozhraní API, jakmile zjistí změnu ve větvi main. Buď můžete změny potvrdit přímo, nebo můžete ve větvi main vytvořit žádost o přijetí změn. Obě tyto změny aktivují akci GitHubu. Když se v hlavní větvi zjistí změny, aktivuje akci GitHubu, která publikuje aplikaci na stejné adrese URL vašeho živého webu.
Předprodukční prostředí s adresami URL ve verzi Preview
Někdy si budete chtít změny před publikováním na živý web prohlédnout na přípravném webu. Azure Static Web Apps umožňuje zobrazit změny v předprodukčních prostředích, která mají svoji vlastní adresu URL verze Preview. Předprodukční prostředí můžete vytvořit vytvořením žádosti o přijetí změn ve větvi, kterou sleduje vaše akce GitHubu. Na váš živý web to nemá vliv. Místo toho se vytvoří nová verze vaší aplikace ve vlastním předprodukčním prostředí. Pokud se vrátíte a zkontrolujete žádost o přijetí změn na GitHubu, všimnete si, že na kartě Konverzace se publikuje odkaz na předprodukční verzi.
Následující tabulka ukazuje, jak Azure Static Web Apps publikuje vaši aplikaci na různé adresy URL. Vaše aplikace se publikuje na jednu adresu URL, zatímco žádost o přijetí změn do stejné větve se publikuje na jinou adresu URL. Tyto automaticky generované adresy URL poskytuje Služba Azure Static Web Apps pro produkční aplikaci a žádosti o přijetí změn. Volitelně můžete k produkční aplikaci přiřadit vlastní doménu.
| Source | Popis | Adresa URL |
|---|---|---|
| větev main | Příklad adresy URL živého webu | https://purple-rain-062d03304.azurestaticapps.net/ |
| Žádost o přijetí změn č. 5 | Příklad adresy URL náhledu | https://purple-rain-062d03304-5.<location>.azurestaticapps.net/ |
V tuto chvíli pracujete ve větvi api. Z větve api vytvoříte žádost o přijetí změn do hlavní větve. Když vytvoříte žádost o přijetí změn proti hlavní větvi, akce GitHubu publikuje aplikaci do předprodukčního prostředí.
Jakmile pracovní postup dokončí sestavování a nasazování aplikace, robot GitHubu přidá do žádosti o přijetí změn komentář. Tento komentář obsahuje odkaz na adresu URL předprodukčního prostředí. Výběrem tohoto odkazu můžete zobrazit připravené změny.
Dále vytvoříte žádost o přijetí změn a navštívíte fázovanou verzi aplikace.