Pubblicare l'API con GitHub Actions

Completato

L'API è stata aggiunta all'app Web ed entrambe sono in esecuzione in locale. A questo punto, è possibile pubblicare l'API e l'app in App Web statiche di Azure.

Quando è stata creata l'istanza di App Web statiche di Azure ed è stato richiesto di controllare il ramo main, è stato generato un flusso di lavoro di GitHub Actions. GitHub Action resta in ascolto dei commit e delle richieste pull del ramo principale del repository. Quando GitHub Actions rileva le modifiche, compila e pubblica l'app.

Durante la creazione della risorsa di App Web statiche di Azure è stato specificato il percorso del progetto per l'API accettando il valore predefinito di Api. App Web statiche di Azure compilata e distribuita l'app Funzioni di Azure in tale cartella. Tuttavia, l'app non funziona perché l'API HTTP GET non è ancora stata creata.

Attivare GitHub Actions

GitHub Actions è pronto a compilare e pubblicare l'app Web e l'API quando rileva una modifica nel ramo main. È possibile eseguire il commit direttamente o creare una richiesta pull nel ramo main. Entrambe queste modifiche attivano GitHub Action. Le modifiche rilevate nel ramo principale attivano GitHub Action per la pubblicazione dell'app nello stesso URL del sito Web attivo.

Ambienti di pre-produzione con URL di anteprima

In alcuni casi è preferibile visualizzare le modifiche in un sito di staging prima della pubblicazione nel sito Web attivo. App Web statiche di Azure consente di visualizzare le modifiche tramite gli ambienti di pre-produzione, ciascuno con il proprio URL di anteprima. È possibile creare un ambiente di pre-produzione creando una richiesta pull sul ramo monitorato da GitHub Action. Il sito Web live non è interessato. Viene così creata una nuova versione dell'app nel suo ambiente di pre-produzione. Se si torna indietro a controllare la richiesta pull in GitHub, si noterà che nella scheda Conversazione è stato inserito un collegamento alla versione di pre-produzione.

La tabella seguente mostra in che modo App Web statiche di Azure pubblicha l'app in URL diversi. L'app viene pubblicata in un URL, mentre una richiesta pull allo stesso ramo viene pubblicata in un altro URL. App Web statiche di Azure fornisce URL generati automaticamente per l'app di produzione e le richieste pull. Facoltativamente, è possibile assegnare un dominio personalizzato all'app di produzione.

Origine Descrizione URL
Ramo main Esempio di URL di un sito Web attivo https://purple-rain-062d03304.azurestaticapps.net/
Richiesta pull n. 5 Esempio di URL di anteprima https://purple-rain-062d03304-5.<location>.azurestaticapps.net/

Attualmente ci si trova nel ramo api. Effettuare una richiesta pull dal ramo api al ramo principale. Durante la creazione della richiesta pull sul ramo principale, GitHub Action pubblica l'app in un ambiente di pre-produzione.

Quando il flusso di lavoro completa la compilazione e la distribuzione dell'app, il bot GitHub aggiunge un commento alla richiesta pull. Questo commento contiene un collegamento all'URL dell'ambiente di pre-produzione. È possibile selezionare questo collegamento per visualizzare le modifiche preparate per il commit.

Creare quindi una richiesta pull e visitare la versione preparata per il commit dell'app.