Partager via

Démarrage rapide : Connecter Azure Spring Apps aux bases de données et services avec Service Connector

Prise en main de Service Connector pour connecter azure Spring Apps aux bases de données, aux comptes de stockage et à d’autres services Azure. Service Connector simplifie l’authentification et la configuration, ce qui vous permet de vous connecter aux ressources à l’aide d’identités managées d’autres méthodes d’authentification.

Cet article fournit des instructions pas à pas pour le portail Azure et Azure CLI. Choisissez votre méthode préférée à l’aide des onglets ci-dessus.

Remarque

Les plans De base, Standard et Entreprise ont entré une période de retraite le 17 mars 2025. Pour plus d’informations, consultez l’annonce de mise hors service d’Azure Spring Apps.

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 dernière version est déjà installée.
  • L’extension Azure Spring Apps doit être installée dans Azure CLI ou 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 / Astuce

    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 est Registered, Service Connector a déjà été inscrit.

  2. Si vous le souhaitez, exécutez la commande suivante pour obtenir la liste des services cibles pris en charge pour Azure Spring Apps.

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

    Conseil / Astuce

    Si la az spring commande 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

Utilisez Service Connector pour créer une connexion de service sécurisée entre vos applications Azure Spring Apps et stockage Blob Azure. Cet exemple illustre la connexion au stockage Blob, mais vous pouvez utiliser le même processus pour d’autres services Azure pris en charge.

  1. Sélectionnez la barre de recherche des ressources, services et documents (G +/) en haut du portail Azure, tapez Azure Spring Apps dans le filtre et sélectionnez Azure Spring Apps.

    Capture d’écran du portail Azure avec l’option Azure Spring Apps sélectionnée.

  2. Sélectionnez le nom de l’instance Azure Spring Apps que vous souhaitez connecter à une ressource cible.

  3. Sous Paramètres, sélectionnez Applications, puis choisissez l’application dans la liste.

    Capture d’écran du portail Azure avec la sélection d’une application.

  4. Sélectionnez Service Connector dans le menu de service, puis sélectionnez Créer. Capture d’écran du portail Azure, avec sélection du bouton pour créer une connexion.

  5. Sous l’onglet Informations de base , sélectionnez ou entrez les paramètres suivants. Capture d’écran du portail Azure, remplir les informations de base pour créer une connexion.

    Setting Exemple Description
    Type de service Coffre-fort de clés Type de service que vous allez connecter à votre application.
    Nom de connexion keyvault_17d38 Nom qui permet d’identifier la connexion entre votre instance application et le service cible. Utilisez le nom de la connexion fourni par le connecteur de services ou entrez votre propre nom de connexion.
    Abonnement my-subscription L’abonnement qui contient votre service cible (le service auquel vous voulez vous connecter). La valeur par défaut est l’abonnement qui contient l’application déployée sur Azure Spring Apps.
    Coffre-fort de clés my-keyvault-name Key Vault cible auquel vous souhaitez vous connecter. Si vous choisissez un autre type de service, sélectionnez l’instance de service cible correspondante.
    Type de client SpringBoot Pile d’applications qui fonctionne avec le service cible sélectionné. Outre SpringBoot et Java, d’autres piles sont également prises en charge.

  6. Sélectionnez Suivant : Authentification pour sélectionner le type d’authentification. Nous vous recommandons d’utiliser une identité managée affectée par le système pour vous connecter à votre coffre de clés.

    Capture d’écran du portail Azure avec l’onglet Authentification en train d’être rempli.

  7. Sélectionnez Suivant : Mise en réseau pour sélectionner la configuration réseau et configurer des règles de pare-feu pour permettre l’accès au service cible afin que votre application puisse atteindre le stockage Blob.

    Capture d’écran du portail Azure avec l’onglet des Réseau en train d’être rempli.

  8. Sélectionnez Suivant : Vérifier + créer pour passer en revue les informations fournies. Patientez quelques secondes pour que Service Connector valide les informations et sélectionnez Créer pour créer la connexion de service.

Exécutez la az spring connection create commande pour connecter une application déployée à Azure Spring Apps à une ressource Stockage Blob, avec une identité managée affectée par le système. Vous pouvez exécuter cette commande de deux façons différentes :

  • Générez la nouvelle connexion étape par étape.

       az spring connection create storage-blob --system-identity

  • Générez la nouvelle connexion à la fois. Remplacez les espaces réservés par vos propres informations : <source-subscription>, , <source_resource_group><azure-spring-apps-resource>, <app>, <target-subscription>, , <target_resource_group>et <account>.

       az spring connection create storage-blob \                         
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.AppPlatform/Spring/<azure-spring-apps-resource>/apps/<app> \
   --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
   --system-identity

Conseil / Astuce

Si vous n’avez pas de compte de stockage d’objets blob, exécutez-en az spring connection create storage-blob --new --system-identity un pour en créer un et connectez-le à votre application hébergée sur Azure Spring Apps à l’aide d’une identité managée.

Voir les connexions de service

Les connexions Azure Spring Apps s’affichent sous Paramètres > Service Connector.

  1. Sélectionnez > pour développer la liste et accéder aux propriétés requises par votre application.

  2. Sélectionnez Valider pour vérifier l’état de votre connexion, puis sélectionnez En savoir plus pour passer en revue les détails de la validation de la connexion.

    Capture d’écran du portail Azure, obtenir le résultat de la validation de la connexion.

Exécutez az spring connection list la commande 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-resource-name>et <app-name> à partir de la commande ci-dessous par vos propres informations. Vous pouvez également supprimer l’option --output table pour afficher plus d’informations sur vos connexions.

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

La sortie affiche également l’état d’approvisionnement de vos connexions.

Contenu connexe

Consultez les guides ci-dessous pour plus d’informations sur le connecteur de services et Azure Spring Apps :

  • Last updated on