Pubblicare l'API con GitHub Actions

  • 3 minuti

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 è in ascolto del ramo principale del repository per i commit e le richieste pull. Quando GitHub Actions rileva le modifiche, compila e pubblica l'app.

Quando è stata creata la risorsa App Web statiche di Azure, è stato specificato il percorso della cartella per il progetto API accettando il valore predefinito 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. Quando le modifiche vengono rilevate nel ramo principale , attiva GitHub Action per pubblicare l'app nello stesso URL per il sito Web live.

Ambienti di preproduzione 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 ambienti di preproduzione con un URL di anteprima specifico. È possibile creare un ambiente di preproduzione creando una richiesta pull sul ramo monitorato da GitHub Action. Il sito Web live non è interessato. Viene invece creata una nuova versione dell'app nel proprio ambiente di preproduzione. Se si torna indietro e si controlla la richiesta pull in GitHub, si nota che nella scheda Conversazione viene pubblicato un collegamento alla versione di preproduzione.

La tabella seguente illustra come App Web statiche di Azure pubblica 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. Questi URL generati automaticamente vengono forniti da App Web statiche di Azure 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. Si effettua una richiesta pull dal ramo api al ramo main . Quando si crea la richiesta pull nel ramo principale , GitHub Action pubblica l'app in un ambiente di preproduzione.

Al termine della compilazione e della distribuzione dell'app, il bot GitHub aggiunge un commento alla richiesta pull. Questo commento contiene un collegamento all'URL dell'ambiente di preproduzione. È possibile selezionare questo collegamento per visualizzare le modifiche a fasi.

Successivamente, crei una richiesta pull e visiti la versione di gestione temporanea dell'app.