Spring Cloud Azure の開発者ガイド

[アーティクル]
06/13/2023

この記事の対象: ✔️ バージョン 4.14.0 ✔️ バージョン 5.8.0

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

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

ヘルプを参照する

このドキュメントについて質問がある場合は、次のいずれかの GitHub リポジトリに GitHub イシューを作成します。 pull request は常に歓迎されます。

GitHub リポジトリ	説明
Azure/azure-sdk-for-java	このリポジトリにはソースコードが含まれています。
MicrosoftDocs/azure-dev-docs	このリポジトリには、ドキュメントが含まれています。

3.10.x 以降の 4.0 の新機能

このドキュメントでは、3.10 以降の 4.0 に加えられた変更について説明します。このメジャーリリースでは、セキュリティの向上、依存関係のリーン化、運用準備のサポートなどが提供されます。

ヒント

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

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

統合されたプロジェクト名、成果物 ID、およびプロパティを備えた統合開発エクスペリエンス。
1 つの spring-cloud-azure-dependencies 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、Storage Blob、Storage Queue のマネージド ID のサポート。
Spring ライブラリから基になる Azure SDK の認証方法 (SAS トークン、Service Bus と Event Hubs を使用したトークン資格情報認証など) の継続的なサポート。
資格情報チェーンが既定で有効になり、アプリケーションがアプリケーションのプロパティ、環境変数、マネージド ID、IDE などから資格情報を取得できるようになりました。詳細については、『Java用Azure IDクライアントライブラリ』の「DefaultAzureCredential」セクションを参照してください。
セキュリティガバナンスと IT ポリシーへの準拠を向上させるための、リソースレベル (Service Bus キューなど) でのきめ細かいアクセス制御。
同期シナリオと非同期シナリオの両方で、Azure SDK クライアントの自動構成カバレッジが大幅に向上し、Spring-idiomatic の方法で公開されるその他のオプション。
Azure App Configuration、Event Hubs、Azure Cosmos DB、Key Vault、Storage BLOB、Storage Queue、Storage File の正常性インジケーターを追加しました。
すべての HTTP ベースの Azure SDK に対する Spring Cloud Sleuth のサポート。

4.0 の移行ガイド

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

作業の開始

依存関係の設定

部品表 (BOM)

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

Note

Spring Boot 3.x を使用している場合は、必ず spring-cloud-azure-dependencies のバージョンを 5.8.0 に設定してください。 spring-cloud-azure-dependencies のバージョンの詳細については、「使用する Spring Cloud Azure のバージョン」を参照してください。

スターターの依存関係

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

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

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

名前	説明
spring-cloud-azure-starter	自動構成のサポートを含むコアスターター。
spring-cloud-azure-starter-active-directory	Spring Security で Microsoft Entra ID を使用するためのスターター。
spring-cloud-azure-starter-active-directory-b2c	Spring Security で Azure Active Directory B2C を使用するためのスターター。
spring-cloud-azure-starter-appconfiguration	Azure App Configuration を使用するためのスターター。
spring-cloud-azure-starter-cosmos	Azure Cosmos DB を使用するためのスターター。
spring-cloud-azure-starter-eventhubs	Azure Event Hubs を使用するためのスターター。
spring-cloud-azure-starter-keyvault	Azure Key Vault を使用するためのスターター。
spring-cloud-azure-starter-keyvault-secrets	Azure Key Vault シークレットを使用するためのスターター。
spring-cloud-azure-starter-keyvault-certificates	Azure Key Vault 証明書を使用するためのスターター。
spring-cloud-azure-starter-servicebus	Azure Service Bus を使用するためのスターター。
spring-cloud-azure-starter-servicebus-jms	Azure Service Bus と JMS を使用するためのスターター。
spring-cloud-azure-starter-storage	Azure Storage を使用するためのスターター。
spring-cloud-azure-starter-storage-blob	Azure Storage Blob を使用するためのスターター。
spring-cloud-azure-starter-storage-file-share	Azure Storage ファイル共有を使用するためのスターター。
spring-cloud-azure-starter-storage-queue	Azure Storage キューを使用するためのスターター。
spring-cloud-azure-starter-actuator	運用環境の準備機能を提供する Spring Boot のアクチュエータを使用するためのスターター。

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

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

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

名前	説明
spring-cloud-azure-starter-integration-eventhubs	Azure Event Hubs と Spring Integration を使用するためのスターター。
spring-cloud-azure-starter-integration-servicebus	Azure Service Bus と Spring Integration を使用するためのスターター。
spring-cloud-azure-starter-integration-storage-queue	Azure Storage キューと Spring Integration を使用するためのスターター。

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

名前	説明
spring-cloud-azure-starter-stream-eventhubs	Azure Event Hubs と Spring Cloud Stream Binder を使用するためのスターター。
spring-cloud-azure-starter-stream-servicebus	Azure Service Bus と Spring Cloud Stream Binder を使用するためのスターター。

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

名前	説明
spring-cloud-azure-starter-jdbc-mysql	Microsoft Entra 認証を介して Azure MySQLs と JDBC を使用するためのスターター。

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

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

Spring Cloud Azure について

使用法を示すすべてのサンプルの一覧を準備しました。これらのサンプルについては、Spring Cloud Azure サンプルを参照してください。

次の方法で共有