Esaminare le richieste pull negli ambienti di pre-produzione
Questo articolo illustra come usare gli ambienti di pre-produzione per esaminare le modifiche apportate alle applicazioni distribuite con App Web statiche di Azure. Un ambiente di pre-produzione è una versione a fasi completamente funzionale dell'applicazione che include modifiche non disponibili nell'ambiente di produzione.
Nota
Gli ambienti delle richieste pull non sono supportati automaticamente per Azure DevOps, ma è possibile usare ambienti denominati per configurarli manualmente.
App Web statiche di Azure genera un flusso di lavoro YAML nel repository. Quando viene creata una richiesta pull su un ramo monitorato dal flusso di lavoro, viene compilato l'ambiente di pre-produzione. L'ambiente di pre-produzione esegue le fasi dell'app, in modo da poter esaminare le modifiche prima di eseguirne il push nell'ambiente di produzione. Il ciclo di vita di un ambiente di pre-produzione è associato alla richiesta pull. Una volta chiusa la richiesta pull, l'ambiente di pre-produzione viene eliminato automaticamente.
È possibile eseguire le attività seguenti all'interno di ambienti di pre-produzione:
- Esaminare le modifiche visive tra produzione e gestione temporanea, ad esempio gli aggiornamenti al contenuto e al layout
- Illustrare le modifiche apportate al team
- Confrontare versioni diverse dell'applicazione
- Convalidare le modifiche usando i test di accettazione
- Eseguire controlli di integrità prima della distribuzione nell'ambiente di produzione
Prerequisiti
- Un repository GitHub esistente configurato con App Web statiche di Azure. Se non è ancora stato creato, vedere Compilazione della prima app statica.
Apportare una modifica
Apportare una modifica al repository direttamente in GitHub, come illustrato nei passaggi seguenti.
Passare al repository del progetto in GitHub e quindi selezionare Ramo.
Immettere un nome di ramo e selezionare Crea ramo.
Passare alla cartella dell'app e modificare il contenuto del testo, ad esempio un titolo o un paragrafo. Selezionare Modifica per apportare la modifica nel file.
Al termine, selezionare Commit changes (Esegui commit modifiche ).
Crea una richiesta pull
Creare una richiesta pull per pubblicare l'aggiornamento.
Aprire la scheda Richiesta pull del progetto in GitHub.
Selezionare Confronta e richiesta pull.
Facoltativamente, immettere i dettagli sulle modifiche e quindi selezionare Crea richiesta pull.
Assegnare i revisori e aggiungere commenti per discutere le modifiche, se necessario.
Più ambienti di pre-produzione possono coesistere contemporaneamente quando si usa App Web statiche di Azure. Ogni volta che si crea una richiesta pull nel ramo watched, una versione di staging con le modifiche viene distribuita in un ambiente di pre-produzione distinto.
È possibile apportare più modifiche ed eseguire il push di nuovi commit nel ramo. La richiesta pull viene aggiornata automaticamente per riflettere tutte le modifiche.
Verificare le modifiche
Il flusso di lavoro di distribuzione di GitHub Actions viene eseguito e distribuisce le modifiche delle richieste pull in un ambiente di pre-produzione.
Al termine della compilazione e della distribuzione dell'app, il bot GitHub aggiunge un commento alla richiesta pull, che contiene l'URL dell'ambiente di pre-produzione.
Selezionare l'URL di pre-produzione per visualizzare le modifiche di staging.
L'URL è composto come segue:
https://<SUBDOMAIN-PULL_REQUEST_ID>.<AZURE_REGION>.azurestaticapps.net
. Per una determinata richiesta pull, l'URL rimane invariato, anche se si esegue il push di nuovi aggiornamenti. Lo stesso ambiente di pre-produzione viene riutilizzato anche per la durata della richiesta pull.
Per automatizzare il processo di revisione con test end-to-end, GitHub Action per la distribuzione di App Web statiche di Azure ha la static_web_app_url
variabile di output.
È possibile fare riferimento a questo URL nel resto del flusso di lavoro per eseguire i test nell'ambiente di pre-produzione.
Pubblicare modifiche
Unire la richiesta pull da pubblicare nell'ambiente di produzione.
Selezionare Merge pull request (Unisci la richiesta pull).
Le modifiche vengono copiate nel ramo rilevato (ramo di produzione). Il flusso di lavoro di distribuzione viene quindi avviato nel ramo monitorato e le modifiche diventano attive dopo la ricompilazione dell'applicazione.
Aprire l'URL di produzione per caricare la versione live del sito Web e verificare.
Limiti
Chiunque può accedere alle versioni di staging dell'applicazione tramite l'URL, anche se il repository GitHub è privato.
Avviso
Prestare attenzione al contenuto sensibile, poiché chiunque può accedere agli ambienti di pre-produzione.
Il numero di ambienti di pre-produzione disponibili per ogni app distribuita con App Web statiche dipende dal piano di hosting. Ad esempio, con il livello Gratuito è possibile avere tre ambienti di pre-produzione insieme all'ambiente di produzione.
Gli ambienti di pre-produzione non sono distribuiti geograficamente.
Solo le distribuzioni di GitHub Actions supportano gli ambienti di pre-produzione.