Dokumentacja konfiguracji usługi Spring Cloud Azure

W tym artykule opisano wszystkie typowe właściwości konfiguracji rozwiązania Spring Cloud Azure, w tym ustawienia uwierzytelniania, transportu klienta, opcji serwera proxy, zachowania ponawiania prób i konfiguracji środowiska chmury w zestawach SDK Azure usługi opartych na protokole HTTP i amQP.

Konfiguracja dla każdego zestawu SDK usługi platformy Azure

Większość zestawów SDK usługi platformy Azure można podzielić na dwie kategorie według typu transportu: opartego na protokole HTTP lub opartego na protokole AMQP. Istnieją właściwości wspólne dla wszystkich zestawów SDK, takich jak jednostki uwierzytelniania i ustawienia środowiska platformy Azure, lub typowe dla klientów opartych na protokole HTTP, takie jak poziom rejestrowania w celu rejestrowania żądań HTTP i odpowiedzi. Począwszy od platformy Spring Cloud Azure 4.0, dodaliśmy pięć typowych kategorii właściwości konfiguracji, które można określić dla każdej usługi platformy Azure.

W poniższej tabeli wymieniono właściwości wspólne dla wielu usług:

Własność	Opis
spring.cloud.azure.azure-service.client	Konfiguruje klientów transportu poniżej jednego zestawu SDK usługi platformy Azure.
spring.cloud.azure.azure-service.credential	Konfiguruje uwierzytelnianie przy użyciu identyfikatora Entra firmy Microsoft dla jednego zestawu SDK usługi platformy Azure.
spring.cloud.azure.azure-service.profile	Konfiguruje środowisko chmury platformy Azure dla jednego zestawu SDK usługi platformy Azure.
spring.cloud.azure.azure-service.proxy	Konfiguruje opcje serwera proxy dla jednego zestawu SDK usługi platformy Azure.
spring.cloud.azure.azure-service.retry	Konfiguruje opcje ponawiania próby dotyczące jednego zestawu SDK usługi platformy Azure. Opcje ponawiania prób obsługują część zestawów SDK, nie ma spring.cloud.azure.cosmos.retryelementu .

Prefiksy właściwości konfiguracji zostały ujednolicone w przestrzeni nazw spring.cloud.azure od platformy Spring Cloud Azure 4.0, aby właściwości konfiguracji były bardziej spójne i bardziej intuicyjne. Poniższa tabela zawiera szybki przegląd prefiksów obsługiwanych usług platformy Azure:

Usługa platformy Azure	Prefiks właściwości konfiguracji	Link właściwości konfiguracji
Azure App Configuration	spring.cloud.azure.appconfiguration	właściwości konfiguracji usługi App Configuration
Azure Cosmos DB	spring.cloud.azure.cosmos	właściwości konfiguracji usługi Azure Cosmos DB
Azure Event Hubs	spring.cloud.azure.eventhubs	właściwości konfiguracji usługi Event Hubs
Certyfikat usługi Azure Key Vault	spring.cloud.azure.keyvault.certificate	właściwości konfiguracji certyfikatów usługi Key Vault
Wpis tajny usługi Azure Key Vault	spring.cloud.azure.keyvault.secret	właściwości konfiguracji wpisów tajnych usługi Key Vault
Azure Service Bus	spring.cloud.azure.servicebus	właściwości konfiguracji usługi Service Bus
Azure Storage Blob	spring.cloud.azure.storage.blob	właściwości konfiguracji obiektu blob usługi Storage
Udział plików usługi Azure Storage	spring.cloud.azure.storage.fileshare	właściwości konfiguracji udziału plików magazynu
Kolejka usługi Azure Storage	spring.cloud.azure.storage.queue	właściwości konfiguracji kolejki usługi Storage

Globalna konfiguracja zestawów SDK usługi platformy Azure

Istnieją pewne właściwości, które można udostępniać między różnymi usługami platformy Azure, na przykład aby użyć tej samej jednostki usługi w celu uzyskania dostępu do usług Azure Cosmos DB i Azure Event Hubs. Platforma Spring Cloud Azure 4.0 umożliwia definiowanie właściwości mających zastosowanie do wszystkich zestawów SDK platformy Azure w przestrzeni nazw spring.cloud.azure.

W poniższej tabeli wymieniono właściwości globalne:

Własność	Opis
spring.cloud.azure.client	Konfiguruje klientów transportu; domyślnie dotyczy wszystkich zestawów SDK platformy Azure.
spring.cloud.azure.credential	Konfiguruje uwierzytelnianie przy użyciu identyfikatora Entra firmy Microsoft dla wszystkich zestawów SDK platformy Azure domyślnie.
spring.cloud.azure.profile	Domyślnie konfiguruje środowisko chmury platformy Azure dla wszystkich zestawów SDK platformy Azure.
spring.cloud.azure.proxy	Domyślnie konfiguruje opcje serwera proxy dla wszystkich klientów zestawu Azure SDK.
spring.cloud.azure.retry	Domyślnie konfiguruje opcje ponawiania prób dla wszystkich klientów zestawu Azure SDK.

Nuta

Właściwości skonfigurowane w ramach każdej usługi platformy Azure zastąpią konfiguracje globalne.

Przykłady konfiguracji

Globalna konfiguracja ponawiania prób dla zestawów SDK usługi platformy Azure

W poniższym przykładzie pokazano, jak skonfigurować zachowanie ponawiania dla dowolnego klienta zestawu AZURE SDK opartego na protokole HTTP lub AMQP:

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

Ponów próbę konfiguracji źródła właściwości usługi Key Vault

W poniższym przykładzie konfiguracji pokazano, jak skonfigurować zachowanie ponawiania próby dla klienta wpisu tajnego usługi 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