Azure-konfiguration för Spring Cloud

Artikel
10/23/2023

Den här artikeln gäller för: ✔️ Version 4.14.0 ✔️ Version 5.8.0

I den här artikeln beskrivs alla vanliga konfigurationsegenskaper för Spring Cloud Azure.

Konfiguration för varje Azure Service SDK

De flesta Azure Service SDK:er kan delas in i två kategorier efter transporttyp: HTTP-baserade eller AMQP-baserade. Det finns egenskaper som är gemensamma för alla SDK:er, till exempel autentiseringsobjekt och Azure-miljöinställningar, eller som är gemensamma för HTTP-baserade klienter, till exempel loggningsnivå för att logga HTTP-begäranden och svar. I Spring Cloud Azure 4.0 lade vi till fem vanliga kategorier av konfigurationsegenskaper som du kan ange för varje Azure-tjänst.

I följande tabell visas egenskaper som är gemensamma för flera tjänster:

Property	beskrivning
spring.cloud.azure.azure-service.client	Konfigurerar transportklienterna under en Azure Service SDK.
spring.cloud.azure.azure-service.credential	Konfigurerar autentisering med Microsoft Entra-ID för en Azure-tjänst-SDK.
spring.cloud.azure.azure-service.profile	Konfigurerar Azure-molnmiljön för en Azure-tjänst-SDK.
spring.cloud.azure.azure-service.proxy	Konfigurerar proxyalternativen för en Azure-tjänst-SDK.
spring.cloud.azure.azure-service.retry	Konfigurerar de återförsöksalternativ som gäller för en Azure-tjänst-SDK. Återförsöksalternativen har stöd för en del av SDK:erna, det finns inget spring.cloud.azure.cosmos.retry.

Konfigurationsegenskapernas prefix har enhetligts till spring.cloud.azure namnområdet sedan Spring Cloud Azure 4.0 för att göra konfigurationsegenskaperna mer konsekventa och mer intuitiva. Följande tabell innehåller en snabb genomgång av prefixen för Azure-tjänster som stöds:

Azure-tjänst	Konfigurationsegenskapsprefix	Länk för konfigurationsegenskaper
Azure App Configuration	spring.cloud.azure.appconfiguration	Konfigurationsegenskaper för appkonfiguration
Azure Cosmos DB	spring.cloud.azure.cosmos	Konfigurationsegenskaper för Azure Cosmos DB
Azure Event Hubs	spring.cloud.azure.eventhubs	Konfigurationsegenskaper för Event Hubs
Azure Key Vault-certifikat	spring.cloud.azure.keyvault.certificate	Konfigurationsegenskaper för Key Vault-certifikat
Azure Key Vault-hemlighet	spring.cloud.azure.keyvault.secret	Konfigurationsegenskaper för Key Vault-hemligheter
Azure Service Bus	spring.cloud.azure.servicebus	Konfigurationsegenskaper för Service Bus
Azure Storage Blob	spring.cloud.azure.storage.blob	Konfigurationsegenskaper för Lagringsblob
Azure Storage-filresurs	spring.cloud.azure.storage.fileshare	Konfigurationsegenskaper för lagringsfilresurs
Azure Storage-kö	spring.cloud.azure.storage.queue	Konfigurationsegenskaper för lagringskö

Global konfiguration för Azure Service SDK:er

Det finns vissa egenskaper som du kan dela mellan olika Azure-tjänster, till exempel för att använda samma tjänsthuvudnamn för att få åtkomst till Azure Cosmos DB och Azure Event Hubs. Med Spring Cloud Azure 4.0 kan du definiera egenskaper som gäller för alla Azure SDK:er i namnområdet spring.cloud.azure.

I följande tabell visas globala egenskaper:

Property	beskrivning
spring.cloud.azure.client	Konfigurerar transportklienterna. gäller som standard för alla Azure SDK:er.
spring.cloud.azure.credential	Konfigurerar autentisering med Microsoft Entra-ID för alla Azure SDK:er som standard.
spring.cloud.azure.profile	Konfigurerar Azure-molnmiljön för alla Azure SDK:er som standard.
spring.cloud.azure.proxy	Konfigurerar de proxyalternativ som gäller för alla Azure SDK-klienter som standard.
spring.cloud.azure.retry	Konfigurerar de återförsöksalternativ som gäller för alla Azure SDK-klienter som standard.

Kommentar

Egenskaper som konfigureras under varje Azure-tjänst åsidosätter de globala konfigurationerna.

Exempel på konfigurationer

Global återförsökskonfiguration för Azure Service SDK:er

I följande exempel visas hur du konfigurerar återförsöksbeteendet för en HTTP- eller AMQP-protokollbaserad Azure SDK-klient:

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

Försök konfigurera igen för Key Vault-egenskapskällan

I följande konfigurationsexempel visas hur du konfigurerar återförsöksbeteendet för Azure Key Vault Secret-klienten:

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

Dela via