Konfigurace Azure Spring Cloudu

  • Článek

Tento článek se vztahuje na: ✔️ Verze 4.14.0 ✔️ verze 5.8.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 spring.cloud.azure názvů, 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 Vlastnosti konfigurace služby Azure Cosmos DB
Azure Event Hubs spring.cloud.azure.eventhubs Vlastnosti 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 úložiště

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