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

A maioria dos SDKs de Serviço do Azure pode ser dividida em duas categorias por tipo de transporte: baseado em HTTP ou baseado em AMQP. Há propriedades que são 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 as propriedades comuns a vários serviços:

Property	Description
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 o Microsoft Entra ID 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 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 Spring Cloud Azure 4.0 para tornar as 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 de configuração	Link de propriedades de configuração
Configuração da Aplicação Azure	spring.cloud.azure.appconfiguration	Propriedades de configuração da Configuração do Aplicativo
BD do Cosmos para o Azure	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 dos Certificados do Cofre de Chaves
Segredo do Azure Key Vault	spring.cloud.azure.keyvault.secret	Propriedades de configuração do Key Vault Secrets
Azure Service Bus	spring.cloud.azure.servicebus	Propriedades de configuração do Service Bus
Azure Storage Blob	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 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 definir propriedades que se aplicam a todos os SDKs do Azure no namespace spring.cloud.azure.

A tabela a seguir lista as propriedades globais:

Property	Description
spring.cloud.azure.client	Configura os clientes de transporte; aplica-se a todos os SDKs do Azure por padrão.
spring.cloud.azure.credential	Configura a autenticação com o Microsoft Entra ID 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 de Serviço do Azure

O exemplo a seguir mostra como configurar o comportamento de repetição para qualquer cliente do 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 configuração para a origem da propriedade Key Vault

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

Partilhar via