Spring Cloud Azure Samples

• The repository hold samples about using Spring Cloud Azure libraries.
• The main branch is using the latest stable version of Spring Cloud Azure. If you want to find sample about specific version of Spring Cloud Azure, please switch to corresponding tag in this repository.

Important

We removed the parent pom, so you can directly run each sample without opening the whole projects. We removed all samples for Spring Boot 2.x (compatible with Spring Cloud Azure 4.x) from main branch. If you still want to try, please use spring-boot-2.x branch.

All Samples in This Repo

Microsoft Entra ID

Sample Project	Support Spring Cloud Azure 5.x	Support Spring Cloud Azure 4.x
aad-resource-server-by-filter	✅	✅
aad-resource-server-by-filter-stateless	✅	✅
aad-web-application-and-resource-server	✅	✅
web-client-access-resource-server	✅	✅
aad-b2c-resource-server	✅	✅
aad-b2c-web-application	✅	✅
spring-security-samples	✅	✅

Azure App Configuration

Sample Project	Support Spring Cloud Azure 5.x	Support Spring Cloud Azure 4.x
spring-cloud-azure-appconfiguration-config-convert-sample-complete	✅	✅
spring-cloud-azure-appconfiguration-config-convert-sample-initial	✅	✅
spring-cloud-azure-appconfiguration-config-sample	✅	✅
spring-cloud-azure-feature-management-sample	✅	✅
spring-cloud-azure-feature-management-web-sample	✅	✅
spring-cloud-azure-targeting-filter-web-sample	✅	✅
spring-cloud-azure-starter-appconfiguration-config-sample	✅	✅
spring-cloud-azure-starter-appconfiguration-config-entraid-sample	✅	✅
appconfiguration-client	✅	✅

Azure Cache

Sample Project	Support Spring Cloud Azure 5.x	Support Spring Cloud Azure 4.x
spring-cloud-azure-cache-sample	✅	✅
spring-cloud-azure-cache-passwordless-sample	✅	✅

Azure Cosmos DB

Sample Project	Support Spring Cloud Azure 5.x	Support Spring Cloud Azure 4.x
cosmos-aad-sample	✅	✅
cosmos-multi-database-multi-account	✅	✅
cosmos-multi-database-single-account	✅	✅
cosmos-multi-tenant-by-container	✅	✅
cosmos-multi-tenant-by-database	✅	✅
cosmos-mvc-sample	✅	✅
cosmos-quickstart-samples	✅	✅
spring-cloud-azure-data-cosmos-sample	✅	✅
spring-cloud-azure-cosmos-sample	✅	✅

Azure Event Grid

Sample Project	Support Spring Cloud Azure 5.x	Support Spring Cloud Azure 4.x
spring-cloud-azure-sample-eventgrid	✅	❌

Azure Event Hubs

Sample Project	Support Spring Cloud Azure 5.x	Support Spring Cloud Azure 4.x
spring-cloud-azure-sample-eventhubs-kafka	✅	✅
eventhubs-integration	✅	✅
eventhubs-binder	✅	✅
eventhubs-multibinders	✅	✅
eventhubs-client	✅	✅
eventhubs-spring-messaging	✅	✅

Azure Key Vault

Sample Project	Support Spring Cloud Azure 4.x	Support Spring Cloud Azure 5.x
keyvault-certificates-client-side	❌	✅
keyvault-certificates-server-side	❌	✅
run-with-command-line-server-side	✅	✅
run-with-command-line-client-side	✅	✅
property-source	✅	✅
secret-client	✅	✅

Azure Database for MySQL

Sample Project	Support Spring Cloud Azure 5.x	Support Spring Cloud Azure 4.x
spring-cloud-azure-mysql-sample	✅	✅

Azure Database for PostgreSQL

Sample Project	Support Spring Cloud Azure 5.x	Support Spring Cloud Azure 4.x
spring-cloud-azure-postgresql-sample	✅	✅

Azure Service Bus

