Configuração do Azure do Spring Cloud

Artigo
12/21/2024

Este artigo se aplica a:✅ versão 4.19.0 ✅ versão 5.19.0

Este artigo descreve todas as propriedades de configuração comuns do Spring Cloud Azure.

Configuração para cada SDK do Serviço do Azure

A maioria dos SDKs de Serviço do Azure pode ser dividida em duas categorias por tipo de transporte: baseada em HTTP ou AMQP. Há propriedades comuns a todos os SDKs, como entidades de autenticação e configurações de ambiente do Azure, ou comuns a clientes baseados em HTTP, como o nível de log para registrar em log solicitações e respostas HTTP. No Spring Cloud Azure 4.0, adicionamos cinco categorias comuns de propriedades de configuração que você pode especificar para cada serviço do Azure.

A tabela a seguir lista as propriedades comuns a vários serviços:

Propriedade	Descrição
spring.cloud.azure.azure-service.client	Configura os clientes de transporte abaixo de um SDK de serviço do Azure.
spring.cloud.azure.azure-service.credential	Configura a autenticação com a ID do Microsoft Entra para um SDK de serviço do Azure.
spring.cloud.azure.azure-service.profile	Configura o ambiente de nuvem do Azure para um SDK de serviço do Azure.
spring.cloud.azure.azure-service.proxy	Configura as opções de proxy para um SDK de serviço do Azure.
spring.cloud.azure.azure-service.retry	Configura as opções de repetição aplicáveis a um SDK de serviço do Azure. As opções de repetição têm suporte para parte dos SDKs, não há spring.cloud.azure.cosmos.retry.

Os prefixos das propriedades de configuração foram unificados para o namespace spring.cloud.azure desde o Spring Cloud Azure 4.0 para tornar as propriedades de configuração mais consistentes e mais intuitivas. A tabela a seguir fornece uma revisão rápida dos prefixos para serviços do Azure com suporte:

Serviço do Azure	Prefixo de propriedade de configuração	Link de propriedades de configuração
Configuração de Aplicativo do Azure	spring.cloud.azure.appconfiguration	propriedades de configuração da Configuração de Aplicativo
Azure Cosmos DB	spring.cloud.azure.cosmos	propriedades de configuração do Azure Cosmos DB
Hubs de Eventos do Azure	spring.cloud.azure.eventhubs	propriedades de configuração dos Hubs de Eventos
Certificado do Azure Key Vault	spring.cloud.azure.keyvault.certificate	propriedades de configuração de Certificados do Key Vault
Segredo do Azure Key Vault	spring.cloud.azure.keyvault.secret	propriedades de configuração de Segredos do Key Vault
Barramento de Serviço do Azure	spring.cloud.azure.servicebus	propriedades de configuração do Barramento de Serviço
Blob de Armazenamento do Azure	spring.cloud.azure.storage.blob	propriedades de configuração do Blob de Armazenamento
Compartilhamento de Arquivos de Armazenamento do Azure	spring.cloud.azure.storage.fileshare	propriedades de configuração do Compartilhamento de Arquivos de Armazenamento
Fila de Armazenamento do Azure	spring.cloud.azure.storage.queue	propriedades de configuração da Fila de Armazenamento

Configuração global para SDKs do Serviço do Azure

Há algumas propriedades que você pode compartilhar entre diferentes serviços do Azure, por exemplo, para usar a mesma entidade de serviço para acessar o Azure Cosmos DB e os Hubs de Eventos do Azure. O Spring Cloud Azure 4.0 permite definir propriedades que se aplicam a todos os SDKs do Azure no namespace spring.cloud.azure.

A tabela a seguir lista as propriedades globais:

Propriedade	Descrição
spring.cloud.azure.client	Configura os clientes de transporte; aplica-se a todos os SDKs do Azure por padrão.
credencial .azure spring.cloud.azure	Configura a autenticação com a ID do Microsoft Entra para todos os SDKs do Azure por padrão.
spring.cloud.azure.profile	Configura o ambiente de nuvem do Azure para todos os SDKs do Azure por padrão.
spring.cloud.azure.proxy	Configura as opções de proxy aplicáveis a todos os clientes do SDK do Azure por padrão.
spring.cloud.azure.retry	Configura as opções de repetição aplicáveis a todos os clientes do SDK do Azure por padrão.

Nota

As propriedades configuradas em cada serviço do Azure substituirão as configurações globais.

Exemplos de configuração

Configuração de repetição global para SDKs do Serviço do Azure

O exemplo a seguir mostra como configurar o comportamento de repetição para qualquer cliente do SDK do Azure baseado em protocolo HTTP ou AMQP:

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

Configuração de repetição para fonte de propriedade do Key Vault

O exemplo de configuração a seguir mostra como configurar o comportamento de repetição para o cliente do Segredo do 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

Compartilhar via