Granska pull-begäranden i förproduktionsmiljöer i Azure Static Web Apps

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ö (mellanlagring) är en fullt funktionell mellanlagrad version av ditt program som innehåller ändringar som inte är tillgängliga i produktion.

Azure Static Web Apps genererar ett arbetsflöde GitHub Actions på lagringsplatsen. När en pull-begäran skapas mot en gren som arbetsflödet bevakar skapas förproduktionsmiljön. Förproduktionsmiljön mellanstadierar appen och gör att du kan utföra granskningar innan du push-erar till produktion.

Flera förproduktionsmiljöer kan finnas 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 mellangrenad version med dina ändringar till en distinkt förproduktionsmiljö.

Det finns många fördelar med att använda förproduktionsmiljöer. Du kan till exempel:

  • Granska visuella ändringar mellan produktion och mellanlagring. Till exempel visa uppdateringar av innehåll och layout.
  • Visa ändringarna i ditt team.
  • Jämför olika versioner av ditt program.
  • Verifiera ändringar med godkännandetester.
  • Utför hälsokontroller innan du distribuerar till produktion.

Anteckning

Pull-begäranden och förproduktionsmiljöer stöds för närvarande endast i GitHub Actions-distributioner.

Förutsättningar

Göra en ändring

Börja med att göra en ändring i lagringsplatsen. Du kan göra det direkt GitHub på det sätt som visas i följande steg.

  1. Gå till projektets lagringsplats på sidan GitHub sedan på knappen Gren för att skapa en ny gren.

    Skapa en ny gren med GitHub gränssnitt ]

    Skriv ett grennamn och klicka på Skapa gren.

  2. Gå till appmappen och ändra textinnehåll. Du kan till exempel ändra en rubrik eller ett stycke. När du har hittat filen som du vill redigera klickar du på Redigera för att göra ändringen.

    Knappen Redigera fil i GitHub gränssnittet

  3. När du har gjort ändringarna klickar du på Genomför ändringar för att genomföra ändringarna i -grenen.

    Knappen Spara ändringar i GitHub gränssnittet

Skapa en pull-begäran

Skapa sedan en pull-begäran från den här ändringen.

  1. Öppna fliken Pull-begäran för projektet på GitHub:

    Fliken Pull-begäran i en GitHub lagringsplats

  2. Klicka på knappen & pull-begäran för din gren.

  3. Om du vill kan du fylla i information om dina ändringar och sedan klicka på Skapa pull-begäran.

    Skapande av pull-begäran i GitHub

Du kan tilldela granskare och lägga till kommentarer för att diskutera dina ändringar om det behövs.

Anteckning

Du kan göra flera ändringar genom att push-pusha nya genomföranden till din gren. Pull-begäran uppdateras sedan automatiskt för att återspegla alla ändringar.

Granska ändringar

När pull-begäran har skapats körs GitHub Actions-distributionsarbetsflödet och distribuerar ändringarna till en förproduktionsmiljö.

När arbetsflödet har byggt och distribuerat appen lägger GitHub-roboten till en kommentar i pull-begäran som innehåller URL:en för förproduktionsmiljön. Du kan klicka på länken för att visa de mellanlagrade ändringarna.

Kommentar för pull-begäran med url:en för förproduktion

Klicka på den genererade URL:en för att se ändringarna.

Om du tar en närmare titt på URL:en ser du att den är uppbyggd 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 push-kör nya uppdateringar. Förutom att URL:en håller konstant återanvänds samma förproduktionsmiljö under pull-begärans livslängd.

Publicera ändringar

När ändringarna har godkänts kan du publicera ändringarna i produktion genom att sammanfoga pull-begäran.

Klicka på Sammanfoga pull-begäran:

Knappen Sammanfoga pull-begäran i GitHub gränssnittet

Sammanslagning kopierar dina ändringar till den spårade grenen (produktionsgrenen). Distributionsarbetsflödet startar sedan på den spårade grenen och ändringarna är live när programmet har återskapats.

Om du vill kontrollera ändringarna i produktion öppnar du produktions-URL:en för att läsa in webbplatsens liveversion.

Begränsningar

  • Mellanstegsversioner av ditt program är för närvarande tillgängliga offentligt via deras URL, även om GitHub lagringsplatsen är privat.

    Varning

    Var försiktig när du publicerar känsligt innehåll till mellaninstallerade versioner, eftersom åtkomsten till förproduktionsmiljöer inte begränsas.

  • Antalet förproduktionsmiljöer som är tillgängliga för varje app som distribueras med Static Web Apps beror på vilken värdplan du använder. Med den kostnadsfria nivån kan du till exempel ha 3 förproduktionsmiljöer utöver produktionsmiljön.

  • Förproduktionsmiljöer är inte geo-distribuerade.

  • För närvarande stöder GitHub Actions-distributioner för förproduktionsmiljöer.

Nästa steg