Spring Cloud Azure-Konfiguration

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. Ab 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:

Eigentum	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 Konfigurationseigenschaftenpräfixe 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-Konfiguration	spring.cloud.azure.app-Konfiguration	Konfigurationseigenschaften der App-Konfiguration
Azure Cosmos DB (ein Microsoft-Datenbankdienst)	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
Geheimer Azure Key Vault-Schlüssel	spring.cloud.azure.keyvault.secret	Configuration Properties key Vault Secrets
Azure-Servicebus	spring.cloud.azure.servicebus	Service Bus-Konfigurationseigenschaften
Azure Storage Blob	spring.cloud.azure.storage.blob	Eigenschaften der Storage Blob-Konfiguration
Azure Storage-Dateifreigabe	spring.cloud.azure.storage.fileshare	Konfigurationseigenschaften für die Dateifreigabe
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:

Eigentum	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.

Anmerkung

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