Condividi tramite


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

Apportare una modifica

Apportare una modifica al repository direttamente in GitHub, come illustrato nei passaggi seguenti.

  1. Passare al repository del progetto in GitHub e quindi selezionare Ramo.

    Create new branch using GitHub interface

  2. Immettere un nome di ramo e selezionare Crea ramo.

  3. 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.

    Edit file button in GitHub interface

  4. Al termine, selezionare Commit changes (Esegui commit modifiche ).

    Screenshot showing the Commit changes button in the GitHub interface.

Crea una richiesta pull

Creare una richiesta pull per pubblicare l'aggiornamento.

  1. Aprire la scheda Richiesta pull del progetto in GitHub.

    Screenshot showing the pull request tab in a GitHub repo.

  2. Selezionare Confronta e richiesta pull.

  3. Facoltativamente, immettere i dettagli sulle modifiche e quindi selezionare Crea richiesta pull.

    Screenshot showing the pull request creation in GitHub.

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.

  1. Selezionare l'URL di pre-produzione per visualizzare le modifiche di staging.

    Screenshot of pull request comment with the pre-production URL.

    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.

  1. Selezionare Merge pull request (Unisci la richiesta pull).

    Screenshot showing the Merge pull request button in GitHub interface.

    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.

  2. 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.

Passaggi successivi