title | description | ms.date | author | ms.author | ms.topic | ms.custom |
---|---|---|---|---|---|---|
Spring Cloud Azure overview |
This reference doc contains Spring Cloud Azure overview. |
04/06/2023 |
KarlErickson |
hangwan |
reference |
devx-track-java, devx-track-extended-java |
This article applies to: ✔️ Version 4.19.0 ✔️ Version 5.15.0
Spring is an open-source application framework developed by VMware that provides a simplified, modular approach for creating Java applications. Spring Cloud Azure is an open-source project that provides seamless Spring integration with Azure.
For more information about supported versions, see Spring Versions Mapping.
If you have any questions about this documentation, create a GitHub issue in one of the following GitHub repositories. Pull requests are also welcome.
GitHub repositories | Description |
---|---|
Azure/azure-sdk-for-java | This repository holds the source code. |
MicrosoftDocs/azure-dev-docs | This repository holds the documentation. |
This documentation covers changes made in 4.0 since 3.10. This major release brings better security, leaner dependencies, support for production readiness, and more.
Tip
For more information on migrating to 4.0, see Migration guide for 4.0.
The following list summarizes some of the changes that Spring Cloud Azure 4.0 provides:
- A unified development experience, with unified project name, artifact ID, and properties.
- Simplified dependency management using a single
spring-cloud-azure-dependencies
BOM. - Expanded Azure support on Spring Initializr to cover Kafka, Event Hubs, Azure Cache for Redis, and Azure App Configuration.
- Rearchitected Spring module dependencies to remove excess layers and entanglement.
- Managed Identity support for Azure App Configuration, Event Hubs, Service Bus, Azure Cosmos DB, Key Vault, Storage Blob, and Storage Queue.
- Continued support for authentication methods in the underlying Azure SDK from our Spring libraries, such as SAS token and token credential authentication with Service Bus and Event Hubs.
- Credential chain is now enabled by default, enabling applications to obtain credentials from application properties, environment variables, managed identity, IDEs, and so on. For more information, see the DefaultAzureCredential section of Azure Identity client library for Java.
- Granular access control at the resource level (such as Service Bus queue) to enable better security governance and adherence to IT policies.
- More options exposed in a Spring-idiomatic way through improved auto-configuration coverage of Azure SDK clients for both synchronous and asynchronous scenarios.
- Added health indicators for Azure App Configuration, Event Hubs, Azure Cosmos DB, Key Vault, Storage Blob, Storage Queue, and Storage File.
- Spring Cloud Sleuth support for all HTTP-based Azure SDKs.
For more information on migrating to 4.0, see Migration guide for 4.0.
If you use Maven, add the BOM to your pom.xml file in the dependencyManagement
section, as shown in the following example. When you use the BOM, you don't have to specify versions for any of the Maven dependencies because versioning is delegated to the BOM.
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.azure.spring</groupId>
<artifactId>spring-cloud-azure-dependencies</artifactId>
<version>5.15.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
With Gradle, you can import the spring-cloud-azure-dependencies
BOM in the following ways:
-
Use Gradle’s native BOM support by adding dependencies as shown in the following example:
import org.springframework.boot.gradle.plugin.SpringBootPlugin plugins { id("java") id("org.springframework.boot") version "3.2.O" } dependencies { implementation(platform(SpringBootPlugin.BOM_COORDINATES)) implementation(platform("com.azure.spring:spring-cloud-azure-dependencies:{version}")) }
-
Use the
io.spring.dependency-management
plugin and import the BOM independencyManagement
, as shown in the following example:plugins { id("io.spring.dependency-management") version "1.1.0" } dependencyManagement { imports { mavenBom("com.azure.spring:spring-cloud-azure-dependencies:{version}") } }
For more information, see Spring Boot Gradle Plugin Reference Guide.
Note
If you're using Spring Boot 2.x, be sure to set the spring-cloud-azure-dependencies
version to 4.19.0
.
This Bill of Material (BOM) should be configured in the <dependencyManagement>
section of your pom.xml file. This ensures that all Spring Cloud Azure dependencies are using the same version.
For more information about the version used for this BOM, see Which Version of Spring Cloud Azure Should I Use.
Spring Cloud Azure Starters are a set of convenient dependency descriptors to include in your application. Each starter contains all the dependencies and transitive dependencies needed to begin using their corresponding Spring Cloud Azure module. These starters boost your Spring Boot application development with Azure services.
For example, if you want to get started using Spring and Azure Cosmos DB for data persistence, include the spring-cloud-azure-starter-cosmos
dependency in your project.
The following table lists application starters provided by Spring Cloud Azure under the com.azure.spring
group:
[!div class="mx-tdBreakAll"]
Name Description spring-cloud-azure-starter The core starter, including auto-configuration support. spring-cloud-azure-starter-active-directory The starter for using Microsoft Entra ID with Spring Security. spring-cloud-azure-starter-active-directory-b2c The starter for using Azure Active Directory B2C with Spring Security. spring-cloud-azure-starter-appconfiguration The starter for using Azure App Configuration. spring-cloud-azure-starter-cosmos The starter for using Azure Cosmos DB. spring-cloud-azure-starter-eventhubs The starter for using Azure Event Hubs. spring-cloud-azure-starter-keyvault The Starter for using Azure Key Vault. spring-cloud-azure-starter-keyvault-secrets The starter for using Azure Key Vault Secrets. spring-cloud-azure-starter-keyvault-certificates The starter for using Azure Key Vault Certificates. spring-cloud-azure-starter-servicebus The starter for using Azure Service Bus. spring-cloud-azure-starter-servicebus-jms The starter for using Azure Service Bus and JMS. spring-cloud-azure-starter-storage The starter for using Azure Storage. spring-cloud-azure-starter-storage-blob The starter for using Azure Storage Blob. spring-cloud-azure-starter-storage-file-share The starter for using Azure Storage File Share. spring-cloud-azure-starter-storage-queue The starter for using Azure Storage Queue. spring-cloud-azure-starter-actuator The starter for using Spring Boot’s Actuator, which provides production ready features.
The following table lists starters for Spring Data support:
[!div class="mx-tdBreakAll"]
Name Description spring-cloud-azure-starter-data-cosmos The starter for using Spring Data for Azure Cosmos DB.
The following table lists starters for Spring Integration support:
[!div class="mx-tdBreakAll"]
Name Description spring-cloud-azure-starter-integration-eventhubs The starter for using Azure Event Hubs and Spring Integration. spring-cloud-azure-starter-integration-servicebus The starter for using Azure Service Bus and Spring Integration. spring-cloud-azure-starter-integration-storage-queue The starter for using Azure Storage Queue and Spring Integration.
The following table lists starters for Spring Cloud Stream support:
[!div class="mx-tdBreakAll"]
Name Description spring-cloud-azure-starter-stream-eventhubs The starters for using Azure Event Hubs and Spring Cloud Stream Binder. spring-cloud-azure-starter-stream-servicebus The starter for using Azure Service Bus and Spring Cloud Stream Binder.
The following table lists starters for MySQL support:
[!div class="mx-tdBreakAll"]
Name Description spring-cloud-azure-starter-jdbc-mysql The starters for using Azure MySQLs and JDBC through Microsoft Entra authentication.
The following table lists starters for PostgreSQL support:
[!div class="mx-tdBreakAll"]
Name Description spring-cloud-azure-starter-jdbc-postgresql The starters for using Azure PostgreSQL and JDBC through Microsoft Entra authentication.
Azure SDK JARs require signature verification. However, Spring Boot 3 doesn't support the JAR signature verification for ahead-of-time (AOT) mode on a JVM and for native images. For more information, see Using Ahead-of-time Processing With the JVM and GraalVM Native Image Support.
To solve this issue, disable the JAR signature verification.
-
Create a custom.security file in src/main/resources with the following contents:
jdk.jar.disabledAlgorithms=MD2, MD5, RSA, DSA
-
If you're using Maven, add the following configuration:
<plugin> <groupId>org.graalvm.buildtools</groupId> <artifactId>native-maven-plugin</artifactId> <configuration> <buildArgs> <arg>-Djava.security.properties=src/main/resources/custom.security</arg> </buildArgs> </configuration> </plugin>
If you're using Gradle, add the following configuration:
graalvmNative { binaries { main { buildArgs('-Djava.security.properties=' + file("$rootDir/custom.security").absolutePath) } } }
For a full list of samples that show usage, see Spring Cloud Azure Samples.