Configurazione di Spring Cloud Azure

Articolo
10/23/2023

Questo articolo si applica a: ✔️ Versione 4.14.0 ✔️ versione 5.8.0

Questo articolo descrive tutte le proprietà di configurazione comuni di Spring Cloud Di Azure.

Configurazione per ogni SDK del servizio di Azure

La maggior parte degli SDK del servizio di Azure può essere suddivisa in due categorie in base al tipo di trasporto: basato su HTTP o basato su AMQP. Esistono proprietà comuni a tutti gli SDK, ad esempio le entità di autenticazione e le impostazioni dell'ambiente di Azure, o comuni ai client basati su HTTP, ad esempio il livello di registrazione per registrare richieste e risposte HTTP. In Spring Cloud Azure 4.0 sono state aggiunte cinque categorie comuni di proprietà di configurazione che è possibile specificare per ogni servizio di Azure.

Nella tabella seguente sono elencate le proprietà comuni a più servizi:

Proprietà	Descrizione
spring.cloud.azure.azure-service.client	Configura i client di trasporto sotto un SDK del servizio di Azure.
spring.cloud.azure.azure-service.credential	Configura l'autenticazione con l'ID Microsoft Entra per un SDK di servizio di Azure.
spring.cloud.azure.azure-service.profile	Configura l'ambiente cloud di Azure per un SDK di servizio di Azure.
spring.cloud.azure.azure-service.proxy	Configura le opzioni proxy per un SDK di servizio di Azure.
spring.cloud.azure.azure-service.retry	Configura le opzioni di ripetizione dei tentativi applicabili a un SDK di servizio di Azure. Le opzioni di ripetizione dei tentativi hanno supportato parte degli SDK, senza spring.cloud.azure.cosmos.retry.

I prefissi delle proprietà di configurazione sono stati unificati allo spring.cloud.azure spazio dei nomi da Spring Cloud Azure 4.0 per rendere le proprietà di configurazione più coerenti e più intuitive. La tabella seguente fornisce una rapida revisione dei prefissi per i servizi di Azure supportati:

Servizio di Azure	Prefisso della proprietà di configurazione	Collegamento alle proprietà di configurazione
Configurazione app di Azure	spring.cloud.azure.appconfiguration	Configurazione app proprietà di configurazione
Azure Cosmos DB	spring.cloud.azure.cosmos	Proprietà di configurazione di Azure Cosmos DB
Hub eventi di Azure	spring.cloud.azure.eventhubs	Proprietà di configurazione di Hub eventi
Certificato di Azure Key Vault	spring.cloud.azure.keyvault.certificate	Proprietà di configurazione dei certificati dell'insieme di credenziali delle chiavi
Segreto di Azure Key Vault	spring.cloud.azure.keyvault.secret	Proprietà di configurazione dei segreti di Key Vault
Bus di servizio di Azure	spring.cloud.azure.servicebus	bus di servizio proprietà di configurazione
BLOB del servizio di archiviazione di Azure	spring.cloud.azure.storage.blob	Archiviazione proprietà di configurazione BLOB
Archiviazione di Azure condivisione file	spring.cloud.azure.storage.fileshare	Archiviazione proprietà di configurazione di Condivisione file
Coda di archiviazione di Azure	spring.cloud.azure.storage.queue	proprietà di configurazione della coda Archiviazione

Configurazione globale per gli SDK del servizio di Azure

Esistono alcune proprietà che è possibile condividere tra diversi servizi di Azure, ad esempio per usare la stessa entità servizio per accedere ad Azure Cosmos DB e Hub eventi di Azure. Spring Cloud Azure 4.0 consente di definire proprietà applicabili a tutti gli SDK di Azure nello spazio dei nomi spring.cloud.azure.

Nella tabella seguente sono elencate le proprietà globali:

Proprietà	Descrizione
spring.cloud.azure.client	Configura i client di trasporto; si applica a tutti gli SDK di Azure per impostazione predefinita.
spring.cloud.azure.credential	Configura l'autenticazione con Microsoft Entra ID per tutti gli SDK di Azure per impostazione predefinita.
spring.cloud.azure.profile	Configura l'ambiente cloud di Azure per tutti gli SDK di Azure per impostazione predefinita.
spring.cloud.azure.proxy	Configura le opzioni proxy applicabili a tutti i client Azure SDK per impostazione predefinita.
spring.cloud.azure.retry	Configura le opzioni di ripetizione dei tentativi applicabili a tutti i client Azure SDK per impostazione predefinita.

Nota

Le proprietà configurate in ogni servizio di Azure sostituiranno le configurazioni globali.

Esempi di configurazione

Configurazione di ripetizione dei tentativi globali per gli SDK del servizio di Azure

L'esempio seguente illustra come configurare il comportamento di ripetizione dei tentativi per qualsiasi client Azure SDK basato su protocollo HTTP o AMQP:

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

Riprovare la configurazione per l'origine delle proprietà di Key Vault

L'esempio di configurazione seguente illustra come configurare il comportamento di ripetizione dei tentativi per il client segreto di 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

Condividi tramite