Démarrage rapide : Créer une connexion de service dans App Service avec Azure CLI
Ce guide de démarrage rapide décrit les étapes à effectuer pour créer une connexion de service dans Azure App Service avec Azure CLI.
Si vous n’avez pas d’abonnement Azure, créez un compte gratuit Azure avant de commencer.
Prérequis
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.30.0 ou ultérieure d’Azure CLI est exigée pour ce guide de démarrage rapide. Si vous utilisez Azure Cloud Shell, la version la plus récente est déjà installée.
- Ce guide de démarrage rapide part du principe que vous disposez déjà d’au moins une instance App Service s’exécutant dans Azure. Si vous n’avez pas encore d’instance App Service, créez-en une.
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.ServiceLinkerConseil
Vous pouvez vérifier si le fournisseur de ressources a déjà été inscrit en exécutant la commande
az provider show -n "Microsoft.ServiceLinker" --query registrationState. Si la sortie estRegistered, c’est que Service Connector a déjà été inscrit.Vous pouvez également utiliser la commande Azure CLI az webapp connection list-support-types pour obtenir la liste des services cibles pris en charge par App Service.
az webapp connection list-support-types --output table
Créer une connexion de service
Important
Pour utiliser une identité managée, vous devez être autorisé à attribuer des rôles Microsoft Entra. Sans cette autorisation, la création d’une connexion échoue. Vous pouvez demander au propriétaire de votre abonnement de vous octroyer cette autorisation ou utiliser une clé d’accès pour créer la connexion.
Utilisez la commande Azure CLI az webapp connection pour créer une connexion de service à un stockage d’objets blob avec une identité managée affectée par le système, en indiquant les informations suivantes :
- Nom du groupe de ressources contenant l’instance App Service
- Nom de l’instance App Service
- Nom du groupe de ressources qui contient le compte de stockage
- Nom du compte de stockage
az webapp connection create storage-blob
Remarque
Si vous ne disposez pas d’un stockage d’objets blob, vous pouvez exécuter az webapp connection create storage-blob --new --system-identity pour approvisionner une nouvelle ressource Stockage Blob et la connecter directement à votre instance App Service.
Afficher les connexions
Exécutez la commande Azure CLI az webapp connection pour lister les connexions à votre instance App Service, en indiquant les informations suivantes :
- Nom du groupe de ressources contenant l’instance App Service
- Nom de l’instance App Service
az webapp connection list -g "<your-app-service-resource-group>" -n "<your-app-service-name>" --output table
Étapes suivantes
Suivez les tutoriels ci-dessous pour commencer à créer votre propre application avec Service Connector.