Démarrage rapide : créer une connexion de service dans Azure Container Apps avec l’interface Azure CLI

Article
10/16/2024

Ce guide de démarrage rapide vous montre comment connecter Azure Container Apps à d’autres ressources cloud à l’aide d’Azure CLI et de Service Connector. Service Connector vous permet de connecter rapidement des services de calcul aux services cloud, tout en gérant les paramètres d’authentification et de mise en réseau de votre connexion.

Important

Le connecteur de services dans Container Apps est actuellement en préversion. Pour connaître les conditions juridiques qui s’appliquent aux fonctionnalités Azure en version bêta, en préversion ou plus généralement non encore en disponibilité générale, consultez l’Avenant aux conditions d’utilisation des préversions de Microsoft Azure.

Prérequis

Un abonnement Azure. Si vous n’avez pas d’abonnement Azure, créez un compte gratuit Azure avant de commencer.
Au moins une application déployée sur Container Apps dans une région prise en charge par Service Connector. Si vous n'en avez pas, créez et déployez un conteneur dans Container Apps.

Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.
Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.
- Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.
- Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.
- Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

La version 2.37.0 ou supérieure de l’Azure CLI doit être installée. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade. Si vous utilisez Azure Cloud Shell, la version la plus récente est déjà installée.
L’extension Container Apps doit être installée dans Azure CLI ou dans le Cloud Shell. Pour l’installer, exécutez az extension add --name containerapp.

Configuration initiale

Si vous utilisez Service Connector pour la première fois, commencez par exécuter la commande az provider register pour inscrire le fournisseur de ressources Service Connector.
```
az provider register -n Microsoft.ServiceLinker
```
Conseil

Vous pouvez vérifier si le fournisseur de ressources a déjà été inscrit en exécutant la commandeaz provider show -n "Microsoft.ServiceLinker" --query registrationState. Si la sortie est Registered, Service Connector a alors déjà été inscrit.
Si vous le souhaitez, exécutez la commande az containerapp connection list-support-types pour obtenir la liste des services cibles pris en charge pour Container Apps.
```
az containerapp connection list-support-types --output table
```

Créer une connexion de service

Créer une connexion à l’aide d’une identité managée ou d’une clé d’accès.

Identité gérée
Clé d’accès

Important

Pour utiliser une identité managée, vous devez avoir l’autorisation de modifier l’attribution des rôles Microsoft Entra. Sans cette autorisation, la création de votre connexion échouera. Demandez au propriétaire de votre abonnement de vous accorder cette autorisation, ou utilisez plutôt une clé d’accès pour créer la connexion.

Exécutez la commande az containerapp connection create pour créer une connexion de service entre Container Apps et un Blob Storage avec une identité gérée attribuée par le système.
```
az containerapp connection create storage-blob --system-identity
```

Fournissez les informations suivantes à la demande d’Azure CLI :

Paramètre	Description
`The resource group that contains the container app`	Le nom du groupe de ressources avec l'application du conteneur.
`Name of the container app`	Le nom de l'application conteneur.
`The container where the connection information will be saved`	Le nom du conteneur de l’application conteneur.
`The resource group which contains the storage account`	Le nom du groupe de ressources avec le compte de stockage.
`Name of the storage account`	Le nom du compte de stockage auquel vous voulez vous connecter. Dans ce guide, nous utilisons un Stockage Blob.

Notes

Si vous n'avez pas de Blob Storage, vous pouvez exécuter 1az containerapp connection create storage-blob --new --system-identitypour provisionner un nouveau Blob Storage et le connecter directement à votre application conteneur en utilisant une identité gérée.

Avertissement

Microsoft vous recommande d’utiliser le flux d’authentification le plus sécurisé disponible. Le flux d'authentification décrit dans cette procédure demande un degré de confiance très élevé dans l'application et comporte des risques qui ne sont pas présents dans d'autres flux. Vous ne devez utiliser ce flux que si d’autres flux plus sécurisés, tels que les identités managées, ne sont pas viables.

Exécutez la commande az containerapp connection create pour créer une connexion de service entre Container Apps et Stockage Blob Azure en tirant parti d’une clé d’accès.
```
az containerapp connection create storage-blob --secret
```

Fournissez les informations suivantes à la demande d’Azure CLI :

Paramètre	Description
`The resource group that contains the container app`	Le nom du groupe de ressources avec l'application du conteneur.
`Name of the container app`	Le nom de l'application conteneur.
`The container where the connection information will be saved`	Le nom du conteneur de l’application conteneur.
`The resource group which contains the storage account`	Le nom du groupe de ressources avec le compte de stockage.
`Name of the storage account`	Le nom du compte de stockage auquel vous voulez vous connecter. Dans ce guide, nous utilisons un Stockage Blob.

Conseil

Si vous n'avez pas de Blob Storage, vous pouvez exécuter az containerapp connection create storage-blob --new --secret pour provisionner un nouveau Blob Storage et le connecter directement à votre application conteneur en utilisant une chaîne de connexion.

Afficher les connexions

Utilisez la commande Azure CLI az containerapp connection list pour lister toutes les connexions provisionnées de votre application conteneur. Remplacez les espaces réservés <container-app-resource-group> et <container-app-name> par la commande ci-dessous par le groupe de ressources et le nom de votre application conteneur. Vous pouvez également supprimer l’option --output table permettant d’afficher plus d’informations sur vos connexions.

az containerapp connection list -g "<container-app-resource-group>" --name "<container-app-name>" --output table

La sortie affiche également l’état de provisionnement de vos connexions : échec ou réussite.

Étapes suivantes

Services internes de Service Connector

Partager via