Pubblicare l'API con GitHub Actions
Hai aggiunto la tua API alla tua app web e stanno entrambe girando localmente. A questo punto, è possibile pubblicare l'API e l'app in App Web statiche di Azure.
Quando hai creato l'istanza di Azure Static Web Apps e le hai chiesto di monitorare il tuo ramo main, è stata generata una GitHub Action per te. 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. Le app Web statiche di Azure hanno compilato e distribuito la app Funzioni di Azure in tale cartella. Tuttavia, l'app non funziona perché l'API HTTP GET non è ancora stata creata.
Attivare l'azione di GitHub
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 tuo sito web live non subisce alcuna conseguenza. 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 pubblica su un URL, mentre una pull request nello stesso ramo viene pubblicata su un URL diverso. Le App Web statiche di Azure forniscono URL generati automaticamente per l'app di produzione e le pull request. 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/ |
Stai attualmente lavorando nel ramo api. Effettui una richiesta di 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. Puoi selezionare questo collegamento per visualizzare le tue modifiche provvisorie.
Successivamente, crea una pull request e visita la versione di staging della tua app.