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

Articolo
05/22/2024

Questo avvio rapido illustra come connettere App contenitore di Azure 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.

Importante

Il connettore di servizi in App contenitore è attualmente in anteprima. Vedere le condizioni per l'utilizzo supplementari per le anteprime di Microsoft Azure per termini legali aggiuntivi che si applicano a funzionalità di Azure in versione beta, in anteprima o in altro modo non ancora disponibili a livello generale.

Prerequisiti

Una sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.
Almeno un’applicazione distribuita in App contenitore in un’area supportata dal connettore di servizi. 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 per 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 iniziale

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

Creare una connessione usando un’identità gestita o una chiave di accesso.

Identità gestita
Chiave di accesso

Importante

Per usare un’identità gestita, è necessario disporre dell’autorizzazione per modificare l’assegnazione di ruolo di Microsoft Entra. Senza questa autorizzazione, la creazione della connessione avrà esito negativo. 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.

Eseguire il comando az containerapp connection create per creare una connessione al servizio tra App contenitore e Archiviazione BLOB di Azure usando una chiave di accesso.
```
az containerapp connection create storage-blob --secret
```

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.

Suggerimento

Se non si dispone di un’archiviazione BLOB, è possibile eseguire az containerapp connection create storage-blob --new --secret per effettuare il provisioning di una nuova risorsa di archiviazione BLOB e connetterla direttamente all’app contenitore usando una stringa di connessione.

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.

Passaggi successivi

Elementi interni del connettore di servizi

Condividi tramite