Ćwiczenie — publikowanie interfejsu API za pomocą funkcji GitHub Actions
Interfejs API został dodany do aplikacji internetowej i oba elementy działają lokalnie. Teraz nadszedł czas na opublikowanie interfejsu API i aplikacji w usłudze Azure Static Web Apps.
Po utworzeniu wystąpienia usługi Azure Static Web Apps i poproszeniu o obserwowanie gałęzi głównej, została dla Ciebie wygenerowana akcja usługi GitHub. Akcja usługi GitHub nasłuchuje głównej gałęzi repozytorium pod kątem zatwierdzeń i żądań ściągnięcia. Gdy akcja usługi GitHub wykrywa te zmiany, kompiluje i publikuje aplikację.
Po utworzeniu zasobu Azure Static Web Apps podałeś lokalizację folderu dla swojego projektu API, akceptując domyślną wartość Api. Usługa Azure Static Web Apps skompilowała i wdrożła aplikację usługi Azure Functions w tym folderze. Jednak aplikacja nie działała, ponieważ interfejs API HTTP GET nie został jeszcze utworzony.
Wyzwalanie akcji usługi GitHub
Akcja usługi GitHub jest gotowa do zbudowania i opublikowania aplikacji internetowej oraz interfejsu API po wykryciu zmiany w gałęzi głównej . Możesz zatwierdzić bezpośrednio lub utworzyć pull request do gałęzi main. Obie te zmiany wyzwalają akcję usługi GitHub. Po wykryciu zmian w gałęzi głównej wyzwala akcję usługi GitHub w celu opublikowania aplikacji pod tym samym adresem URL dla aktywnej witryny internetowej.
Środowiska przedprodukcyjne z adresami URL w wersji zapoznawczej
Czasami chcesz zobaczyć zmiany w lokalizacji tymczasowej zanim je opublikujesz w działającej witrynie internetowej. Usługa Azure Static Web Apps umożliwia wyświetlanie zmian w środowiskach przedprodukcyjnych, które mają własny adres URL wersji zapoznawczej. Środowisko przedprodukcyjne można utworzyć, tworząc żądanie ściągnięcia względem gałęzi obserwowanej przez akcję usługi GitHub. Nie ma to wpływu na twoją dynamiczną witrynę internetową. Zamiast tego nowa wersja aplikacji jest tworzona we własnym środowisku przedprodukcyjnym. Jeśli wrócisz i sprawdzisz żądanie ściągnięcia w usłudze GitHub, zauważysz, że link do wersji przedprodukcyjnej zostanie opublikowany na karcie Konwersacja.
W poniższej tabeli przedstawiono sposób publikowania aplikacji przez usługę Azure Static Web Apps na różne adresy URL. Aplikacja publikuje pod jednym adresem URL, natomiast żądanie ściągnięcia do tej samej gałęzi publikuje pod innym adresem URL. Te automatycznie wygenerowane adresy URL są dostarczane przez usługę Azure Static Web Apps dla aplikacji produkcyjnej i żądań ściągnięcia. Opcjonalnie można przypisać domenę niestandardową do aplikacji produkcyjnej.
| Lokalizacja źródłowa | opis | adres URL |
|---|---|---|
| gałąź główna | Przykład adresu URL aktywnej witryny internetowej | https://purple-rain-062d03304.azurestaticapps.net/ |
| Żądanie ściągnięcia #5 | Przykład adresu URL podglądu | https://purple-rain-062d03304-5.<location>.azurestaticapps.net/ |
Obecnie pracujesz w gałęzi API. Robisz pull request z gałęzi api do gałęzi main. Podczas tworzenia żądania ściągnięcia względem gałęzi głównej akcja usługi GitHub publikuje aplikację w środowisku przedprodukcyjnym.
Po zakończeniu tworzenia i wdrażania aplikacji przepływ pracy bot usługi GitHub dodaje komentarz do żądania ściągnięcia. Ten komentarz zawiera link do adresu URL środowiska przedprodukcyjnego. Możesz wybrać ten link, aby wyświetlić wprowadzone zmiany.
Następnie utworzysz żądanie ściągnięcia i przejdź do przygotowanej wersji aplikacji.