Spring Cloud Azure-konfiguráció

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-tól kezdve ö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:

Ingatlan	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, hogy a konfigurációs tulajdonságok konzisztensebbek és intuitívabbak legyenek. 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-alkalmazáskonfiguráció	spring.cloud.azure.appconfiguration	alkalmazáskonfiguráció konfigurációs tulajdonságai
Azure Cosmos DB (adatbázis)	spring.cloud.azure.cosmos	Azure Cosmos DB konfigurációs tulajdonságai
Azure-eseményközpontok	spring.cloud.azure.eventhubs	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	Key Vault titkos kulcskonfigurációs tulajdonságainak
Azure Service Bus (Azure Szolgáltatási Busz)	spring.cloud.azure.servicebus	Service Bus konfigurációs tulajdonságai
Azure Storage-blob	spring.cloud.azure.storage.blob	Storage Blob konfigurációs tulajdonságai
Azure Storage-fájlmegosztás	spring.cloud.azure.storage.fileshare	Storage-fájlmegosztás konfigurációs tulajdonságai
Azure Storage-üzenetsor	spring.cloud.azure.storage.queue	Tárolósor 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 az összes Azure SDK-ra vonatkozó tulajdonságok meghatározását a névtérben spring.cloud.azure.

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

Ingatlan	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.

Jegyzet

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

Konfigurációs példák

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