Sample Project	Support Spring Cloud Azure 5.x	Support Spring Cloud Azure 4.x
servicebus-queue	✅	✅
servicebus-topic	✅	✅
servicebus-jms-queue	✅	✅
servicebus-jms-topic	✅	✅
single-namespace	✅	✅
multiple-namespaces	✅	✅
servicebus-queue-binder	✅	✅
servicebus-queue-multibinders	✅	✅
servicebus-topic-binder	✅	✅
servicebus-queue-binder-arm	✅	✅
servicebus-spring-messaging	✅	✅

Azure Storage

Sample Project	Support Spring Cloud Azure 5.x	Support Spring Cloud Azure 4.x
storage-blob-sample	✅	✅
storage-file-sample	✅	✅
storage-queue-client	✅	✅
storage-queue-integration	✅	✅
storage-queue-operation	✅	✅
storage-queue-spring-messaging	✅	✅

Spring PetClinic

Sample Project	Support Spring Cloud Azure 5.x	Support Spring Cloud Azure 4.x
spring-petclinic-microservices	❌	✅

TestContainers Support

Sample Project	Support Spring Cloud Azure 5.x	Support Spring Cloud Azure 4.x
testContainers for Cosmos	✅	❌
testContainers for Storage Blob	✅	❌
testContainers for Storage Queue	✅	❌

Getting Help

• If you have any question about using these samples, please create an new issue.

Work with Spring Native

Since we removed the parent pom, the Profiles native-5.x and nativeTest-5.x are removed either. They are variants of the two profiles native and nativeTest provided by spring-boot-starter-parent of Spring Boot 3, and they have the same function. So if you want to use them, just add them into your current pom:

    <profile>
      <id>native-5.x</id>
      <build>
        <pluginManagement>
          <plugins>
            <plugin>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-maven-plugin</artifactId>
              <configuration>
                <image>
                  <builder>paketobuildpacks/builder:tiny</builder>
                  <env>
                    <BP_NATIVE_IMAGE>true</BP_NATIVE_IMAGE>
                  </env>
                </image>
              </configuration>
              <executions>
                <execution>
                  <id>process-aot</id>
                  <goals>
                    <goal>process-aot</goal>
                  </goals>
                </execution>
              </executions>
            </plugin>
            <plugin>
              <groupId>org.graalvm.buildtools</groupId>
              <artifactId>native-maven-plugin</artifactId>
              <configuration>
                <classesDirectory>${project.build.outputDirectory}</classesDirectory>
                <metadataRepository>
                  <enabled>true</enabled>
                </metadataRepository>
                <requiredVersion>22.3</requiredVersion>
              </configuration>
              <executions>
                <execution>
                  <id>add-reachability-metadata</id>
                  <goals>
                    <goal>add-reachability-metadata</goal>
                  </goals>
                </execution>
              </executions>
            </plugin>
          </plugins>
        </pluginManagement>
      </build>
    </profile>
    <profile>
      <id>nativeTest-5.x</id>
      <dependencies>
        <dependency>
          <groupId>org.junit.platform</groupId>
          <artifactId>junit-platform-launcher</artifactId>
          <scope>test</scope>
        </dependency>
      </dependencies>
      <build>
        <plugins>
          <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <executions>
              <execution>
                <id>process-test-aot</id>
                <goals>
                  <goal>process-test-aot</goal>
                </goals>
              </execution>
            </executions>
          </plugin>
          <plugin>
            <groupId>org.graalvm.buildtools</groupId>
            <artifactId>native-maven-plugin</artifactId>
            <configuration>
              <classesDirectory>${project.build.outputDirectory}</classesDirectory>
              <metadataRepository>
                <enabled>true</enabled>
              </metadataRepository>
              <requiredVersion>22.3</requiredVersion>
            </configuration>
            <executions>
              <execution>
                <id>native-test</id>
                <goals>
                  <goal>test</goal>
                </goals>
              </execution>
            </executions>
          </plugin>
        </plugins>
      </build>
    </profile>
  </profiles>