Spring Cloud Azure 開発者ガイド

適用対象: ✅ Version 4.20.0, ✅ Version 5.25.0, ✅ Version 6.1.0, ✅ Version 7.0.0

Spring は、VMware によって開発されたオープンソースのアプリケーションフレームワークであり、Java アプリケーションを作成するための簡素化されたモジュール方式のアプローチを提供します。 Spring Cloud Azure は、Azureとのシームレスな Spring 統合を提供するオープンソースプロジェクトです。

サポートされているバージョンの詳細については、「Spring Versions Mapping を参照してください。

ヘルプを表示する

このドキュメントに関する質問がある場合は、次のいずれかのGitHub リポジトリでGitHubの問題を作成します。プル要求も歓迎されます。

GitHub リポジトリ	形容
Azure/azure-sdk-for-java	このリポジトリはソースコードを保持します。
Azure-Samples/azure-spring-boot-samples	このリポジトリには、関連するサンプルが含まれています。
マイクロソフトドキュメント/azure-dev-docs	このリポジトリにはドキュメントが含まれています。

はじめ

依存関係の設定

部品表 (BOM)

Maven を使用する場合は、次の例に示すように、セクションのファイルに BOM を追加します。 BOM を使用する場合、バージョン管理は BOM に委任されるため、Maven 依存関係のバージョンを指定する必要はありません。

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

Gradle を使用すると、次の方法で BOM をインポートできます。

次の例に示すように依存関係を追加して、Gradle のネイティブ BOM サポートを使用します。

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}"))
}

次の例に示すように、プラグインを使用し、に BOM をインポートします。

plugins {
    id("io.spring.dependency-management") version "1.1.7"
}

dependencyManagement {
    imports {
        mavenBom("com.azure.spring:spring-cloud-azure-dependencies:{version}")
    }
}

詳細については、「Spring Boot Gradle プラグインリファレンスガイド」を参照してください。

手記

Spring Boot 4.0.x を使用している場合は、必ずバージョンをに設定してください。

Spring Boot 3.5.x を使用している場合は、必ずバージョンをに設定してください。

Spring Boot 3.1.x-3.5.x を使用している場合は、必ずバージョンをに設定してください。

Spring Boot 2.x を使用している場合は、必ずバージョンをに設定してください。

この部品表 (BOM) は、ファイルのセクションで構成する必要があります。これにより、すべての Spring Cloud Azure依存関係で同じバージョンが使用されるようになります。

この BOM に使用されるバージョンの詳細については、「 Spring Cloud のバージョンAzure使用する必要がありますを参照してください。

スターターの依存関係

Spring Cloud Azure Starters は、アプリケーションに含めるのに便利な依存関係記述子のセットです。各スターターには、対応する Spring Cloud Azure モジュールの使用を開始するために必要なすべての依存関係と推移的な依存関係が含まれています。これらのスターターは、Azure サービスを使用して Spring Boot アプリケーション開発を強化します。

たとえば、Spring と Azure Cosmos DB を使用してデータの永続化を開始する場合は、プロジェクトに spring-cloud-azure-starter-cosmos 依存関係を含めます。

次の表に、spring Cloud Azure が com.azure.spring グループで提供するアプリケーションスターターを示します。

名前	形容
春の雲の紺碧のスターター	自動構成のサポートを含むコアスターター。
Spring-cloud-azure-スターター-アクティブディレクトリ	Spring Security でMicrosoft Entra IDを使用するためのスターター。
春のクラウド-azure-スターター-active-directory-b2c	Spring Security で Azure Active Directory B2C を使用するためのスターター。
spring-cloud-azure-starter-appconfiguration	Azure App Configurationを使用するためのスターター。
spring-cloud-azure-starter-appconfiguration-config	Azure App Configuration Config を使用するためのスターター。
春の雲の紺碧のスターターコスモス	Azure Cosmos DBを使用するためのスターター。
spring-cloud-azure-starter-eventhubs	Azure Event Hubsを使用するためのスターター。
spring-cloud-azure-starter-eventgrid	Azure Event Gridを使用するためのスターター。
スプリングクラウドアズールスターターキーボルト	Azure Key Vaultを使用するためのスターター。
spring-cloud-azure-starter-keyvault-secrets	Azure Key Vault シークレットを使用するためのスターター。
spring-cloud-azure-starter-keyvault-jca	Azure Key Vault JCA を使用するためのスターター。
spring-cloud-azure-starter-keyvault-certificates	Azure Key Vault証明書を使用するためのスターター。
Spring-Cloud-Azure-スターター-サービスバス	Azure Service Busを使用するためのスターター。
Spring-cloud-azure-スターター-servicebus-jms	Azure Service Busおよび JMS を使用するためのスターター。
spring-cloud-azure-スターター-ストレージ	Azure Storageを使用するためのスターター。
spring-cloud-azure-starter-storage-blob	Azure Storage BLOB を使用するためのスターター。
Spring-cloud-azure-starter-storage-ファイル共有	Azure Storageファイル共有を使用するためのスターター。
spring-cloud-azure-starter-storage-queue	Azure Storage キューを使用するためのスターター。
spring-cloud-azure-スターター-アクチュエータ	生産準備完了機能を提供する Spring Boot のアクチュエータを使用するためのスターター。

