Spring Cloud Azure-konfiguráció

Cikk
10/23/2023

Ez a cikk a következőre vonatkozik: ✔️ 4.14.0 ✔️ 5.8.0-s verzió

Ez a cikk a Spring Cloud Azure általános konfigurációs tulajdonságait ismerteti.

Konfiguráció az egyes Azure Service SDK-khoz

Az Azure Service SDK-k többsége két kategóriába sorolható átviteli típus szerint: HTTP-alapú vagy AMQP-alapú. Az összes SDK-ban vannak olyan tulajdonságok, mint például a hitelesítési tagok és az Azure környezeti beállításai, vagy a HTTP-alapú ügyfelek esetében gyakoriak, például a HTTP-kérések és válaszok naplózási szintje. A Spring Cloud Azure 4.0-ban öt általános konfigurációs kategóriát adtunk hozzá, amelyeket az egyes Azure-szolgáltatásokhoz megadhat.

Az alábbi táblázat a több szolgáltatásra jellemző tulajdonságokat sorolja fel:

Property	Leírás
spring.cloud.azure.azure-service.client	Konfigurálja az átviteli ügyfeleket egy Azure Service SDK alatt.
spring.cloud.azure.azure-service.credential	Egy Azure-szolgáltatás SDK-jának Microsoft Entra-azonosítójával konfigurálja a hitelesítést.
spring.cloud.azure.azure-service.profile	Egy Azure-szolgáltatás SDK-hoz konfigurálja az Azure-felhőkörnyezetet.
spring.cloud.azure.azure-service.proxy	Egy Azure Service SDK proxybeállításait konfigurálja.
spring.cloud.azure.azure-service.retry	Konfigurálja az egy Azure Service SDK-ra vonatkozó újrapróbálkozások beállításait. Az újrapróbálkozások beállításai támogatták az SDK-k egy részét, nincs spring.cloud.azure.cosmos.retry.

A konfigurációs tulajdonságok előtagja a Spring Cloud Azure 4.0 óta egységesítve van a spring.cloud.azure névtérben, így konzisztensebbé és intuitívabbá teheti a konfigurációs tulajdonságokat. Az alábbi táblázat a támogatott Azure-szolgáltatások előtagjainak gyors áttekintését tartalmazza:

Azure-szolgáltatás	Konfigurációs tulajdonság előtagja	Konfiguráció tulajdonságainak hivatkozása
Azure App Configuration	spring.cloud.azure.appconfiguration	Alkalmazáskonfiguráció konfigurációs tulajdonságai
Azure Cosmos DB	spring.cloud.azure.cosmos	Az Azure Cosmos DB konfigurációs tulajdonságai
Azure Event Hubs	spring.cloud.azure.eventhubs	Az Event Hubs konfigurációs tulajdonságai
Azure Key Vault-tanúsítvány	spring.cloud.azure.keyvault.certificate	Key Vault-tanúsítványok konfigurációs tulajdonságai
Az Azure Key Vault titkos kódja	spring.cloud.azure.keyvault.secret	A Key Vault titkos kulcsainak konfigurációs tulajdonságai
Azure Service Bus	spring.cloud.azure.servicebus	A Service Bus konfigurációs tulajdonságai
Azure Storage Blob	spring.cloud.azure.storage.blob	A Storage Blob konfigurációs tulajdonságai
Azure Storage-fájlmegosztás	spring.cloud.azure.storage.fileshare	Tárolási fájlmegosztás konfigurációs tulajdonságai
Azure Storage Queue	spring.cloud.azure.storage.queue	Tárolási várólista konfigurációs tulajdonságai

Az Azure Service SDK-k globális konfigurációja

Vannak olyan tulajdonságok, amelyeket megoszthat a különböző Azure-szolgáltatások között, például ugyanazt a szolgáltatásnevet használhatja az Azure Cosmos DB és az Azure Event Hubs eléréséhez. A Spring Cloud Azure 4.0 lehetővé teszi a névtérben spring.cloud.azurelévő összes Azure SDK-ra vonatkozó tulajdonságok meghatározását.

Az alábbi táblázat a globális tulajdonságokat sorolja fel:

Property	Leírás
spring.cloud.azure.client	Konfigurálja a szállítási ügyfeleket; alapértelmezés szerint az összes Azure SDK-ra vonatkozik.
spring.cloud.azure.credential	Alapértelmezés szerint minden Azure SDK-hoz Microsoft Entra-azonosítóval konfigurálja a hitelesítést.
spring.cloud.azure.profile	Alapértelmezés szerint minden Azure SDK-hoz konfigurálja az Azure-felhőkörnyezetet.
spring.cloud.azure.proxy	Alapértelmezés szerint az összes Azure SDK-ügyfélre vonatkozó proxybeállításokat konfigurálja.
spring.cloud.azure.retry	Alapértelmezés szerint az összes Azure SDK-ügyfélre vonatkozó újrapróbálkozási beállításokat konfigurálja.

Megjegyzés:

Az egyes Azure-szolgáltatásokban konfigurált tulajdonságok felülbírálják a globális konfigurációkat.

Példák konfigurációra

Az Azure Service SDK-k globális újrapróbálkozásának konfigurálása

Az alábbi példa bemutatja, hogyan konfigurálhatja az újrapróbálkozás viselkedését bármely HTTP- vagy AMQP-protokollalapú Azure SDK-ügyfél esetében:

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

A Key Vault tulajdonságforrásának újrapróbálkozásának konfigurálása

Az alábbi konfigurációs példa bemutatja, hogyan konfigurálhatja az Újrapróbálkozás viselkedését az Azure Key Vault Titkos ügyfélhez:

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

Share via