Guide du développeur Azure Spring Cloud

Spring est une infrastructure d’application open source développée par VMware qui fournit une approche simplifiée et modulaire pour la création d’applications Java. Spring Cloud Azure est un projet open source qui offre une intégration spring transparente avec Azure.

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

Obtenir de l’aide

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

Commencer

Configuration des dépendances

Nomenclature (BOM)

Si vous utilisez Maven, ajoutez le boM à votre fichier pom.xml dans la section dependencyManagement, comme illustré dans l’exemple suivant. Lorsque vous utilisez le boM, vous n’avez pas besoin de spécifier des versions pour les dépendances Maven, car le contrôle de version est délégué au boM.

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

Avec Gradle, vous pouvez importer le spring-cloud-azure-dependencies BOM de la manière suivante :

• Utilisez la prise en charge native de Gradle en ajoutant des dépendances, comme illustré dans l’exemple suivant :

  import org.springframework.boot.gradle.plugin.SpringBootPlugin
  
  plugins {
    id("java")
    id("org.springframework.boot") version "4.0.1"
  }
  
  dependencies {
      implementation(platform(SpringBootPlugin.BOM_COORDINATES))
      implementation(platform("com.azure.spring:spring-cloud-azure-dependencies:{version}"))
  }
  

• Utilisez le plug-in io.spring.dependency-management et importez le boM dans dependencyManagement, comme illustré dans l’exemple suivant :

  plugins {
      id("io.spring.dependency-management") version "1.1.7"
  }
  
  dependencyManagement {
      imports {
          mavenBom("com.azure.spring:spring-cloud-azure-dependencies:{version}")
      }
  }
  

Pour plus d’informations, consultez Guide de référence du plug-in Spring Boot Gradle.

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 Spring Cloud Azure correspondant. Ces démarrages renforcent votre développement d’applications Spring Boot avec Azure services.

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

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

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

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

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

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

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

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

Learning Spring Cloud Azure

Pour obtenir la liste complète des exemples qui montrent l’utilisation, consultez Spring Cloud Azure Samples.

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.

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é Azure support sur Spring Initializr pour couvrir Kafka, Event Hubs, Azure Cache for 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 de stockage et File d’attente de stockage.
• Prise en charge continue des méthodes d’authentification dans les Azure SDK sous-jacentes de nos bibliothèques Spring, telles que l’authentification par jeton SAP et les 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 Azure bibliothèque de client Identity pour Java.
• Contrôle d’accès granulaire au niveau des ressources (par exemple, Service Bus file d’attente) pour améliorer la 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 améliorée de la configuration automatique de Azure SDK clients 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, File d’attente de stockage et Fichier de stockage.
• Prise en charge de Spring Cloud Sleuth pour toutes les Azure SDKs basées sur HTTP.