Granska pull-begäranden i förproduktionsmiljöer
Den här artikeln visar hur du använder förproduktionsmiljöer för att granska ändringar i program som distribueras med Azure Static Web Apps. En förproduktionsmiljö är en fullt funktionell mellanlagrad version av ditt program som innehåller ändringar som inte är tillgängliga i produktion.
Kommentar
Pull-begärandemiljöer stöds inte automatiskt för Azure DevOps, men du kan använda namngivna miljöer för att konfigurera dem manuellt.
Azure Static Web Apps genererar ett YAML-arbetsflöde på lagringsplatsen. När en pull-begäran skapas mot en gren som arbetsflödet bevakar skapas förproduktionsmiljön. Förproduktionsmiljön fasar appen så att du kan granska ändringarna innan du push-överför dem till produktion. Livscykeln för en förproduktionsmiljö är kopplad till pull-begäran. När pull-begäran har stängts tas förproduktionsmiljön bort automatiskt.
Du kan utföra följande uppgifter i förproduktionsmiljöer:
- Granska visuella ändringar mellan produktion och mellanlagring, till exempel uppdateringar av innehåll och layout
- Demonstrera ändringarna i ditt team
- Jämföra olika versioner av ditt program
- Verifiera ändringar med hjälp av godkännandetester
- Utföra sanitetskontroller innan du distribuerar till produktion
Förutsättningar
- En befintlig GitHub-lagringsplats som konfigurerats med Azure Static Web Apps. Se Skapa din första statiska app om du inte har någon.
Gör en ändring
Gör en ändring i lagringsplatsen direkt på GitHub, som du ser i följande steg.
Gå till projektets lagringsplats på GitHub och välj sedan Gren.
Ange ett grennamn och välj Skapa gren.
Gå till appmappen och ändra textinnehåll, till exempel en rubrik eller ett stycke. Välj Redigera för att göra ändringen i filen.
Välj Checka in ändringar när du är klar.
Skapa en pull-begäran
Skapa en pull-begäran för att publicera uppdateringen.
Öppna fliken Pull-begäran i projektet på GitHub.
Välj Jämför och pull-begäran.
Du kan också ange information om dina ändringar och sedan välja Skapa pull-begäran.
Tilldela granskare och lägg till kommentarer för att diskutera dina ändringar om det behövs.
Flera förproduktionsmiljöer kan samexistera samtidigt när du använder Azure Static Web Apps. Varje gång du skapar en pull-begäran mot den övervakade grenen distribueras en mellanlagrad version med dina ändringar till en distinkt förproduktionsmiljö.
Du kan göra flera ändringar och skicka nya incheckningar till din gren. Pull-begäran uppdateras automatiskt för att återspegla alla ändringar.
Granska ändringar
GitHub Actions-distributionsarbetsflödet kör och distribuerar dina pull-begärandeändringar till en förproduktionsmiljö.
När arbetsflödet är klart med att skapa och distribuera din app lägger GitHub-roboten till en kommentar till din pull-begäran, som innehåller URL:en för förproduktionsmiljön.
Välj förproduktions-URL:en för att se dina mellanlagrade ändringar.
URL:en består så här:
https://<SUBDOMAIN-PULL_REQUEST_ID>.<AZURE_REGION>.azurestaticapps.net. För en viss pull-begäran förblir URL:en densamma, även om du skickar nya uppdateringar. Samma förproduktionsmiljö återanvänds också under hela pull-begäran.
För att automatisera granskningsprocessen med testning från slutpunkt till slutpunkt har static_web_app_url GitHub-åtgärden för distribution av Azure Static Web Apps utdatavariabeln.
Du kan referera till den här URL:en i resten av arbetsflödet för att köra dina tester mot förproduktionsmiljön.
Publicera ändringar
Sammanfoga pull-begäran om att publicera till produktion.
Välj Koppla pull-begäran.
Ändringarna kopieras till den spårade grenen (grenen "produktion"). Sedan startar distributionsarbetsflödet på den spårade grenen och ändringarna aktiveras när programmet har återskapats.
Öppna din produktions-URL för att läsa in liveversionen av webbplatsen och verifiera.
Begränsningar
Vem som helst kan komma åt mellanlagrade versioner av ditt program via deras URL, även om din GitHub-lagringsplats är privat.
Varning
Var försiktig med känsligt innehåll eftersom vem som helst kan komma åt förproduktionsmiljöer.
Antalet förproduktionsmiljöer som är tillgängliga för varje app som distribueras med Static Web Apps beror på din värdplan. Med den kostnadsfria nivån kan du till exempel ha tre förproduktionsmiljöer tillsammans med produktionsmiljön.
Förproduktionsmiljöer är inte geo-distribuerade.
Endast GitHub Actions-distributioner stöder förproduktionsmiljöer.