Udostępnij za pośrednictwem


Przeglądanie żądań ściągnięcia w środowiskach przedprodukcyjnych

W tym artykule pokazano, jak używać środowisk przedprodukcyjnej do przeglądania zmian w aplikacjach wdrożonych za pomocą usługi Azure Static Web Apps. Środowisko przedprodukcyjne to w pełni funkcjonalna wersja aplikacji, która zawiera zmiany niedostępne w środowisku produkcyjnym.

Uwaga

Środowiska żądań ściągnięcia nie są automatycznie obsługiwane dla usługi Azure DevOps, ale można użyć nazwanych środowisk do ręcznego skonfigurowania ich.

Usługa Azure Static Web Apps generuje przepływ pracy YAML w repozytorium. Po utworzeniu żądania ściągnięcia względem gałęzi, którą obserwuje przepływ pracy, środowisko przedprodukcyjne zostanie skompilowane. Środowisko przedprodukcyjne etapy aplikacji, dzięki czemu można przejrzeć zmiany przed wypchnięciem ich do środowiska produkcyjnego. Cykl życia środowiska przedprodukcyjnego jest powiązany z żądaniem ściągnięcia. Po zamknięciu żądania ściągnięcia środowisko przedprodukcyjne zostanie automatycznie usunięte.

W środowiskach przedprodukcyjnych można wykonywać następujące zadania:

  • Przeglądanie zmian wizualnych między środowiskiem produkcyjnym i przejściowym, takich jak aktualizacje zawartości i układu
  • Prezentacja zmian w zespole
  • Porównanie różnych wersji aplikacji
  • Weryfikowanie zmian przy użyciu testów akceptacyjnych
  • Przed wdrożeniem w środowisku produkcyjnym przeprowadzaj kontrole kondycji

Wymagania wstępne

  • Istniejące repozytorium GitHub skonfigurowane za pomocą usługi Azure Static Web Apps. Jeśli nie masz pierwszej aplikacji statycznej, zobacz Tworzenie pierwszej aplikacji statycznej.

Wprowadzanie zmiany

Wprowadź zmiany w repozytorium bezpośrednio w usłudze GitHub, jak pokazano w poniższych krokach.

  1. Przejdź do repozytorium projektu w usłudze GitHub, a następnie wybierz pozycję Gałąź.

    Create new branch using GitHub interface

  2. Wprowadź nazwę gałęzi i wybierz pozycję Utwórz gałąź.

  3. Przejdź do folderu aplikacji i zmień zawartość tekstową, na przykład tytuł lub akapit. Wybierz pozycję Edytuj , aby wprowadzić zmianę w pliku.

    Edit file button in GitHub interface

  4. Po zakończeniu wybierz pozycję Zatwierdź zmiany .

    Screenshot showing the Commit changes button in the GitHub interface.

Tworzenie żądania ściągnięcia

Utwórz żądanie ściągnięcia, aby opublikować aktualizację.

  1. Otwórz kartę Żądanie ściągnięcia projektu w usłudze GitHub.

    Screenshot showing the pull request tab in a GitHub repo.

  2. Wybierz pozycję Porównaj i żądanie ściągnięcia.

  3. Opcjonalnie wprowadź szczegóły dotyczące zmian, a następnie wybierz pozycję Utwórz żądanie ściągnięcia.

    Screenshot showing the pull request creation in GitHub.

Przypisz recenzentów i dodaj komentarze, aby w razie potrzeby omówić zmiany.

Wiele środowisk przedprodukcyjnech może współistnieć w tym samym czasie, gdy używasz usługi Azure Static Web Apps. Za każdym razem, gdy tworzysz żądanie ściągnięcia względem obserwowanej gałęzi, wersja etapowa ze zmianami jest wdrażana w odrębnym środowisku przedprodukcyjnym.

Możesz wprowadzić wiele zmian i wypchnąć nowe zatwierdzenia do gałęzi. Żądanie ściągnięcia jest automatycznie aktualizowane w celu odzwierciedlenia wszystkich zmian.

Przeglądanie zmian

Przepływ pracy wdrażania funkcji GitHub Actions jest uruchamiany i wdraża zmiany żądania ściągnięcia w środowisku przedprodukcyjnym.

Po zakończeniu kompilowania i wdrażania aplikacji bot usługi GitHub dodaje komentarz do żądania ściągnięcia, który zawiera adres URL środowiska przedprodukcyjnego.

  1. Wybierz adres URL przedprodukcyjny, aby wyświetlić wprowadzone zmiany.

    Screenshot of pull request comment with the pre-production URL.

    Adres URL składa się w następujący sposób: https://<SUBDOMAIN-PULL_REQUEST_ID>.<AZURE_REGION>.azurestaticapps.net. W przypadku danego żądania ściągnięcia adres URL pozostaje taki sam, nawet jeśli wypchniesz nowe aktualizacje. To samo środowisko przedprodukcyjne jest również ponownie używane do życia żądania ściągnięcia.

Aby zautomatyzować proces przeglądu przy użyciu kompleksowego testowania, akcja usługi GitHub na potrzeby wdrażania usługi Azure Static Web Apps ma zmienną wyjściową static_web_app_url . Możesz odwołać się do tego adresu URL w pozostałej części przepływu pracy, aby uruchomić testy w środowisku przedprodukcyjnym.

Opublikuj zmiany

Scal żądanie ściągnięcia w celu opublikowania w środowisku produkcyjnym.

  1. Wybierz pozycję Scal żądanie ściągnięcia.

    Screenshot showing the Merge pull request button in GitHub interface.

    Zmiany są kopiowane do śledzonej gałęzi (gałęzi "produkcja"). Następnie przepływ pracy wdrażania rozpoczyna się w śledzonej gałęzi, a zmiany zostaną uruchomione po odbudowaniu aplikacji.

  2. Otwórz adres URL środowiska produkcyjnego, aby załadować wersję na żywo witryny internetowej i zweryfikować.

Ograniczenia

  • Każda osoba może uzyskać dostęp do przygotowanych wersji aplikacji za pośrednictwem ich adresu URL, nawet jeśli repozytorium GitHub jest prywatne.

    Ostrzeżenie

    Zachowaj ostrożność przy użyciu poufnej zawartości, ponieważ każda osoba może uzyskiwać dostęp do środowisk przedprodukcyjnych.

  • Liczba środowisk przedprodukcyjnych dostępnych dla każdej aplikacji wdrożonej za pomocą usługi Static Web Apps zależy od planu hostingu. Na przykład w warstwie Bezpłatna możesz mieć trzy środowiska przedprodukcyjne wraz ze środowiskiem produkcyjnym.

  • Środowiska przedprodukcyjne nie są rozproszone geograficznie.

  • Środowiska przedprodukcyjne są obsługiwane tylko we wdrożeniach GitHub Actions.

Następne kroki