Guide du développeur Spring Cloud Azure

Article
10/23/2023

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.