Esercitazione: Compilare un'app PHP (Laravel) e un'istanza del server flessibile di Database di Azure per MySQL nel Servizio app di Azure

Il Servizio app di Azure offre un servizio di hosting Web con scalabilità elevata e applicazione automatica di patch basato sul sistema operativo Linux. Questa esercitazione illustra come creare un'app PHP sicura nel servizio app di Azure connessa a un database MySQL (usando il server flessibile di Database di Azure per MySQL). Al termine, sarà disponibile un'app Laravel in esecuzione nel Servizio app di Azure in Linux.

In questa esercitazione verranno illustrate le procedure per:

• Creare un'app PHP e MySQL protetta per impostazione predefinita in Azure
• Configurare i segreti per la connessione a MySQL usando le impostazioni dell'app
• Distribuire il codice dell'applicazione usando GitHub Actions
• Aggiornare e ridistribuire l'app
• Eseguire migrazioni di database in modo sicuro
• Eseguire lo streaming dei log di diagnostica in Azure
• Gestire l'app nel portale di Azure

Prerequisiti

• Una sottoscrizione di Azure Se non si ha una sottoscrizione di Azure, creare un account gratuito di Azure prima di iniziare. Attualmente, con un account gratuito di Azure, è possibile provare il server flessibile di Database MySQL di Azure gratuitamente per 12 mesi. Per altre informazioni, vedere Usare un account gratuito di Azure per provare gratuitamente Database di Azure per MySQL - Server flessibile.

Applicazione di esempio

Per seguire questa esercitazione, clonare o scaricare l'applicazione di esempio dal repository:

git clone https://github.com/Azure-Samples/laravel-tasks.git

Per eseguire l'applicazione in locale, procedere nel modo seguente:

• In .env configurare le impostazioni del database (ad esempio DB_DATABASE, DB_USERNAME e DB_PASSWORD) usando le impostazioni nel database del server flessibile di Database di Azure per MySQL locale. Per eseguire questo esempio, è necessaria un'istanza locale del server flessibile di Database di Azure per MySQL.

• Dalla radice del repository avviare Laravel con i comandi seguenti:

  composer install
  php artisan migrate
  php artisan key:generate
  php artisan serve
  

1 - Crea le risorse App Service e Database di Azure per MySQL Flexible Server

In questo passaggio si creano le risorse di Azure. I passaggi usati in questa esercitazione consentono di creare una configurazione del server flessibile del servizio app e del database di Azure per MySQL sicura per impostazione predefinita. Per il processo di creazione, specificare:

• Nome dell'app Web. È il nome usato come parte del nome DNS per l'app Web sotto forma di https://<app-name>.azurewebsites.net.
• Runtime per l'app. È qui che si seleziona la versione di PHP da usare per l'app.
• Gruppo di risorse per l'app. Un gruppo di risorse consente di raggruppare (in un contenitore logico) tutte le risorse di Azure necessarie per l'applicazione.

Per creare risorse del Servizio app di Azure, accedere al portale di Azure e seguire questa procedura.

Istruzioni	Schermata
Nel portale di Azure: Immettere "database dell'app Web" nella barra di ricerca nella parte superiore del portale di Azure. Selezionare l'elemento con etichetta App Web e database sotto l'intestazione Marketplace. È anche possibile passare direttamente alla creazione guidata.
Nella pagina Crea app Web e database compilare il modulo come indicato di seguito. Gruppo di risorse → Selezionare Crea nuovo e usare un nome di msdocs-laravel-mysql-tutorial. Area → Qualunque area di Azure nelle vicinanze. Nome → msdocs-laravel-mysql-XYZ dove XYZ è costituito da tre caratteri casuali. Il nome deve essere univoco in Azure Stack di runtime → PHP 8.0. MySQL - Server flessibile è selezionato per impostazione predefinita come motore di database. Database di Azure per MySQL è un database MySQL completamente gestito come servizio in Azure, compatibile con le edizioni community più recenti. Prendere nota del nome del database generato automaticamente (<app-name>-database). Sarà necessario più avanti. Selezionare Rivedi e crea. Al termine della convalida selezionare Crea.
Il completamento della distribuzione richiede alcuni minuti e crea le risorse seguenti: Gruppo di risorse: contenitore per tutte le risorse create. Piano di servizio app: definisce le risorse di calcolo per il Servizio app. Viene creato un piano Linux nel livello P1v2. Servizio app: rappresenta l'app ed è in esecuzione nel piano di Servizio app. Rete virtuale: è integrata con l'app del Servizio app e isola il traffico di rete back-end. Server flessibile di Database di Azure per MySQL → Accessibile solo dalla rete virtuale. Vengono automaticamente creati un database e un utente nel server. Zona DNS privato → Abilita la risoluzione DNS del server di database MySQL nella rete virtuale. Al termine della distribuzione, selezionare il pulsante Vai alla risorsa. Si verrà reindirizzati direttamente all'app del servizio app.

