Guida introduttiva: Integrare Azure Spring Apps con Database di Azure per MySQL

Nota

Azure Spring Apps è il nuovo nome del servizio Azure Spring Cloud. Anche se il servizio ha un nuovo nome, il nome precedente verrà visualizzato in alcune posizioni per un po' mentre si lavora per aggiornare gli asset, ad esempio screenshot, video e diagrammi.

Questo articolo si applica a: ✔️ Basic/Standard ❌ Enterprise

Pet Clinic, come distribuito nella guida introduttiva alla configurazione predefinita: Compilare e distribuire app in Azure Spring Apps, usa un database in memoria (HSQLDB) popolato con i dati all'avvio. Questa guida introduttiva illustra come effettuare il provisioning e preparare un'istanza di Database di Azure per MySQL e quindi configurare Pet Clinic in Azure Spring Apps per usarla come database permanente.

Prerequisiti

Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.

Creare un'istanza di Database di Azure per MySQL

Creare un server flessibile Database di Azure per MySQL usando il comando az mysql flexible-server create. Sostituire i segnaposto <database-name>, <MySQL-flexible-server-name><resource-group-name>, , <admin-username>e <admin-password> con un nome per il nuovo database, il nome del gruppo di risorse, un nome per il nuovo server e un nome utente e una password amministratore. Usare virgolette singole intorno al valore per admin-password.

az mysql flexible-server create \
    --resource-group <resource-group-name> \
    --name <MySQL-flexible-server-name> \
    --database-name <database-name> \
    --public-access 0.0.0.0 \
    --admin-user <admin-username> \
    --admin-password '<admin-password>'

Nota

Lo Standard_B1ms SKU viene usato per impostazione predefinita. Per informazioni dettagliate sui prezzi, vedere Database di Azure per MySQL prezzi.

Suggerimento

