Spring Cloud Azure の構成
この記事は、✅ バージョン 4.19.0 ✅ バージョン 5.19.0 に適用されます。
この記事では、Spring Cloud Azure のすべての一般的な構成プロパティについて説明します。
各 Azure Service SDK の構成
Azure Service SDK のほとんどは、トランスポートの種類 (HTTP ベースと AMQP ベース) の 2 つのカテゴリに分けることができます。 認証プリンシパルや Azure 環境設定など、すべての SDK に共通のプロパティや、HTTP ベースのクライアントに共通のプロパティ (HTTP 要求と応答をログに記録するログ レベルなど) があります。 Spring Cloud Azure 4.0 では、Azure サービスごとに指定できる構成プロパティの 5 つの一般的なカテゴリが追加されました。
次の表に、複数のサービスに共通するプロパティを示します。
| 財産 | 形容 |
|---|---|
| spring.cloud.azure.azure-service.client | 1 つの Azure サービス SDK の下にトランスポート クライアントを構成します。 |
| spring.cloud.azure.azure-service.credential を |
1 つの Azure サービス SDK に対して Microsoft Entra ID を使用して認証を構成します。 |
| spring.cloud.azure.azure-service.profile | 1 つの Azure サービス SDK 用に Azure クラウド環境を構成します。 |
| spring.cloud.azure.azure-service.proxy | 1 つの Azure サービス SDK のプロキシ オプションを構成します。 |
| spring.cloud.azure.azure-service.retry | 1 つの Azure サービス SDK に適用できる再試行オプションを構成します。 再試行オプションは SDK の一部をサポートしており、spring.cloud.azure.cosmos.retry はありません。 |
構成プロパティのプレフィックスは、Spring Cloud Azure 4.0 以降、構成プロパティの一貫性と直感的性を高めるために、spring.cloud.azure 名前空間に統合されています。 次の表に、サポートされている Azure サービスのプレフィックスの簡単な確認を示します。
| Azure サービス | 構成プロパティのプレフィックス | [構成プロパティ] リンク |
|---|---|---|
| Azure App Configuration | spring.cloud.azure.appconfiguration を |
App Configuration の構成プロパティ |
| Azure Cosmos DB | spring.cloud.azure.cosmos | Azure Cosmos DB 構成プロパティの |
| Azure Event Hubs | spring.cloud.azure.eventhubs | Event Hubs 構成プロパティの |
| Azure Key Vault 証明書 | spring.cloud.azure.keyvault.certificate を |
Key Vault 証明書の構成プロパティ |
| Azure Key Vault シークレット | spring.cloud.azure.keyvault.secret | Key Vault シークレットの構成プロパティ |
| Azure Service Bus | spring.cloud.azure.servicebus | Service Bus 構成プロパティの |
| Azure Storage Blob | spring.cloud.azure.storage.blob | ストレージ BLOB 構成プロパティの |
| Azure Storage ファイル共有 | spring.cloud.azure.storage.fileshare を |
ストレージ ファイル共有の構成プロパティ |
| Azure Storage キュー | spring.cloud.azure.storage.queue を |
ストレージ キュー構成プロパティ を |
Azure Service SDK のグローバル構成
異なる Azure サービス間で共有できるプロパティがいくつかあります。たとえば、同じサービス プリンシパルを使用して Azure Cosmos DB と Azure Event Hubs にアクセスする場合などです。 Spring Cloud Azure 4.0 では、名前空間 spring.cloud.azure内のすべての Azure SDK に適用されるプロパティを定義できます。
次の表に、グローバル プロパティを示します。
| 財産 | 形容 |
|---|---|
| spring.cloud.azure.client を |
トランスポート クライアントを構成します。は、既定ですべての Azure SDK に適用されます。 |
| spring.cloud.azure.credential を |
既定では、すべての Azure SDK に対して Microsoft Entra ID を使用して認証を構成します。 |
| spring.cloud.azure.profile を |
既定では、すべての Azure SDK に対して Azure クラウド環境を構成します。 |
| spring.cloud.azure.proxy を |
既定では、すべての Azure SDK クライアントに適用できるプロキシ オプションを構成します。 |
| spring.cloud.azure.retry を |
既定では、すべての Azure SDK クライアントに適用できる再試行オプションを構成します。 |
手記
各 Azure サービスで構成されたプロパティは、グローバル構成をオーバーライドします。
構成の例
Azure Service SDK のグローバル再試行構成
次の例は、任意の HTTP または AMQP プロトコル ベースの Azure SDK クライアントの再試行動作を構成する方法を示しています。
spring.cloud.azure:
retry:
mode: exponential
exponential:
max-retries: 4
base-delay: PT0.0801S
max-delay: PT9S
Key Vault プロパティ ソースの構成を再試行する
次の構成例は、Azure Key Vault シークレット クライアントの再試行動作を構成する方法を示しています。
spring.cloud.azure:
keyvault:
secret:
property-source-enabled: true
property-sources:
- endpoint: <your-Azure-Key-Vault-endpoint>
retry:
mode: exponential
exponential:
max-retries: 4
base-delay: PT0.0801S
max-delay: PT9S