2 - Configurare la connettività del database

La creazione guidata ha generato le impostazioni dell'app da usare per connettersi al database, ma non in un formato ancora utilizzabile per il codice. In questo passaggio si modificano e si aggiornano le impostazioni dell'app in base al formato necessario per l'app.

Istruzioni	Schermata
Nel menu a sinistra della pagina del servizio app selezionare Configurazione.
Nella scheda Impostazioni applicazione della pagina Configurazione selezionare Modifica, aggiornare il campo Nome con i nuovi valori e selezionare OK per ognuna delle impostazioni seguenti. Nome corrente Nuovo nome AZURE_MYSQL_DBNAME DB_DATABASE AZURE_MYSQL_HOST DB_HOST AZURE_MYSQL_USERNAME DB_USERNAME AZURE_MYSQL_PASSWORD DB_PASSWORD
Creare una nuova impostazione del database MYSQL_ATTR_SSL_CA: Selezionare Nuova impostazione applicazione. Nel campo Nome immettere MYSQL_ATTR_SSL_CA. Nel campo Valore immettere /home/site/wwwroot/ssl/DigiCertGlobalRootG2.crt.pem. Questa impostazione dell'app punta al percorso del certificato TLS/SSL necessario per accedere al server MySQL. È incluso nel repository di esempio per praticità. Selezionare OK.
Creare le impostazioni aggiuntive seguenti per l'app seguendo la stessa procedura e quindi selezionare Salva. APP_DEBUG: usare true come valore. Si tratta di una variabile di debug Laravel. APP_KEY: usare base64:Dsz40HWwbCqnq0oxMsjq7fItmKIeBfCBGORfspaI1Kw= come valore. Si tratta di una variabile di crittografia Laravel. Importante Il valore APP_KEY viene usato qui per praticità. Per gli scenari di produzione, deve essere generato in modo specifico per la distribuzione usando php artisan key:generate --show nella riga di comando.

3 - Distribuire il codice di esempio

In questo passaggio si configurerà la distribuzione di GitHub usando GitHub Actions. È solo uno dei molti modi per eseguire la distribuzione nel servizio app, ma anche un ottimo modo per avere l'integrazione continua nel processo di distribuzione. Per impostazione predefinita, ogni git push al repository GitHub avvia l'azione di compilazione e distribuzione. Sarà necessario apportare alcune modifiche alla codebase con Visual Studio Code direttamente nel browser, quindi consentire la distribuzione automatica di GitHub Actions.

Istruzioni	Schermata
In una nuova finestra del browser: Accedi all'account GitHub. Accedere a https://github.com/Azure-Samples/laravel-tasks. Selezionare Fork. Selezionare Crea fork.
Nella pagina GitHub aprire Visual Studio Code nel browser premendo il tasto ..
In Visual Studio Code nel browser aprire config/database.php nell'elenco delle cartelle. Nella connessione mysql verificare che le impostazioni dell'app create in precedenza per la connessione MySQL siano già in uso (DB_HOST, DB_DATABASE, DB_USERNAME, DB_PASSWORD, MYSQL_ATTR_SSL_CA).
Tornare alla pagina del servizio app e nel menu a sinistra selezionare Centro distribuzione.
Nella pagina Centro distribuzione: In Origine, selezionare GitHub. Per impostazione predefinita, GitHub Actions è selezionato come provider di compilazione. Accedere all'account GitHub e seguire la richiesta di autorizzare Azure. In Organizzazione selezionare l'account. In Repository, selezionare laravel-tasks. Per Ramo selezionare principale. Nel menu in alto, selezionare Salva. Il Servizio app esegue il commit di un file del flusso di lavoro nella directory .github/workflows del repository GitHub selezionato.
Nella pagina Centro distribuzione: Selezionare Log. È già stata avviata l’esecuzione di una distribuzione. Nell’elemento di log per l'esecuzione della distribuzione selezionare Compila/Distribuisci log. Si viene reindirizzati al repository GitHub dove si noterà che l'azione GitHub è in esecuzione. Il file del flusso di lavoro definisce due fasi separate, compilare e distribuire.
Per apportare modifiche al codice, passare al browser di Visual Studio Code: Selezionare l'estensione Controllo del codice sorgente. Accanto al file modificato, ad esempio database.php, selezionare + per preparare le modifiche. Nella casella di testo digitare un messaggio di commit, ad esempio add certificate. Selezionare il segno di spunta per eseguire il commit e il push in GitHub. Se si torna alla pagina Centro distribuzione, si noterà una nuova voce di log perché è stata avviata un'altra esecuzione. Attendere il completamento dell'esecuzione. Sono necessari circa 15 minuti. Suggerimento L'azione di GitHub è definita dal file nel repository GitHub, in .github/workflow. È possibile velocizzare l'operazione personalizzando il file.

