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 bestaande GitHub-opslagplaats die is geconfigureerd met Azure Static Web Apps. Zie Uw eerste statische app bouwen als u er nog geen hebt.
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.
Navigeer naar de opslagplaats van uw project GitHub klik vervolgens op de knop Vertakking om een nieuwe vertakking te maken.
]Typ een vertakkingsnaam en klik op Vertakking maken.
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.
Nadat u de wijzigingen hebt aangebracht, klikt u op Wijzigingen aanbrengen om uw wijzigingen in de vertakking door te voeren.
Een pull-aanvraag maken
Maak vervolgens een pull-aanvraag van deze wijziging.
Open het tabblad Pull-aanvraag van uw project op GitHub:
Klik op de knop & pull-aanvraag van uw vertakking vergelijken.
U kunt eventueel enkele details over uw wijzigingen invullen en vervolgens op Pull-aanvraag maken klikken.
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.
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:
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.