La password deve contenere almeno otto caratteri e contenere almeno una lettera maiuscola inglese, una lettera minuscola, un numero e un carattere non alfanumerico (!, $, #, %e così via).

Connessione'applicazione al database MySQL

Usare Service Connessione or per connettere l'app ospitata in Azure Spring Apps al database MySQL.

Nota

La funzionalità di associazione del servizio in Azure Spring Apps è deprecata a favore di Service Connessione or.

Interfaccia della riga di comando di Azure

1. Se si usa Service Connessione or per la prima volta, iniziare eseguendo il comando az provider register per registrare il provider di risorse service Connessione or.

   az provider register --namespace Microsoft.ServiceLinker
   

2. Eseguire il az spring connection create comando per creare una connessione al servizio tra l'app customers-service e il database MySQL di Azure. Sostituire i segnaposto per le impostazioni seguenti con le proprie informazioni. Usare virgolette singole intorno al valore per il server secretMySQL.

   Impostazione	Descrizione
   --connection	Nome della connessione che identifica la connessione tra l'app e il servizio di destinazione.
   --resource-group	Nome del gruppo di risorse che contiene l'app ospitata da Azure Spring Apps.
   --service	Nome della risorsa di Azure Spring Apps.
   --app	Nome dell'applicazione ospitata da Azure Spring Apps che si connette al servizio di destinazione.
   --target-resource-group	Nome del gruppo di risorse con l'account di archiviazione.
   --server	Il server MySQL a cui si vuole connettersi
   --database	Nome del database creato in precedenza.
   --secret name= secret=	Nome utente e password del server MySQL.

   az spring connection create mysql-flexible \
       --resource-group <Azure-Spring-Apps-resource-group-name> \
       --service <Azure-Spring-Apps-resource-name> \
       --app customers-service \
       --connection <mysql-connection-name-for-app> \
       --target-resource-group <mySQL-server-resource-group> \
       --server <server-name> \
       --database <database-name> \
       --secret name=<username> secret='<secret>'
   

   Suggerimento

   Se il az spring comando non è riconosciuto dal sistema, verificare di aver installato l'estensione Azure Spring Apps eseguendo az extension add --name spring.

Azure portal

1. Nella portale di Azure digitare il nome dell'istanza di Azure Spring Apps nella casella di ricerca nella parte superiore della schermata e selezionare l'istanza.

2. In Impostazioni selezionare App e quindi selezionare l'applicazione customers-service dall'elenco.

3. Selezionare Service Connessione or (Service Connessione or) nel sommario a sinistra e selezionare Crea.

   

4. Selezionare o immettere le impostazioni seguenti nella tabella.

   Impostazione	Esempio	Descrizione
   Tipo di servizio	Server flessibile del database per MySQL	Selezionare il server flessibile db per MySQL come servizio di destinazione
   Nome connessione	mysql_9e8af	Nome della connessione che identifica la connessione tra l'app e il servizio di destinazione. Usare il nome di connessione fornito da Service Connessione or o immettere il proprio nome di connessione.
   Abbonamento	Sottoscrizione personale	Sottoscrizione che contiene il servizio di destinazione. Il valore predefinito è la sottoscrizione che contiene l'app distribuita in Azure Spring Apps.
   Server flessibile MySQL	MySQL80	Selezionare il server flessibile MySQL a cui connettersi.
   Database MySQL	petclinico	Selezionare il database creato in precedenza.
   Tipo di client	SpringBoot	Selezionare lo stack di applicazioni che funziona con il servizio di destinazione selezionato.

   

5. Selezionare Avanti: Autenticazione per selezionare il tipo di autenticazione. Selezionare quindi Connessione stringa > Database credentials (Credenziali database) e immettere il nome utente e la password del database.

6. Selezionare Avanti: Rete per selezionare la configurazione di rete e selezionare Configura regole del firewall per abilitare l'accesso al servizio di destinazione. Immettere il nome utente e la password in modo che l'app possa raggiungere il database.

7. Selezionare Avanti: Rivedi e crea per esaminare le informazioni fornite. Attendere alcuni secondi prima che Service Connessione or convaliderà le informazioni e selezionare Crea per creare la connessione al servizio.

Ripetere questi passaggi per creare connessioni per le customers-serviceapplicazioni , vets-servicee visits-service .

Controllare la connessione al database MySQL

Interfaccia della riga di comando di Azure

Eseguire il az spring connection validate comando per visualizzare lo stato della connessione tra l'app customers-service e il database MySQL di Azure. Sostituire i segnaposto con informazioni personalizzate.

az spring connection validate \
    --resource-group <Azure-Spring-Apps-resource-group-name> \
    --service <Azure-Spring-Apps-resource-name> \
    --app customers-service \
    --connection <mysql-connection-name-for-app> \
    --output table

Verrà visualizzato l'output seguente:

Name                                  Result    Description
------------------------------------  --------  -------------
Target resource existence validated.  success
Target service firewall validated.    success
Username and password validated.      success

Suggerimento

Per ottenere altri dettagli sulla connessione tra i servizi, rimuovere --output table dal comando precedente.

Azure portal

Le connessioni di Azure Spring Apps vengono visualizzate in Impostazioni Service Connessione > or. Selezionare Convalida per controllare lo stato della connessione e selezionare Altre informazioni per esaminare i dettagli di convalida della connessione.

Ripetere queste istruzioni per convalidare le connessioni per le customers-serviceapplicazioni , vets-servicee visits-service .

Aggiornare le app per l'uso del profilo MySQL

La sezione seguente illustra come aggiornare le app per connettersi al database MySQL.

Interfaccia della riga di comando di Azure

Usare il comando seguente per impostare una variabile di ambiente per attivare il mysql profilo per l'app customers-service :

az spring app update \
    --resource-group <Azure-Spring-Apps-resource-group-name> \
    --service <Azure-Spring-Apps-resource-name> \
    --name customers-service \
    --env SPRING_PROFILES_ACTIVE=mysql

Azure portal

Usare la procedura seguente per impostare una variabile di ambiente per attivare il mysql profilo per l'app customers-service :

1. Passare alla pagina di panoramica dell'istanza di Azure Spring Apps, selezionare App dal menu di spostamento e quindi selezionare l'applicazione di servizio clienti dall'elenco.

2. Nella pagina Panoramica del servizio clienti selezionare Configurazione dal menu di spostamento.

3. Nella pagina Configurazione selezionare Variabili di ambiente. Immettere SPRING_PROFILES_ACTIVE per Chiave, immettere mysql per Valore e quindi selezionare Salva.

   

Ripetere queste istruzioni per aggiornare la configurazione dell'app per le customers-serviceapplicazioni , vets-servicee visits-service .

Convalidare le app

Per convalidare il servizio Pet Clinic e per eseguire query sui record dal database MySQL per confermare la connessione al database, seguire le istruzioni nella sezione Verificare i servizi di Avvio rapido: Creare e distribuire app in Azure Spring Apps.

Pulire le risorse

Se si prevede di usare le guide di avvio rapido e le esercitazioni successive, è consigliabile non cancellare le risorse create. Quando non è più necessario, eliminare il gruppo di risorse usando il comando az group delete , che elimina le risorse nel gruppo di risorse. Sostituire <resource-group> con il nome del gruppo di risorse.

az group delete --name <resource-group>

Passaggi successivi

• Associare un'istanza di Database di Azure per MySQL all'applicazione in Azure Spring Apps
• Usare un'identità gestita per connettere database SQL di Azure a un'app in Azure Spring Apps