Partager via


Guide du développeur Spring Cloud Azure

Cet article s’applique à : ✔️ Version 4.14.0 ✔️ Version 5.8.0

Spring est un framework d’application open source développé par VMware qui fournit une approche simplifiée et modulaire pour créer des applications Java. Spring Cloud Azure est un projet open source qui fournit une intégration spring transparente à Azure.

Pour plus d’informations sur les versions prises en charge, consultez Mappage des versions Spring.

Obtenir de l’aide

Si vous avez des questions sur cette documentation, créez un problème GitHub dans l’un des référentiels GitHub suivants. Les demandes de tirage (pull request) sont également bienvenues.

Dépôts GitHub Description
Azure/azure-sdk-for-java Ce référentiel contient le code source.
MicrosoftDocs/azure-dev-docs Ce référentiel contient la documentation.

Nouveautés de la version 4.0 depuis la version 3.10.x

Cette documentation traite des modifications apportées à la version 4.0 depuis la version 3.10. Cette version majeure apporte une meilleure sécurité, des dépendances plus légères, la prise en charge de la préparation de la production, etc.

Conseil

Pour plus d’informations sur la migration vers la version 4.0, consultez le guide de migration pour la version 4.0.

La liste suivante résume certaines des modifications que Spring Cloud Azure 4.0 fournit :

  • Expérience de développement unifiée, avec le nom de projet unifié, l’ID d’artefact et les propriétés.
  • Gestion simplifiée des dépendances à l’aide d’un seul spring-cloud-azure-dependencies boM.
  • Développé support Azure sur Spring Initializr pour couvrir Kafka, Event Hubs, Azure Cache pour Redis et Azure App Configuration.
  • Réarchitecture les dépendances de module Spring pour supprimer les couches excédentaires et l’enchevêtrement.
  • Prise en charge des identités managées pour Azure App Configuration, Event Hubs, Service Bus, Azure Cosmos DB, Key Vault, blob Stockage et file d’attente Stockage.
  • Prise en charge continue des méthodes d’authentification dans le Kit de développement logiciel (SDK) Azure sous-jacent à partir de nos bibliothèques Spring, telles que le jeton SAP et l’authentification des informations d’identification de jeton avec Service Bus et Event Hubs.
  • La chaîne d’informations d’identification est désormais activée par défaut, ce qui permet aux applications d’obtenir des informations d’identification à partir des propriétés de l’application, des variables d’environnement, de l’identité managée, des IDE, et ainsi de suite. Pour plus d’informations, consultez la section DefaultAzureCredential de la bibliothèque de client Azure Identity pour Java.
  • Contrôle d’accès granulaire au niveau des ressources (comme la file d’attente Service Bus) pour permettre une meilleure gouvernance de la sécurité et l’adhésion aux stratégies informatiques.
  • Plus d’options exposées de manière spring-idiomatique via une couverture de configuration automatique considérablement améliorée des clients du KIT de développement logiciel (SDK) Azure pour les scénarios synchrones et asynchrones.
  • Ajout d’indicateurs d’intégrité pour Azure App Configuration, Event Hubs, Azure Cosmos DB, Key Vault, Stockage Blob, Stockage File d’attente et Stockage Fichier.
  • Prise en charge de Spring Cloud Sleuth pour tous les kits SDK Azure basés sur HTTP.

Guide de migration pour la version 4.0

Pour plus d’informations sur la migration vers la version 4.0, consultez le guide de migration pour la version 4.0.

Bien démarrer

Configuration des dépendances

Nomenclature

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.azure.spring</groupId>
      <artifactId>spring-cloud-azure-dependencies</artifactId>
      <version>4.14.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

Remarque

Si vous utilisez Spring Boot 3.x, veillez à définir la spring-cloud-azure-dependencies version 5.8.0sur . Pour plus d’informations sur la spring-cloud-azure-dependencies version, consultez La version de Spring Cloud Azure à utiliser.

Dépendances de démarrage

Spring Cloud Azure Starters est un ensemble de descripteurs de dépendance pratiques à inclure dans votre application. Chaque démarrage contient toutes les dépendances et dépendances transitives nécessaires pour commencer à utiliser leur module Azure Spring Cloud correspondant. Ces démarrages renforcent votre développement d’applications Spring Boot avec les services Azure.