4 - Generare lo schema del database

La procedura di creazione guidata inserisce l'istanza del server flessibile del Database di Azure per MySQL dietro un endpoint privato, che è quindi accessibile solo dalla rete virtuale. Poiché l'app del servizio app è già integrata con la rete virtuale, il modo più semplice per eseguire le migrazioni di database con il proprio database è direttamente dall'interno del contenitore del servizio app.

Istruzioni	Schermata
Nella pagina del servizio app: Nel menu a sinistra selezionare SSH. Selezionare Vai. Nel browser viene aperta una sessione SSH con il contenitore del servizio app. In alternativa, è possibile passare direttamente a https://<app-name>.scm.azurewebsites.net/webssh/host.
Nel terminale SSH: CD nella radice del codice dell'applicazione: cd /home/site/wwwroot Eseguire le migrazioni di database dalla radice dell'applicazione. php artisan migrate --force Note Solo le modifiche apportate ai file in /home possono essere mantenute dopo i riavvii dell'app. Le modifiche esterne a /home non sono persistenti.

5 - Modificare la radice del sito

Il ciclo di vita dell'applicazione Laravel inizia invece nella directory /public. Il contenitore PHP 8.0 predefinito per il servizio app usa Nginx, che si avvia nella directory radice dell'applicazione. Per modificare la radice del sito, è necessario modificare il file di configurazione Nginx nel contenitore PHP 8.0 (/etc/nginx/sites-available/default). Per praticità, il repository di esempio contiene un file di configurazione personalizzato denominato impostazione predefinita. Come indicato in precedenza, non è opportuno sostituire questo file usando la shell SSH, perché le modifiche andranno perse dopo il riavvio dell'app.

Istruzioni	Schermata
Nella pagina del servizio app: Nel menu a sinistra selezionare Configurazione. Selezionare la scheda Impostazioni generali.
Nella scheda Impostazioni generali: Nel box Comando di avvio immettere il comando seguente: cp /home/site/wwwroot/default /etc/nginx/sites-available/default && service nginx reload. Sostituisce il file di configurazione Nginx nel contenitore PHP 8.0 e riavvia Nginx. Questa configurazione garantisce che questa modifica venga apportata al contenitore ogni volta che viene avviata. Selezionare Salva.

6 - Passare all'app

Istruzioni	Schermata
Nella pagina del servizio app: Nel menu a sinistra selezionare Panoramica. Selezionare l'URL dell'app. È anche possibile passare direttamente a https://<app-name>.azurewebsites.net.
Aggiungere alcune attività all'elenco. Congratulazioni, si sta eseguendo un'app PHP guidata dai dati nel Servizio app di Azure.

7 - Trasmettere i log di diagnostica

Istruzioni	Schermata
Nella pagina del servizio app: Nel menu a sinistra, selezionare Log di Servizio app. In Registrazione applicazione selezionare File System.
Nel menu a sinistra selezionare Flusso di log. Vengono visualizzati i log per l'app, inclusi i log della piattaforma e i log dall'interno del contenitore.

Pulire le risorse

Al termine, è possibile eliminare tutte le risorse dalla sottoscrizione di Azure eliminando il gruppo di risorse.

Istruzioni	Schermata
Nella barra di ricerca nella parte superiore del portale di Azure: Immettere il nome del gruppo di risorse. Selezionare il gruppo di risorse.
Nella pagina del gruppo di risorse selezionare Elimina gruppo di risorse.
Immettere il nome del gruppo di risorse per confermare l'eliminazione. Selezionare Elimina.

