Konfigurace Azure Spring Cloudu

Článek
12/21/2024

Tento článek se vztahuje na:✅ verze 4.19.0 ✅ verze 5.19.0

Tento článek popisuje všechny společné vlastnosti konfigurace Azure Spring Cloud.

Konfigurace pro každou sadu SDK služby Azure

Většinu sad SDK služby Azure je možné rozdělit do dvou kategorií podle typu přenosu: založené na protokolu HTTP nebo založeném na AMQP. Existují vlastnosti, které jsou společné pro všechny sady SDK, jako jsou objekty zabezpečení ověřování a nastavení prostředí Azure, nebo společné pro klienty založené na protokolu HTTP, jako je úroveň protokolování pro protokolování požadavků HTTP a odpovědí. V Spring Cloudu Azure 4.0 jsme přidali pět běžných kategorií vlastností konfigurace, které můžete zadat pro každou službu Azure.

Následující tabulka uvádí vlastnosti společné pro více služeb:

Vlastnost	Popis
spring.cloud.azure.azure-service.client	Konfiguruje přenosové klienty pod jednou sadou SDK služby Azure.
spring.cloud.azure.azure-service.credential	Konfiguruje ověřování s ID Microsoft Entra pro jednu sadu SDK služby Azure.
spring.cloud.azure.azure-service.profile	Nakonfiguruje cloudové prostředí Azure pro jednu sadu SDK služby Azure.
spring.cloud.azure.azure-service.proxy	Nakonfiguruje možnosti proxy serveru pro jednu sadu SDK služby Azure.
spring.cloud.azure.azure-service.retry	Nakonfiguruje možnosti opakování použitelné pro jednu sadu SDK služby Azure. Možnosti opakování podporují část sad SDK. Neexistuje žádná spring.cloud.azure.cosmos.retry.

Předpony vlastností konfigurace byly od verze Spring Cloud Azure 4.0 sjednocené s oborem názvů spring.cloud.azure, aby byly vlastnosti konfigurace konzistentnější a intuitivnější. Následující tabulka obsahuje rychlou kontrolu předpon pro podporované služby Azure:

Služba Azure	Předpona vlastnosti konfigurace	Propojení vlastností konfigurace
Azure App Configuration	spring.cloud.azure.appconfiguration	vlastnosti konfigurace konfigurace aplikace
Azure Cosmos DB	spring.cloud.azure.cosmos	vlastností konfigurace služby Azure Cosmos DB
Azure Event Hubs	spring.cloud.azure.eventhubs	vlastností konfigurace služby Event Hubs
Certifikát služby Azure Key Vault	spring.cloud.azure.keyvault.certificate	vlastnosti konfigurace certifikátů služby Key Vault
Tajný klíč služby Azure Key Vault	spring.cloud.azure.keyvault.secret	vlastnosti konfigurace tajných kódů služby Key Vault
Azure Service Bus	spring.cloud.azure.servicebus	vlastnosti konfigurace služby Service Bus
Azure Storage Blob	spring.cloud.azure.storage.blob	vlastnosti konfigurace objektů blob služby Storage
Sdílená složka azure Storage	spring.cloud.azure.storage.fileshare	vlastnosti konfigurace sdílené složky úložiště
Fronta služby Azure Storage	spring.cloud.azure.storage.queue	vlastnosti konfigurace fronty služby Storage

Globální konfigurace pro sady SDK služby Azure

Existují některé vlastnosti, které můžete sdílet mezi různými službami Azure, například použít stejný instanční objekt pro přístup ke službě Azure Cosmos DB a Azure Event Hubs. Spring Cloud Azure 4.0 umožňuje definovat vlastnosti, které se vztahují na všechny sady Azure SDK v oboru názvů spring.cloud.azure.

V následující tabulce jsou uvedeny globální vlastnosti:

Vlastnost	Popis
spring.cloud.azure.client	Konfiguruje přenosové klienty; platí pro všechny sady Azure SDK ve výchozím nastavení.
spring.cloud.azure.credential	Ve výchozím nastavení nakonfiguruje ověřování pomocí Microsoft Entra ID pro všechny sady Azure SDK.
spring.cloud.azure.profile	Nakonfiguruje cloudové prostředí Azure pro všechny sady Azure SDK ve výchozím nastavení.
spring.cloud.azure.proxy	Nakonfiguruje možnosti proxy serveru použitelné pro všechny klienty Sady Azure SDK ve výchozím nastavení.
spring.cloud.azure.retry	Nakonfiguruje možnosti opakování, které se ve výchozím nastavení vztahují na všechny klienty sady Azure SDK.

Poznámka

Vlastnosti nakonfigurované v rámci každé služby Azure přepíší globální konfigurace.

Příklady konfigurace

Globální konfigurace opakování pro sady SDK služby Azure

Následující příklad ukazuje, jak nakonfigurovat chování opakování pro libovolného klienta Azure SDK založeného na protokolu HTTP nebo AMQP:

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

Konfigurace opakování pro zdroj vlastností služby Key Vault

Následující příklad konfigurace ukazuje, jak nakonfigurovat chování opakování pro tajného klienta služby 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

Sdílet prostřednictvím