Configuração do Spring Cloud Azure

Artigo
10/23/2023

Este artigo aplica-se a: ✔️ Versão 4.14.0 Versão 5.8.0 ✔️

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

Configuração para cada SDK de 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 nível de log para registrar 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 propriedades comuns a vários serviços:

Propriedade	Descrição
spring.cloud.azure.azure-service.client	Configura os clientes de transporte sob um SDK de serviço do Azure.
primavera.cloud.azure.azure-service.credential	Configura a autenticação com a ID do Microsoft Entra para um SDK de serviço do Azure.
primavera.cloud.azure.azure-service.profile	Configura o ambiente de nuvem do Azure para um SDK de serviço do Azure.
primavera.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 suportaram parte dos SDKs, não há spring.cloud.azure.cosmos.retry.

Os prefixos das propriedades de configuração foram unificados para o namespace desde o Spring Cloud Azure 4.0 para tornar as spring.cloud.azure propriedades de configuração mais consistentes e 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 da propriedade Configuration	Link de propriedades de configuração
Configuração de Aplicativo do Azure	spring.cloud.azure.appconfiguration	Propriedades de configuração do aplicativo
Azure Cosmos DB	primavera.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 Cofre de Chaves do Azure	spring.cloud.azure.keyvault.certificate	Propriedades de configuração dos Certificados do Cofre de Chaves
Segredo do Cofre de Chaves do Azure	primavera.cloud.azure.keyvault.secret	Propriedades de configuração do Key Vault Secrets
Barramento de Serviço do Azure	spring.cloud.azure.servicebus	Propriedades de configuração do Barramento de Serviço
O Azure Storage Blob	primavera.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	primavera.cloud.azure.storage.queue	Propriedades de configuração da fila de armazenamento

Configuração global para SDKs de 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 que você defina 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.
primavera.cloud.azure.credential	Configura a autenticação com a ID do Microsoft Entra para todos os SDKs do Azure por padrão.
primavera.cloud.azure.profile	Configura o ambiente de nuvem do Azure para todos os SDKs do Azure por padrão.
primavera.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.

Observação

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 de Serviço do Azure

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

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

Repetir a configuração da origem da propriedade Key Vault

O exemplo de configuração a seguir mostra como configurar o comportamento de repetição para o cliente Secreto do Cofre de Chaves do Azure:

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