Spring Versions Mapping

This wiki is to help you find the corresponding Spring Cloud Azure version and its support status with the given Spring Boot / Spring Cloud version.

Spring Cloud Azure Support Status

Table 1: The support status of Spring Cloud Azure with the given Spring Boot / Spring Cloud version.

Spring Boot version	Spring Cloud version	Spring Cloud Azure version	Spring Cloud Azure support status	Spring Framework version	JDK Version Range
3.3.x	2023.0.x	5.x.x	In Support	6.1.x	JDK 17-23
3.2.x	2023.0.x	5.x.x	In Support	6.1.x	JDK 17-23
3.1.x	2022.0.x	5.x.x	In Support	6.0.x	JDK 17-21
3.0.x	2022.0.x	5.x.x	In Support	6.0.x	JDK 17-21
2.7.x	2021.0 (Jubilee)	4.x.x	In Support	5.3.x	JDK 8-21
2.6.x	2021.0 (Jubilee)	4.x.x	In Support	5.3.x	JDK 8-21
2.5.x	2020.0 (ilford)	4.x.x	In Support	5.3.x	JDK 8-21
2.4.x	2020.0 (ilford)	3.x.x	End of Life	5.3.x	JDK 8-21
2.3.x	Hoxton	3.x.x	End of Life	5.2.x	JDK 8-13

NOTE: Spring Boot 2.x requires Java 8 as minimum version, and Spring Boot 3.x requires Java 17 or higher. Please reference to Spring Framework JDK Version Range for detailed JDK version range a Spring Framework version supports.

Which Version of Spring Cloud Azure Should I Use

Table 2: Mapping from Spring Boot / Spring Cloud version to Spring Cloud Azure / azure-sdk-bom version

Spring Boot version	Spring Cloud version	Spring Cloud Azure version	azure-sdk-bom version
3.3.x	2023.0.x	5.13.0~5.18.0	1.2.24~1.2.29
3.2.x	2023.0.x	5.7.0~5.18.0	1.2.18~1.2.29
3.1.x	2022.0.x	5.3.0~5.18.0	1.2.8~1.2.29
3.0.x	2022.0.x	5.0.0~5.18.0	1.2.8~1.2.29
2.7.x	2021.0.x	4.0.0~4.19.0	1.2.0~1.2.24
2.6.x	2021.0.x	4.0.0~4.19.0	1.2.0~1.2.24
2.5.x	2020.0.x	4.0.0~4.19.0	1.2.0~1.2.24
2.4.x	2020.0.x	3.14.0	1.1.1
2.3.x	Hoxton	3.2.0	1.0.2

NOTE: Spring Cloud Azure 4.x.x have all reached end of life status and only support hotfixes of 4.19.0 until June 2025. So if you use Spring Boot 3, please upgrade to 5.x.

NOTE: Spring Cloud Azure 3.x.x have all reached end of life status and are no longer supported. Please upgrade to 4.x. You can refer to Migration Guide for 4.0 to migrate to 4.x.

I'm Using Spring Boot Version X

If you are using Spring Boot in your project, you can find related Spring Cloud Azure version from above table. For example: if you are using Spring Boot 3.3.x, you should use Spring Cloud Azure 5.18.0.

I'm Using Spring Cloud Version Y

If you are using Spring Cloud in your project, you can also find related Spring Cloud Azure version from above table. For example, if you are using Spring Cloud 2023.0.x, you should use Spring Cloud Azure 5.18.0.

How To Use This Version in My Project

Now that you know which version to use, you can add the spring-cloud-azure-dependencies to your application.

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

You can refer to Reference Doc to get more information about setting up dependencies.

If My Spring Boot Version Can Not Found in Above Table

If your Spring Boot version cannot be found in above table, you can upgrade your Spring Boot version, or asking help by creating a new issue in azure-sdk-for-java repo.

If I'm Using Spring Cloud Azure 3.x.x

Spring Cloud Azure 3.x.x has reached end of life status and is no longer supported.

• It's suggested to upgrade to the latest version of 4.x. Please refer to Migration Guide for 4.0 to get more information about how to do migration.
• If you still want to use 3.x.x, please import bom like this:

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.azure.spring</groupId>
      <artifactId>azure-spring-boot-bom</artifactId>
      <version>3.14.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
    <dependency>
      <groupId>com.azure.spring</groupId>
      <artifactId>azure-spring-cloud-dependencies</artifactId>
      <version>2.14.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>