Domande frequenti

• Quanto costa questa configurazione?
• Come posso connettermi a un database di Azure Database per MySQL Flexible Server che è protetto dietro una rete virtuale?
• Come funziona lo sviluppo di app locali con GitHub Actions?
• Perché la distribuzione di GitHub Actions è così lenta?

Quanto costa questa configurazione?

I prezzi per le risorse di creazione sono i seguenti:

• Il piano del servizio app viene creato nel livello Premium V2 e può essere aumentato o ridotto. Vedere Prezzi del servizio app.
• L'istanza del server flessibile di Database di Azure per MySQL viene creata nel livello B1ms e può essere ridimensionata o ridotta. Con un account gratuito di Azure, il livello B1ms è gratuito per 12 mesi, fino ai limiti mensili. Vedere prezzi del database di Azure per il server flessibile MySQL.
• La rete virtuale non comporta alcun addebito a meno che non si configurino funzionalità aggiuntive, ad esempio il peering. Vedere Prezzi della rete virtuale di Azure.
• La zona DNS privata comporta un piccolo addebito. Vedere Prezzi di DNS di Azure.

Come ci si connette a un database di Azure Database for MySQL Flexible Server protetto dietro una rete virtuale?

Per connettersi a un database del server flessibile di Database di Azure per MySQL, è possibile usare diversi metodi basati su strumenti e ambienti a disposizione:

• Accesso agli strumenti da riga di comando:
  • Usare il comando mysql dal terminale SSH dell'app per l'accesso di base.
• Strumenti desktop (ad esempio, MySQL Workbench):
  • Uso del tunneling SSH con l'interfaccia della riga di comando di Azure:
    • Creare una sessione SSH per l'app Web usando l'interfaccia della riga di comando di Azure.
    • Usare la sessione SSH per eseguire il tunneling del traffico verso MySQL.
  • Uso della VPN da sito a sito o della macchina virtuale di Azure:
    • Il computer deve far parte della rete virtuale.
    • Valutare l'opportunità di usare:
      • Una macchina virtuale di Azure collegata a una delle subnet.
      • Un computer in una rete locale con una connessione VPN da sito a sito alla rete virtuale di Azure.
• Integrazione di Azure Cloud Shell:
  • Integrazione di Azure Cloud Shell con la rete virtuale per l'accesso diretto.

Come funziona lo sviluppo di app locali con GitHub Actions?

Prendere il file del flusso di lavoro generato automaticamente dal servizio app come esempio, ognigit push avvia una nuova esecuzione di compilazione e distribuzione. Da un clone locale del repository GitHub si effettua il push degli aggiornamenti desiderati in GitHub. Ad esempio:

git add .
git commit -m "<some-message>"
git push origin main

Perché la distribuzione di GitHub Actions è così lenta?

Il file del flusso di lavoro generato automaticamente dal servizio app definisce l'esecuzione di due processi, build-then-deploy. Poiché ogni processo viene eseguito nel proprio ambiente pulito, il file del flusso di lavoro garantisce che il processo deploy abbia accesso ai file dal processo build:

• Al termine del processo build, caricare i file come artefatti.
• All'inizio del processo deploy, scaricare gli artefatti.

La maggior parte del tempo impiegato dal processo a due processi viene impiegato per caricare ed effettuare il download degli artefatti. Se si desidera, è possibile semplificare il file del flusso di lavoro combinando i due processi in uno, eliminando così la necessità di eseguire i passaggi di caricamento e download.

Summary

In questa esercitazione sono state illustrate le procedure per:

• Creare un'app PHP protetta per impostazione predefinita e il server flessibile di Database di Azure per MySQL in Azure
• Configurare i segreti di connessione al server flessibile di Database di Azure per MySQL usando le impostazioni dell'app
• Distribuire il codice dell'applicazione usando GitHub Actions
• Aggiornare e ridistribuire l'app
• Eseguire migrazioni di database in modo sicuro
• Eseguire lo streaming dei log di diagnostica in Azure
• Gestire l'app nel portale di Azure

Contenuti correlati

• Esercitazione: Eseguire il mapping del nome DNS personalizzato all'app
• Come gestire le risorse nel portale di Azure
• Gestire il server flessibile di Database di Azure per MySQL con l'interfaccia della riga di comando di Azure