Pull-aanvragen controleren in preproductieomgevingen in Azure Static Web Apps

In dit artikel wordt gedemonstreerd hoe u preproductieomgevingen gebruikt om wijzigingen te controleren in toepassingen die zijn geïmplementeerd met Azure Static Web Apps.

Een preproductieomgeving (fasering) is een volledig functionele, gefaseerd versie van uw toepassing die wijzigingen bevat die niet beschikbaar zijn in productie.

Azure Static Web Apps genereert een werkstroom GitHub Acties in de opslagplaats. Wanneer een pull-aanvraag wordt gemaakt voor een vertakking die door de werkstroom wordt bewaakt, wordt de preproductieomgeving gebouwd. In de preproductieomgeving wordt de app gefased, kunt u beoordelingen uitvoeren voordat u naar productie pusht.

Meerdere preproductieomgevingen kunnen naast elkaar bestaan wanneer u Azure Static Web Apps. Telkens wanneer u een pull-aanvraag maakt voor de gevolgde vertakking, wordt een gefaseerd versie met uw wijzigingen geïmplementeerd in een afzonderlijke preproductieomgeving.

Het gebruik van preproductieomgevingen biedt veel voordelen. U kunt bijvoorbeeld:

  • Bekijk visuele wijzigingen tussen productie en fasering. Bijvoorbeeld het weergeven van updates voor inhoud en indeling.
  • Demonstreert de wijzigingen in uw team.
  • Vergelijk verschillende versies van uw toepassing.
  • Wijzigingen valideren met acceptatietests.
  • Voer een sanity-controle uit voordat u naar productie implementeert.

Notitie

Pull-aanvragen en preproductieomgevingen worden momenteel alleen ondersteund in GitHub Actions-implementaties.

Vereisten

Een wijziging maken

Begin met het maken van een wijziging in uw opslagplaats. U kunt dit rechtstreeks op de GitHub zoals wordt weergegeven in de volgende stappen.

  1. Navigeer naar de opslagplaats van uw project GitHub klik vervolgens op de knop Vertakking om een nieuwe vertakking te maken.

    Nieuwe vertakking maken met GitHub interface ]

    Typ een vertakkingsnaam en klik op Vertakking maken.

  2. Ga naar uw app-map en wijzig wat tekstinhoud. U kunt bijvoorbeeld een titel of alinea wijzigen. Zodra u het bestand hebt gevonden dat u wilt bewerken, klikt u op Bewerken om de wijziging aan te brengen.

    De knop Bestand bewerken in GitHub interface

  3. Nadat u de wijzigingen hebt aangebracht, klikt u op Wijzigingen aanbrengen om uw wijzigingen in de vertakking door te voeren.

    Knop Wijzigingen aanbrengen in GitHub interface

Een pull-aanvraag maken

Maak vervolgens een pull-aanvraag van deze wijziging.

  1. Open het tabblad Pull-aanvraag van uw project op GitHub:

    Tabblad Pull-aanvraag in een GitHub opslagplaats

  2. Klik op de knop & pull-aanvraag van uw vertakking vergelijken.

  3. U kunt eventueel enkele details over uw wijzigingen invullen en vervolgens op Pull-aanvraag maken klikken.

    Pull-aanvraag maken in GitHub

U kunt revisoren toewijzen en opmerkingen toevoegen om uw wijzigingen indien nodig te bespreken.

Notitie

U kunt meerdere wijzigingen aanbrengen door nieuwe commits naar uw vertakking te pushen. De pull-aanvraag wordt vervolgens automatisch bijgewerkt om alle wijzigingen weer te geven.

Wijzigingen controleren

Nadat de pull-aanvraag is gemaakt, wordt GitHub de implementatiewerkstroom acties uitgevoerd en worden uw wijzigingen geïmplementeerd in een preproductieomgeving.

Zodra de werkstroom is voltooid met het bouwen en implementeren van uw app, voegt de GitHub-bot een opmerking toe aan uw pull-aanvraag die de URL van de preproductieomgeving bevat. U kunt op deze link klikken om uw gefaseerde wijzigingen te zien.

Opmerking bij pull-aanvraag met de PRE-productie-URL

Klik op de gegenereerde URL om de wijzigingen te bekijken.

Als u de URL nader bekijkt, kunt u zien dat deze er als de volgende uit ziet: https://<SUBDOMAIN-PULL_REQUEST_ID>.<AZURE_REGION>.azurestaticapps.net .

Voor een bepaalde pull-aanvraag blijft de URL hetzelfde, zelfs als u nieuwe updates pusht. Naast dat de URL constant blijft, wordt dezelfde preproductieomgeving opnieuw gebruikt voor de levensduur van de pull-aanvraag.

Wijzigingen publiceren

Zodra de wijzigingen zijn goedgekeurd, kunt u uw wijzigingen naar productie publiceren door de pull-aanvraag samen te voegen.

Klik op Pull-aanvraag samenvoegen:

Knop Pull-aanvraag samenvoegen in GitHub interface

Door samen te voegen worden uw wijzigingen gekopieerd naar de bijgespoorde vertakking (de productie-vertakking). Vervolgens wordt de implementatiewerkstroom gestart op de bijgespoorde vertakking en zijn de wijzigingen live nadat uw toepassing opnieuw is opgebouwd.

Als u de wijzigingen in de productie wilt controleren, opent u uw productie-URL om de liveversie van de website te laden.

Beperkingen

  • Gefaseerd versies van uw toepassing zijn momenteel openbaar toegankelijk via hun URL, zelfs als uw GitHub-opslagplaats privé is.

    Waarschuwing

    Wees voorzichtig bij het publiceren van gevoelige inhoud naar gefaseerd versies, omdat de toegang tot preproductieomgevingen niet wordt beperkt.

  • Het aantal preproductieomgevingen dat beschikbaar is voor elke app die is geïmplementeerd met Static Web Apps is afhankelijk van het hostingplan dat u gebruikt. Met de gratis laag kunt u bijvoorbeeld 3 preproductieomgevingen naast de productieomgeving hebben.

  • Preproductieomgevingen zijn niet geografisch gedistribueerd.

  • Momenteel ondersteunen alleen GitHub Actions-implementaties preproductieomgevingen.

Volgende stappen