Ć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 wyświetleniu monitu o obserwowanie gałęzi main została 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 usługi Azure Static Web Apps podano lokalizację folderu dla projektu interfejsu API, akceptując wartość domyślną interfejsu 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 kompilowania i publikowania aplikacji internetowej oraz interfejsu API po wykryciu zmiany w gałęzi main. Możesz albo zatwierdzić zmianę bezpośrednio, albo utworzyć żądanie ściągnięcia 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 jest publikowana pod jednym adresem URL, natomiast żądanie ściągnięcia do tej samej gałęzi jest publikowane 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łąź main | 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/ |
Pracujesz obecnie w gałęzi api. Żądanie ściągnięcia należy wykonać z gałęzi interfejsu API do gałęzi głównej. 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.