Partager via


Démarrage rapide : Créer une connexion de service dans Azure Spring Apps avec l’Azure CLI

Ce guide de démarrage rapide vous montre comment connecter Azure Spring 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.

Prérequis

  • Version 2.37.0 ou ultérieure d’Azure CLI. 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 Azure Spring Apps doit être installée dans Azure CLI ou dans le Cloud Shell. Pour l’installer, exécutez az extension add --name spring.

Configuration initiale

  1. 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.

  2. Si vous le souhaitez, exécutez la commande az spring connection list-support-types pour obtenir la liste des services cibles pris en charge pour Azure Spring Apps.

    az spring connection list-support-types --output table
    

    Conseil

    Si la commande az spring n’est pas reconnue par le système, vérifiez que vous avez installé l’extension requise en exécutant az extension add --name spring.

Créer une connexion de service

Créez une connexion à partir d’Azure Spring Apps à l’aide d’une identité managée ou d’une clé d’accès.

Important

Pour utiliser une identité gérée, vous devez disposer de l'autorisation nécessaire pour modifier les attributions de rôles dans Microsoft Entra ID. Sans cette autorisation, la création de votre connexion échouera. Demandez au propriétaire de votre abonnement de vous accorder une autorisation d’attribution de rôle ou d’utiliser une clé d’accès pour créer la connexion.

  1. Exécutez la commande az spring connection create pour créer une connexion de service et un Blob Storage avec une identité gérée attribuée par le système

  2. Fournissez les informations suivantes à la demande de l’interface CLI ou de Cloud Shell :

    az spring connection create storage-blob --system-identity
    
    Paramètre Description
    The resource group which contains the spring-cloud Nom du groupe de ressources qui contient l’application hébergée par Azure Spring Apps.
    Name of the spring-cloud service Le nom de la ressource Azure Spring Apps.
    Name of the spring-cloud app Nom de l’application hébergée par Azure Spring Apps qui se connecte au service cible.
    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 1az spring connection create storage-blob --new --system-identitypour provisionner un nouveau Blob Storage et le connecter directement à votre application hébergée par Azure Spring Apps en utilisant une identité managée.

Afficher les connexions

Exécutez la commande az spring connection list pour répertorier toutes les connexions approvisionnées d’Azure Spring Apps.

Remplacez les espaces réservés <azure-spring-apps-resource-group>, <azure-spring-apps-name> et <app-name> dans la commande ci-dessous par le nom de votre groupe de ressources Azure Spring Apps, le nom de votre ressource Azure Spring Apps et le nom de votre application. Vous pouvez également supprimer l’option --output table permettant d’afficher plus d’informations sur vos connexions.

az spring connection list --resource-group <azure-spring-apps-resource-group> --service <azure-spring-apps-name> --app <app-name>--output table

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

Étapes suivantes

Consultez les guides ci-dessous pour plus d’informations sur Service Connector et Azure Spring Apps.