Spring Cloud Azure-configuratie

Artikel
10/23/2023

Dit artikel is van toepassing op: ✔️ versie 4.14.0 ✔️ versie 5.8.0

In dit artikel worden alle algemene configuratie-eigenschappen van Spring Cloud Azure beschreven.

Configuratie voor elke Azure Service SDK

De meeste Azure Service SDK's kunnen worden onderverdeeld in twee categorieën per transporttype: op HTTP of op BASIS van AMQP. Er zijn eigenschappen die gebruikelijk zijn voor alle SDK's, zoals verificatie-principals en Azure-omgevingsinstellingen, of veelvoorkomend voor HTTP-clients, zoals logboekregistratieniveau voor het vastleggen van HTTP-aanvragen en -antwoorden. In Spring Cloud Azure 4.0 hebben we vijf algemene configuratie-eigenschappen toegevoegd die u voor elke Azure-service kunt opgeven.

De volgende tabel bevat eigenschappen die gebruikelijk zijn voor meerdere services:

Eigenschappen	Beschrijving
spring.cloud.azure.azure-service.client	Hiermee configureert u de transportclients onder één Azure-service-SDK.
spring.cloud.azure.azure-service.credential	Hiermee configureert u verificatie met Microsoft Entra ID voor één Azure-service-SDK.
spring.cloud.azure.azure-service.profile	Hiermee configureert u de Azure-cloudomgeving voor één Azure-service-SDK.
spring.cloud.azure.azure-service.proxy	Hiermee configureert u de proxyopties voor één Azure-service-SDK.
spring.cloud.azure.azure-service.retry	Hiermee configureert u de opties voor opnieuw proberen die van toepassing zijn op één Azure-service-SDK. De opties voor opnieuw proberen hebben een ondersteund onderdeel van de SDK's. Er is geen spring.cloud.azure.cosmos.retry.

De voorvoegsels van de configuratie-eigenschappen zijn geïntegreerd in de spring.cloud.azure naamruimte sinds Spring Cloud Azure 4.0 om configuratie-eigenschappen consistenter en intuïtiever te maken. De volgende tabel bevat een beknopt overzicht van de voorvoegsels voor ondersteunde Azure-services:

Azure-service	Voorvoegsel van configuratie-eigenschap	Koppeling naar configuratie-eigenschappen
Azure App Configuration	spring.cloud.azure.appconfiguration	Configuratie-eigenschappen van app-configuratie
Azure Cosmos DB	spring.cloud.azure.cosmos	Configuratie-eigenschappen van Azure Cosmos DB
Azure Event Hubs	spring.cloud.azure.eventhubs	Configuratie-eigenschappen van Event Hubs
Azure Key Vault-certificaat	spring.cloud.azure.keyvault.certificate	Configuratie-eigenschappen van Key Vault-certificaten
Azure Key Vault-geheim	spring.cloud.azure.keyvault.secret	Configuratie-eigenschappen van Key Vault-geheimen
Azure Service Bus	spring.cloud.azure.servicebus	Service Bus-configuratie-eigenschappen
Azure Storage Blob	spring.cloud.azure.storage.blob	Eigenschappen van opslagblobconfiguratie
Azure Storage-bestandsshare	spring.cloud.azure.storage.fileshare	Configuratie-eigenschappen van opslagbestandsshare
Azure-opslagwachtrij	spring.cloud.azure.storage.queue	Configuratie-eigenschappen van opslagwachtrij

Globale configuratie voor Azure Service SDK's

Er zijn enkele eigenschappen die u kunt delen tussen verschillende Azure-services, bijvoorbeeld om dezelfde service-principal te gebruiken voor toegang tot Azure Cosmos DB en Azure Event Hubs. Met Spring Cloud Azure 4.0 kunt u eigenschappen definiëren die van toepassing zijn op alle Azure SDK's in de naamruimte spring.cloud.azure.

De volgende tabel bevat algemene eigenschappen:

Eigenschappen	Beschrijving
spring.cloud.azure.client	Hiermee configureert u de transportclients; is standaard van toepassing op alle Azure SDK's.
spring.cloud.azure.credential	Hiermee configureert u standaard verificatie met Microsoft Entra-id voor alle Azure SDK's.
spring.cloud.azure.profile	Hiermee configureert u standaard de Azure-cloudomgeving voor alle Azure SDK's.
spring.cloud.azure.proxy	Hiermee configureert u de proxyopties die standaard van toepassing zijn op alle Azure SDK-clients.
spring.cloud.azure.retry	Hiermee configureert u de opties voor opnieuw proberen die standaard van toepassing zijn op alle Azure SDK-clients.

Notitie

Eigenschappen die zijn geconfigureerd onder elke Azure-service, overschrijven de globale configuraties.

Configuratievoorbeelden

Globale configuratie voor opnieuw proberen voor Azure Service SDK's

In het volgende voorbeeld ziet u hoe u het gedrag voor opnieuw proberen configureert voor een HTTP- of AMQP-protocolgebaseerde Azure SDK-client:

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

Configuratie opnieuw proberen voor key vault-eigenschapsbron

In het volgende configuratievoorbeeld ziet u hoe u het gedrag voor opnieuw proberen voor de Azure Key Vault-geheime client configureert:

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

Delen via