Guida introduttiva: Creare una connessione al servizio in App Azure Container con l'interfaccia della riga di comando di Azure (anteprima)
Questo argomento di avvio rapido illustra come connettere App Azure Container ad altre risorse cloud usando l'interfaccia della riga di comando di Azure e Il connettore di servizi (anteprima). 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 attiva. Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.
Almeno un'applicazione distribuita in App Azure Container in un'area supportata da Service Connector. Se non si dispone di una, creare e distribuire un contenitore in App contenitore.
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.
È necessario installare la 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 App contenitore deve essere installata nell’interfaccia della riga di comando di Azure o in Cloud Shell. Per installarla, eseguire
az extension add --name containerapp
.
Configurazione dell'ambiente
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.Facoltativamente, eseguire il comando az containerapp connection list-support-types per ottenere un elenco dei servizi di destinazione supportati per App contenitore.
az containerapp connection list-support-types --output table
Creare una connessione al servizio (anteprima)
Creare una connessione usando un’identità gestita o una chiave di accesso.
Importante
Per usare un’identità gestita, è necessario disporre dell’autorizzazione per modificare l’assegnazione di ruolo di Microsoft Entra. Chiedere al proprietario della sottoscrizione di concedere questa autorizzazione oppure usare una chiave di accesso per creare la connessione.
Eseguire il comando
az containerapp connection create
per creare una connessione al servizio da App contenitore a un archiviazione BLOB con un’identità gestita assegnata dal sistema.az containerapp connection create storage-blob --system-identity
Specificare le informazioni seguenti nella richiesta dell’interfaccia della riga di comando di Azure:
Impostazione Descrizione The resource group that contains the container app
Nome del gruppo di risorse con l’app contenitore. Name of the container app
Nome dell’app contenitore. The container where the connection information will be saved
Nome del contenitore dell’app contenitore. 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.
Nota
Se non si dispone di un’archiviazione BLOB, è possibile eseguire az containerapp connection create storage-blob --new --system-identity
per effettuare il provisioning di una nuova risorsa di archiviazione BLOB e connetterla direttamente all’app contenitore usando un’identità gestita.
Visualizzare le connessioni
Usare il comando dell’interfaccia della riga di comando di Azure az containerapp connection list
per elencare tutte le connessioni con provisioning dell’app contenitore. Sostituire i segnaposto <container-app-resource-group>
e <container-app-name>
dal comando seguente con il gruppo di risorse e il nome dell’app contenitore. È anche possibile rimuovere l'opzione --output table
per visualizzare altre informazioni sulle connessioni.
az containerapp connection list -g "<container-app-resource-group>" --name "<container-app-name>" --output table
L’output visualizza anche lo stato di provisioning delle connessioni: non riuscito o riuscito.