次の表に、Spring Data サポートのスターターを示します。

名前	形容
spring-cloud-azure-starter-data-cosmos	Azure Cosmos DBに Spring Data を使用するためのスターター。

次の表に、Spring Data Redis サポートのスターターを示します。

名前	形容
spring-cloud-azure-starter-data-redis-lettuce	Spring Data と lettuce でAzure Cache for Redisを使用するためのスターター。

次の表に、Spring Integration サポートのスターターを示します。

名前	形容
spring-cloud-azure-starter-integration-eventhubs	Azure Event Hubsと Spring Integration を使用するためのスターター。
Spring-cloud-azure-starter-integration-サービスバス	Azure Service Busと Spring Integration を使用するためのスターター。
spring-cloud-azure-starter-integration-storage-queue(英語)	Azure Storage Queue と Spring Integration を使用するためのスターター。

次の表に、Spring Cloud Stream サポートのスターターを示します。

名前	形容
spring-cloud-azure-starter-stream-eventhubs	Azure Event Hubsと Spring Cloud Stream Binder を使用するためのスターター。
春のクラウド-azure-スターター-stream-servicebus	Azure Service Busと Spring Cloud Stream Binder を使用するためのスターター。

次の表に、MySQL サポートのスターターを示します。

名前	形容
spring-cloud-azure-starter-jdbc-mysql	Microsoft Entra認証を通じて Azure MySQL と JDBC を使用するためのスターター。

次の表に、PostgreSQL サポートのスターターを示します。

名前	形容
spring-cloud-azure-starter-jdbc-postgresql	Microsoft Entra認証Azure PostgreSQL と JDBC を使用するためのスターター。

Spring Cloud Azureの学習

使用状況を示すサンプルの完全な一覧については、「Spring Cloud Azure Samples」を参照してください。

3.10.x 以降の 4.0 の新機能

このドキュメントでは、3.10 以降の 4.0 で行われた変更について説明します。このメジャーリリースでは、セキュリティが強化され、依存関係が無駄になり、運用環境の準備がサポートされます。

先端

4.0 への移行の詳細については、4.0の移行ガイドを参照してください。

次の一覧は、Spring Cloud Azure 4.0 が提供する変更の一部をまとめたものです。

統合されたプロジェクト名、成果物 ID、およびプロパティを備えた統合された開発エクスペリエンス。
単一の BOM を使用して依存関係管理を簡素化しました。
Kafka、Event Hubs、Azure Cache for Redis、Azure App Configurationをカバーするために、Spring Initializr のAzure サポートを拡張しました。
余分なレイヤーとエンタングルメントを削除するために、Spring モジュールの依存関係を再設計しました。
Azure App Configuration、Event Hubs、Service Bus、Azure Cosmos DB、Key Vault、ストレージ BLOB、ストレージキューに対するマネージド ID のサポート。
spring ライブラリからの基になるAzure SDKの認証方法 (SAS トークン、Service Busと Event Hubs を使用したトークン資格情報認証など) の継続的なサポート。
資格情報チェーンが既定で有効になり、アプリケーションがアプリケーションのプロパティ、環境変数、マネージド ID、IDE などの資格情報を取得できるようになりました。詳細については、「< Java の id クライアントライブラリのDefaultAzureCredential>Azure セクションを参照してください。
リソースレベル (Service Bus キューなど) できめ細かなアクセス制御を行い、セキュリティガバナンスと IT ポリシーへの準拠を強化します。
同期と非同期の両方のシナリオで、Azure SDK クライアントの自動構成カバレッジを向上させ、Spring 慣用的な方法で公開されるその他のオプション。
Azure App Configuration、Event Hubs、Azure Cosmos DB、Key Vault、ストレージ BLOB、ストレージキュー、ストレージファイルの正常性インジケーターを追加しました。
すべての HTTP ベースのAzure SDKに対する Spring Cloud Sleuth のサポート。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-03-09