Avvio rapido: creare una connessione al servizio in Azure Spring Apps con l’interfaccia della riga di comando di Azure

Questo avvio rapido illustra come connettere Azure Spring Apps ad altre risorse cloud usando l’interfaccia della riga di comando di Azure e il connettore di servizi.

Il connettore di servizi consente di connettere rapidamente servizi di calcolo a servizi cloud, gestendo al contempo le impostazioni di autenticazione e rete della connessione.

Prerequisiti

• Una sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.

• Almeno un’applicazione ospitata da Azure Spring Apps in un’area supportata dal connettore di servizi. Se non è disponibile, distribuire la prima applicazione in Azure Spring Apps.

• Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido su Bash in Azure Cloud Shell.

  

• Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.

  • Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere tramite l'interfaccia della riga di comando di Azure.

  • Quando richiesto, al primo utilizzo installare l'estensione dell'interfaccia della riga di comando di Azure. Per altre informazioni sulle estensioni, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure.

  • Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.

• Versione 2.37.0 o successiva dell'interfaccia della riga di comando di Azure. Per eseguire l’aggiornamento alla versione più recente, eseguire az upgrade. Se si usa Azure Cloud Shell, la versione più recente è già installata.

• L’estensione Azure Spring Apps deve essere installata nell’interfaccia della riga di comando di Azure o in Cloud Shell. Per installarlo, eseguire az extension add --name spring.

Configurazione iniziale

1. Se si usa il connettore di servizi per la prima volta, iniziare eseguendo il comando az provider register per registrare il provider di risorse di del connettore di servizi.

   az provider register -n Microsoft.ServiceLinker
   

   Suggerimento

   È possibile verificare se il provider di risorse è già stato registrato eseguendo il comando az provider show -n "Microsoft.ServiceLinker" --query registrationState. Se l’output è Registered, il connettore di servizi è già stato registrato.

2. Facoltativamente, eseguire il comando az spring connection list-support-types per ottenere un elenco dei servizi di destinazione supportati per Azure Spring Apps.

   az spring connection list-support-types --output table
   

   Suggerimento

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

Creare una connessione al servizio

Creare una connessione da Azure Spring Apps usando un’identità gestita o una chiave di accesso.

Identità gestita

Importante

Per usare un’identità gestita, è necessario disporre dell’autorizzazione per modificare le assegnazioni di ruolo in Microsoft Entra ID. Senza questa autorizzazione, la creazione della connessione avrà esito negativo. Chiedere al proprietario della sottoscrizione di concedere un’autorizzazione di assegnazione di ruolo oppure usare una chiave di accesso per creare la connessione.

1. Eseguire il comando az spring connection create per creare una connessione al servizio a un archiviazione BLOB con un’identità gestita assegnata dal sistema

2. Specificare le informazioni seguenti nella richiesta dell’interfaccia della riga di comando o di Cloud Shell:

   az spring connection create storage-blob --system-identity
   

   Impostazione	Descrizione
   The resource group which contains the spring-cloud	Nome del gruppo di risorse che contiene un'app ospitata da Azure Spring Apps.
   Name of the spring-cloud service	Nome della risorsa di Azure Spring Apps.
   Name of the spring-cloud app	Nome dell'applicazione ospitata da Azure Spring Apps che si connette al servizio di destinazione.
   The resource group which contains the storage account	Nome del gruppo di risorse con l’account di archiviazione.
   Name of the storage account	Nome dell’account di archiviazione a cui connettersi. In questa guida verrà usata un’archiviazione BLOB.

Suggerimento

Se non si dispone di un’archiviazione BLOB, è possibile eseguire az spring connection create storage-blob --new --system-identity per effettuare il provisioning di una nuova risorsa di archiviazione BLOB e connetterla direttamente all'applicazione ospitata da Azure Spring Apps usando un'identità gestita.

Chiave di accesso

Avviso

Microsoft consiglia di usare il flusso di autenticazione più sicuro disponibile. Il flusso di autenticazione descritto in questa procedura richiede un livello di attendibilità molto elevato nell'applicazione e comporta rischi che non sono presenti in altri flussi. Si consiglia di usare questo flusso solo quando altri flussi più sicuri, come le identità gestite, non sono validi.

1. Eseguire il comando az spring connection create per creare una connessione al servizio tra Azure Spring Apps e un’Archiviazione BLOB di Azure usando una chiave di accesso.

   az spring connection create storage-blob --secret
   

2. Specificare le informazioni seguenti nella richiesta dell’interfaccia della riga di comando o di Cloud Shell:

   Impostazione	Descrizione
   The resource group which contains the spring-cloud	Nome del gruppo di risorse che contiene l'app ospitata da Azure Spring Apps.
   Name of the spring-cloud service	Nome della risorsa di Azure Spring Apps.
   Name of the spring-cloud app	Nome dell'applicazione ospitata da Azure Spring Apps che si connette al servizio di destinazione.
   The resource group which contains the storage account	Nome del gruppo di risorse con l’account di archiviazione.
   Name of the storage account	Nome dell’account di archiviazione a cui connettersi. In questa guida verrà usata un’archiviazione BLOB.

Suggerimento

Se non si dispone di un’archiviazione BLOB, è possibile eseguire az spring connection create storage-blob --new --secret per effettuare il provisioning di una nuova risorsa di archiviazione BLOB e connetterla direttamente all'applicazione ospitata da Azure Spring Apps usando una stringa di connessione.

Visualizzare le connessioni

Eseguire az spring connection list comando per elencare tutte le connessioni con provisioning di Azure Spring Apps.

Sostituire i segnaposto <azure-spring-apps-resource-group>, <azure-spring-apps-name>e <app-name> dal comando seguente con il nome del gruppo di risorse di Azure Spring Apps, il nome della risorsa di Azure Spring Apps e il nome dell'applicazione. È anche possibile rimuovere l'opzione --output table per visualizzare altre informazioni sulle connessioni.

az spring connection list --resource-group <azure-spring-apps-resource-group> --service <azure-spring-apps-name> --app <app-name>--output table

L’output visualizza anche lo stato di provisioning delle connessioni: non riuscito o riuscito.

Passaggi successivi

Per altre informazioni sul connettore di servizi e Azure Spring Apps, vedere le guide seguenti.

Esercitazione: Azure Spring Apps + MySQL

Esercitazione: Azure Spring Apps + Apache Kafka in Confluent Cloud