Spring Cloud Azure-Konfiguration

Artikel
10/23/2023

Dieser Artikel bezieht sich auf: ✔️ Version 4.14.0 ✔️ Version 5.8.0

In diesem Artikel werden alle allgemeinen Konfigurationseigenschaften von Spring Cloud Azure beschrieben.

Konfiguration für jedes Azure Service SDK

Die meisten Azure-Dienst-SDKs können nach Transporttyp in zwei Kategorien unterteilt werden: HTTP-basiert oder AMQP-basiert. Es gibt Eigenschaften, die allen SDKs gemeinsam sind, z. B. Authentifizierungsprinzipale und Azure-Umgebungseinstellungen oder für HTTP-basierte Clients, z. B. Protokollierungsebene zum Protokollieren von HTTP-Anforderungen und -Antworten. In Spring Cloud Azure 4.0 haben wir fünf allgemeine Kategorien von Konfigurationseigenschaften hinzugefügt, die Sie für jeden Azure-Dienst angeben können.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die für mehrere Dienste gemeinsam sind:

Eigenschaft	Beschreibung
spring.cloud.azure.azure-service.client	Konfiguriert die Transportclients unter einem Azure-Dienst-SDK.
spring.cloud.azure.azure-service.credential	Konfiguriert die Authentifizierung mit der Microsoft Entra-ID für ein Azure-Dienst-SDK.
spring.cloud.azure.azure-service.profile	Konfiguriert die Azure-Cloudumgebung für ein Azure-Dienst-SDK.
spring.cloud.azure.azure-service.proxy	Konfiguriert die Proxyoptionen für ein Azure-Dienst-SDK.
spring.cloud.azure.azure-service.retry	Konfiguriert die Wiederholungsoptionen, die für ein Azure-Dienst-SDK gelten. Die Wiederholungsoptionen haben einen Teil der SDKs unterstützt, es gibt keine spring.cloud.azure.cosmos.retry.

Die Präfixe der Konfigurationseigenschaften wurden seit Spring Cloud Azure 4.0 mit dem spring.cloud.azure Namespace vereinheitlicht, um Konfigurationseigenschaften konsistenter und intuitiver zu gestalten. Die folgende Tabelle enthält eine kurze Übersicht über die Präfixe für unterstützte Azure-Dienste:

Azure-Dienst	Präfix der Konfigurationseigenschaft	Verknüpfung mit Konfigurationseigenschaften
Azure App Configuration	spring.cloud.azure.appconfiguration	Konfigurationseigenschaften der App-Konfiguration
Azure Cosmos DB	spring.cloud.azure.cosmos	Azure Cosmos DB-Konfigurationseigenschaften
Azure Event Hubs	spring.cloud.azure.eventhubs	Event Hubs-Konfigurationseigenschaften
Azure Key Vault-Zertifikat	spring.cloud.azure.keyvault.certificate	Konfigurationseigenschaften von Key Vault-Zertifikaten
Azure Key Vault Secret	spring.cloud.azure.keyvault.secret	Key Vault Secrets-Konfigurationseigenschaften
Azure Service Bus	spring.cloud.azure.servicebus	Dienstbus-Konfigurationseigenschaften
Azure Storage Blob	spring.cloud.azure.storage.blob	Eigenschaften der Speicher-Blob-Konfiguration
Azure Storage File Share	spring.cloud.azure.storage.fileshare	Konfigurationseigenschaften der Speicherdateifreigabe
Azure Storage-Warteschlange	spring.cloud.azure.storage.queue	Konfigurationseigenschaften der Speicherwarteschlange

Globale Konfiguration für Azure Service SDKs

Es gibt einige Eigenschaften, die Sie für verschiedene Azure-Dienste freigeben können, z. B. um denselben Dienstprinzipal für den Zugriff auf Azure Cosmos DB und Azure Event Hubs zu verwenden. Mit Spring Cloud Azure 4.0 können Sie Eigenschaften definieren, die für alle Azure-SDKs im Namespace spring.cloud.azuregelten.

In der folgenden Tabelle sind globale Eigenschaften aufgeführt:

Eigenschaft	Beschreibung
spring.cloud.azure.client	Konfiguriert die Transportclients; gilt standardmäßig für alle Azure-SDKs.
spring.cloud.azure.credential	Konfiguriert standardmäßig die Authentifizierung mit microsoft Entra-ID für alle Azure-SDKs.
spring.cloud.azure.profile	Konfiguriert standardmäßig die Azure-Cloudumgebung für alle Azure-SDKs.
spring.cloud.azure.proxy	Konfiguriert standardmäßig die Proxyoptionen, die für alle Azure SDK-Clients gelten.
spring.cloud.azure.retry	Konfiguriert standardmäßig die Wiederholungsoptionen, die für alle Azure SDK-Clients gelten.

Hinweis

Eigenschaften, die unter jedem Azure-Dienst konfiguriert sind, überschreiben die globalen Konfigurationen.

Konfigurationsbeispiele

Globale Wiederholungskonfiguration für Azure Service SDKs

Das folgende Beispiel zeigt, wie Sie das Wiederholungsverhalten für einen beliebigen HTTP- oder AMQP-protokollbasierten Azure SDK-Client konfigurieren:

spring.cloud.azure:
  retry:
    mode: exponential
    exponential:
      max-retries: 4
      base-delay: PT0.0801S
      max-delay: PT9S

Wiederholungskonfiguration für key Vault-Eigenschaftsquelle

Das folgende Konfigurationsbeispiel zeigt, wie Sie das Wiederholungsverhalten für den geheimen Azure Key Vault-Client konfigurieren:

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

Freigeben über