Avvio rapido: creare una connessione al servizio nel servizio app con l’interfaccia della riga di comando di Azure

Questo avvio rapido descrive i passaggi per creare una connessione di servizio nel Servizio app di Azure con l’interfaccia della riga di comando di Azure.

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

Prerequisiti

• 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.

• Questa guida introduttiva richiede la versione 2.30.0 o successiva dell'interfaccia della riga di comando di Azure. Se si usa Azure Cloud Shell, la versione più recente è già installata.
• Questo avvio rapido presuppone che sia già in esecuzione almeno un servizio app in Azure. Se non si dispone di un servizio app, crearne uno.

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 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, usare l'interfaccia della riga di comando di Azure comando az webapp connection list-support-types per ottenere un elenco dei servizi di destinazione supportati per il servizio app.

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

Creare una connessione al servizio

Uso di un'identità gestita

Importante

L'uso dell'identità gestita richiede l'autorizzazione per l’assegnazione di ruolo di Microsoft Entra. Senza questa autorizzazione, la creazione di una connessione avrà esito negativo. È possibile chiedere al proprietario della sottoscrizione di concedere questa autorizzazione oppure usare una chiave di accesso per creare la connessione.

Usare l'interfaccia della riga di comando di Azure comando connessione az webapp per creare una connessione al servizio a un'archiviazione BLOB con un'identità gestita assegnata dal sistema, fornendo le informazioni seguenti:

• Nome del gruppo di risorse contenente il servizio app
• Nome del servizio app
• Nome del gruppo di risorse che include l'account di archiviazione
• Nome dell'account di archiviazione

az webapp connection create storage-blob

Nota

Se non si dispone di un archivio BLOB, è possibile eseguire az webapp connection create storage-blob --new --system-identity per effettuare il provisioning di una nuova risorsa di archiviazione BLOB e collegarla direttamente all'istanza del servizio app.

Utilizzo di una 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.

Usare l'interfaccia della riga di comando di Azure crea comando connessione az webapp per creare una connessione al servizio a un'archiviazione BLOB di Azure con una chiave di accesso, fornendo le informazioni seguenti:

• Nome del gruppo di risorse del servizio di calcolo di origine: il nome del gruppo di risorse del servizio app.
• Nome del servizio app: il nome del servizio app che si connette al servizio di destinazione.
• Nome del gruppo di risorse del servizio di destinazione: il nome del gruppo di risorse dell’archiviazione BLOB.
• Nome dell'account di archiviazione: il nome dell'account dell'archiviazione BLOB.

az webapp connection create storage-blob --secret

Suggerimento

Se non si dispone di un archivio BLOB, eseguire az webapp connection create storage-blob --new --secret per effettuare il provisioning e collegarsi direttamente alla risorsa del servizio app.

Visualizzare le connessioni

Eseguire l'interfaccia della riga di comando di Azure az webapp connection per elencare le connessioni al servizio app, fornendo le informazioni seguenti:

• Nome del gruppo di risorse contenente il servizio app
• Nome del servizio app

az webapp connection list -g "<your-app-service-resource-group>" -n "<your-app-service-name>" --output table

Passaggi successivi

Seguire le esercitazioni seguenti per iniziare a creare un'applicazione personalizzata con il connettore di servizi.

Esercitazione: WebApp + Archiviazione con l'interfaccia della riga di comando di Azure

Esercitazione: WebApp + PostgreSQL con l'interfaccia della riga di comando di Azure