Guida introduttiva: Creare una connessione al servizio in App Azure Container con l'interfaccia della riga di comando di Azure

Articolo
10/31/2023

Questo argomento di avvio rapido illustra come connettere App Contenitore di Azure ad altre risorse cloud usando l'interfaccia della riga di comando di Azure e il Connessione or del servizio. Service Connessione or consente di connettere rapidamente i servizi di calcolo ai servizi cloud, gestendo al contempo le impostazioni di autenticazione e rete della connessione.

Importante

Il Connessione or del servizio 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 da Service Connessione or. Se non è disponibile, 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 con l'interfaccia della riga di comando di Azure.
- Quando richiesto, installare l'estensione dell'interfaccia della riga di comando di Azure al primo uso. 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 installarlo, eseguire az extension add --name containerapp.

Configurazione iniziale

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 -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, service Connessione or è già stato registrato.
Facoltativamente, eseguire il comando az containerapp connection list-support-types per ottenere un elenco dei servizi di destinazione supportati per le app contenitore.
```
az containerapp connection list-support-types --output table
```

Creare una connessione al servizio

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

Chiave di accesso
Identità gestita

Eseguire il az containerapp connection create comando 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 si usa 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 un nuovo Archiviazione BLOB e connetterlo direttamente all'app contenitore usando un stringa di connessione.

Importante

Per usare un'identità gestita, è necessario disporre dell'autorizzazione per modificare l'assegnazione di ruolo Microsoft Entra. Senza questa autorizzazione, la creazione della connessione avrà esito negativo. Chiedere al proprietario della sottoscrizione di concedere questa autorizzazione o usare invece una chiave di accesso per creare la connessione.

Eseguire il az containerapp connection create comando 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 si usa 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 un nuovo Archiviazione BLOB e connetterlo direttamente all'app contenitore usando un'identità gestita.

Visualizzare le connessioni

Usare il comando dell'interfaccia della riga di comando az containerapp connection list di Azure 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 Connessione or del servizio

Share via