Par exemple, si vous souhaitez commencer à utiliser Spring et Azure Cosmos DB pour la persistance des données, incluez la spring-cloud-azure-starter-cosmos dépendance dans votre projet.

Le tableau suivant répertorie les démarrages d’application fournis par Spring Cloud Azure sous le com.azure.spring groupe :

Nom Description
spring-cloud-azure-starter Démarrage principal, y compris la prise en charge de la configuration automatique.
spring-cloud-azure-starter-active-directory Démarrage de l’utilisation de l’ID Microsoft Entra avec Spring Security.
spring-cloud-azure-starter-active-directory-b2c Démarrage pour l’utilisation d’Azure Active Directory B2C avec Spring Security.
spring-cloud-azure-starter-appconfiguration Démarrage pour l’utilisation d’Azure App Configuration.
spring-cloud-azure-starter-cosmos Démarrage pour l’utilisation d’Azure Cosmos DB.
spring-cloud-azure-starter-eventhubs Démarrage pour l’utilisation d’Azure Event Hubs.
spring-cloud-azure-starter-keyvault Démarrage pour l’utilisation d’Azure Key Vault.
spring-cloud-azure-starter-keyvault-secrets Démarrage pour l’utilisation des secrets Azure Key Vault.
spring-cloud-azure-starter-keyvault-certificates Démarrage pour l’utilisation de certificats Azure Key Vault.
spring-cloud-azure-starter-servicebus Démarrage pour l’utilisation d’Azure Service Bus.
spring-cloud-azure-starter-servicebus-jms Démarrage pour l’utilisation d’Azure Service Bus et JMS.
spring-cloud-azure-starter-storage Démarrage pour l’utilisation de Stockage Azure.
spring-cloud-azure-starter-storage-blob Démarrage de l’utilisation de Stockage Azure Blob.
spring-cloud-azure-starter-storage-file-share Démarrage pour l’utilisation de Stockage Azure partage de fichiers.
spring-cloud-azure-starter-storage-queue Démarrage de l’utilisation de Stockage Azure File d’attente.
spring-cloud-azure-starter-actuator Démarrage de l’utilisation de l’actionneur Spring Boot, qui fournit des fonctionnalités prêtes pour la production.

Le tableau suivant répertorie les démarrages pour la prise en charge de Spring Data :

Nom Description
spring-cloud-azure-starter-data-cosmos Démarrage de l’utilisation de Spring Data pour Azure Cosmos DB.

Le tableau suivant répertorie les démarrages pour la prise en charge de Spring Integration :

Nom Description
spring-cloud-azure-starter-integration-eventhubs Démarrage de l’utilisation d’Azure Event Hubs et de Spring Integration.
spring-cloud-azure-starter-integration-servicebus Démarrage de l’utilisation d’Azure Service Bus et de Spring Integration.
spring-cloud-azure-starter-integration-storage-queue Démarrage de l’utilisation de Stockage Azure file d’attente et d’intégration Spring.

Le tableau suivant répertorie les démarrages pour la prise en charge de Spring Cloud Stream :

Nom Description
spring-cloud-azure-starter-stream-eventhubs Les démarrages pour l’utilisation d’Azure Event Hubs et spring Cloud Stream Binder.
spring-cloud-azure-starter-stream-servicebus Démarrage pour l’utilisation d’Azure Service Bus et spring Cloud Stream Binder.

Le tableau suivant répertorie les démarrages pour la prise en charge de MySQL :

Nom Description
spring-cloud-azure-starter-jdbc-mysql Les démarrages pour l’utilisation d’Azure MySQLs et JDBC via l’authentification Microsoft Entra.

Le tableau suivant répertorie les démarrages pour la prise en charge de PostgreSQL :

Nom Description
spring-cloud-azure-starter-jdbc-postgresql Les démarrages pour l’utilisation d’Azure PostgreSQL et JDBC via l’authentification Microsoft Entra.

Apprentissage Spring Cloud Azure

Nous avons préparé une liste complète d’exemples pour afficher l’utilisation. Vous trouverez ces exemples dans les exemples Azure Spring Cloud.