Configuración de Azure de Spring Cloud

Artículo
12/21/2024

Este artículo se aplica a:✅ versión 4.19.0 ✅ versión 5.19.0

En este artículo se describen todas las propiedades de configuración comunes de Azure de Spring Cloud.

Configuración para cada SDK de servicio de Azure

La mayoría de los SDK de servicio de Azure se pueden dividir en dos categorías por tipo de transporte: basado en HTTP o basado en AMQP. Hay propiedades comunes a todos los SDK, como las entidades de seguridad de autenticación y la configuración del entorno de Azure, o comunes a los clientes basados en HTTP, como el nivel de registro para registrar solicitudes y respuestas HTTP. En Spring Cloud Azure 4.0, hemos agregado cinco categorías comunes de propiedades de configuración que puede especificar para cada servicio de Azure.

En la tabla siguiente se enumeran las propiedades comunes a varios servicios:

Propiedad	Descripción
spring.cloud.azure.azure-service.client	Configura los clientes de transporte debajo de un SDK de servicio de Azure.
spring.cloud.azure.azure-service.credential	Configura la autenticación con el identificador de Microsoft Entra para un SDK de servicio de Azure.
spring.cloud.azure.azure-service.profile	Configura el entorno en la nube de Azure para un SDK de servicio de Azure.
spring.cloud.azure.azure-service.proxy	Configura las opciones de proxy para un SDK de servicio de Azure.
spring.cloud.azure.azure-service.retry	Configura las opciones de reintento aplicables a un SDK de servicio de Azure. Las opciones de reintento son compatibles con parte de los SDK, no hay ningún spring.cloud.azure.cosmos.retry.

Los prefijos de las propiedades de configuración se han unificado al espacio de nombres spring.cloud.azure desde Spring Cloud Azure 4.0 para que las propiedades de configuración sean más coherentes e intuitivas. En la tabla siguiente se proporciona una revisión rápida de los prefijos para los servicios de Azure compatibles:

Servicio de Azure	Prefijo de propiedad de configuración	Vínculo de propiedades de configuración
Azure App Configuration	spring.cloud.azure.appconfiguration	propiedades de configuración de App Configuration
Azure Cosmos DB	spring.cloud.azure.cosmos	propiedades de configuración de Azure Cosmos DB
Azure Event Hubs	spring.cloud.azure.eventhubs	propiedades de configuración de Event Hubs
Certificado de Azure Key Vault	spring.cloud.azure.keyvault.certificate	propiedades de configuración certificados de Key Vault
Secreto de Azure Key Vault	spring.cloud.azure.keyvault.secret	propiedades de configuración de secretos de Key Vault
Azure Service Bus	spring.cloud.azure.servicebus	propiedades de configuración de Service Bus
Azure Storage Blob	spring.cloud.azure.storage.blob	propiedades de configuración de Blob de Storage
Recurso compartido de archivos de Azure Storage	spring.cloud.azure.storage.fileshare	propiedades de configuración del recurso compartido de archivos de almacenamiento
Cola de Azure Storage	spring.cloud.azure.storage.queue	propiedades de configuración de cola de Storage

Configuración global de los SDK de servicio de Azure

Hay algunas propiedades que puede compartir entre distintos servicios de Azure, por ejemplo, usar la misma entidad de servicio para acceder a Azure Cosmos DB y Azure Event Hubs. Spring Cloud Azure 4.0 permite definir propiedades que se aplican a todos los SDK de Azure del espacio de nombres spring.cloud.azure.

En la tabla siguiente se enumeran las propiedades globales:

Propiedad	Descripción
spring.cloud.azure.client	Configura los clientes de transporte; se aplica a todos los SDK de Azure de forma predeterminada.
spring.cloud.azure.credential	Configura la autenticación con el identificador de Microsoft Entra para todos los SDK de Azure de forma predeterminada.
spring.cloud.azure.profile	Configura el entorno de nube de Azure para todos los SDK de Azure de forma predeterminada.
spring.cloud.azure.proxy	Configura las opciones de proxy aplicables a todos los clientes del SDK de Azure de forma predeterminada.
spring.cloud.azure.retry	Configura las opciones de reintento aplicables a todos los clientes del SDK de Azure de forma predeterminada.

Nota

Las propiedades configuradas en cada servicio de Azure invalidarán las configuraciones globales.

Ejemplos de configuración

Configuración de reintento global para sdk de servicio de Azure

En el ejemplo siguiente se muestra cómo configurar el comportamiento de reintento para cualquier cliente de Azure SDK basado en protocolo HTTP o AMQP:

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

Configuración de reintento para el origen de propiedades de Key Vault

En el ejemplo de configuración siguiente se muestra cómo configurar el comportamiento de reintento para el cliente secreto de 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

Compartir a través de