{"id":3158,"date":"2024-08-22T20:31:34","date_gmt":"2024-08-23T03:31:34","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/azure-sdk\/?p=3158"},"modified":"2024-08-22T20:31:34","modified_gmt":"2024-08-23T03:31:34","slug":"farewell-spring-cloud-azure-4-x-hello-5-x-the-future-is-now","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/azure-sdk\/farewell-spring-cloud-azure-4-x-hello-5-x-the-future-is-now\/","title":{"rendered":"Farewell Spring Cloud Azure 4.x, Hello 5.x: The Future is Now!"},"content":{"rendered":"

Spring Boot is evolving rapidly, and we’re continuously updating Spring Cloud Azure to keep pace. Spring Cloud Azure version 5.x<\/strong> has been available for a while, making it an opportune time to consider moving on from version 4.x. Let’s dive into the details and see what’s new in this release.<\/p>\n

Why consider moving to 5.x?<\/h2>\n

Spring Cloud Azure 4.x was designed to be compatible with Spring Boot 2.x (versions 2.5.0-2.5.15, 2.6.0-2.6.15, and 2.7.0-2.7.18). This design ensured that all features and integrations provided by Spring Cloud Azure 4.x worked seamlessly with the Spring Boot 2.x series. However, with support for Spring Boot 2.7.18 ending in November 2023, version 4.x is ready for retirement. As of June 2024, we released the final version, 4.19.0, marking the end of this series. We’ll continue to provide support until June 2025, ensuring a smooth transition for your apps.<\/p>\n

To ensure you\u2019re using the right versions, refer to the Spring Versions Mapping<\/a> for the corresponding Spring Cloud Azure version for your Spring Boot and Spring Cloud versions.<\/p>\n

New features and improvements in 5.x<\/h2>\n

With the release of Spring Boot 3.x, Spring Cloud Azure has also leveled up. Since January 2023, there have been 17 releases, each adding new features and improvements. We\u2019re committed to keeping this version in tip-top shape, ensuring it remains a robust, reliable choice for your cloud-native apps.<\/p>\n

Support Spring Boot 3.3.0<\/h3>\n

The latest version, Spring Cloud Azure 5.15.0, provides full support for Spring Boot 3.3.0<\/strong> and later versions, including compatibility with 3.0.0-3.0.13, 3.1.0-3.1.12, 3.2.0-3.2.7, and 3.3.0-3.3.2. This support allows you to use the latest features of Spring Boot 3.3 in your cloud-native apps. For detailed version support information, see the release notes<\/a>. Additionally, in this version, the previous development branch feature\/spring-boot-3<\/code> for Spring Boot 3 merged into the main branch, eliminating the development branch for Spring Boot 2. This change streamlines the development process and focuses our efforts on the latest Spring Boot versions.<\/p>\n

Passwordless connection in Azure Cache for Redis<\/h3>\n

Remember the days of needing a password for authenticating to Azure Cache for Redis? Those days are over! With support for passwordless connections<\/a>, you can now connect using Managed Identity or any Microsoft Entra ID principal. This feature not only simplifies the connection process but also enhances security.<\/p>\n

To connect to Azure Cache for Redis with a passwordless connection, add the appropriate dependencies and enable passwordless in your application.properties<\/code> file:<\/p>\n

<dependency>\r\n  <groupId>org.springframework.boot<\/groupId>\r\n  <artifactId>spring-boot-starter-data-redis<\/artifactId>\r\n<\/dependency>\r\n<dependency>\r\n  <groupId>com.azure.spring<\/groupId>\r\n  <artifactId>spring-cloud-azure-starter-data-redis-lettuce<\/artifactId>\r\n<\/dependency><\/code><\/pre>\n
spring.data.redis.azure.passwordless-enabled=true<\/code><\/pre>\n
You can find more details from Use Azure Redis Cache in Spring<\/a> or Spring Cloud Azure Redis support<\/a>, or check out this sample<\/a>.<\/p>\n
Testcontainers support for Cosmos DB, Blobs, and Queues<\/h3>\n
In the latest released version 5.15, we\u2019re adding support for Testcontainers Service Connection to Cosmos DB<\/a>, Storage Blobs<\/a>, and Storage Queues<\/a>. This feature uses Spring Boot\u2019s @ServiceConnection<\/code> annotation to simplify the configuration and management of these services in integration tests. With the @ServiceConnection<\/code> annotation, developers can easily connect to these services running inside Docker containers managed by Testcontainers<\/a>. The connection details are automatically created and injected into the Spring Boot application context, ensuring that the app uses the correct connection settings.<\/p>\n
@Testcontainers\r\n@SpringBootTest\r\npublic class MyCosmosTests {\r\n\r\n    @Container\r\n    @ServiceConnection\r\n    static CosmosDBEmulatorContainer cosmos = new CosmosDBEmulatorContainer(DockerImageName.parse(\"mcr.microsoft.com\/cosmosdb\/linux\/azure-cosmos-emulator:latest\"));\r\n\r\n    \/\/ Your test methods here\r\n}<\/code><\/pre>\n
In this example, the configured configuration allows Cosmos DB-related beans in the app to communicate with Cosmos DB running inside the Testcontainers-managed Docker container. This action is done by automatically defining a AzureCosmosConnectionDetails<\/code> bean, which is then used by the Cosmos DB autoconfiguration, overriding any connection-related configuration properties.<\/p>\n
Service connection annotations are processed by xxxContainerConnectionDetailsFactory<\/code> classes registered with spring.factories<\/code>. A xxxContainerConnectionDetailsFactory<\/code> can create a ConnectionDetails bean based on a specific Container subclass, or the Docker image name. We first support CosmosContainerConnectionDetailsFactory<\/code>, StorageBlobContainerConnectionDetailsFactory<\/code>, and StorageQueueContainerConnectionDetailsFactory<\/code> in the spring-cloud-azure-testcontainers<\/strong> jar.<\/p>\n
Enhanced documentation and samples<\/h3>\n
Spring Cloud Azure 5.x also brings enhanced documentation and new samples to help you get the most out of its features. For instance, you can now find detailed guides<\/a> using Spring Messaging, and examples for integrating Event Hubs<\/a>, Service Bus<\/a>, and Storage Queues<\/a> with Spring Messaging. These resources make it simpler to build robust messaging solutions and apply the powerful capabilities of Azure services in your Spring apps.<\/p>\n
Community and ecosystem<\/h3>\n
The Spring Cloud Azure community grows significantly, with more contributors and users sharing their experiences and solutions. This vibrant community provides a wealth of knowledge and resources, which includes forums, blogs, and GitHub repositories. You can find answers to your questions and collaborate with other developers here. The ecosystem around Spring Cloud Azure continues to expand, with new integrations and extensions being developed to support a wide range of use cases.<\/p>\n
The roadmap of Spring Cloud Azure 5.x<\/h2>\n