Configuration d’Azure Spring Cloud

Cet article s’applique à : ✔️ Version 4.14.0 ✔️ Version 5.8.0

Cet article décrit toutes les propriétés de configuration courantes d’Azure Spring Cloud.

Configuration de chaque Kit de développement logiciel (SDK) du service Azure

La plupart des kits SDK azure Service peuvent être divisés en deux catégories par type de transport : basé sur HTTP ou AMQP. Il existe des propriétés communes à tous les kits SDK, tels que les principaux d’authentification et les paramètres d’environnement Azure, ou communes aux clients HTTP, comme le niveau de journalisation pour journaliser les requêtes et réponses HTTP. Dans Spring Cloud Azure 4.0, nous avons ajouté cinq catégories courantes de propriétés de configuration que vous pouvez spécifier pour chaque service Azure.

Le tableau suivant répertorie les propriétés communes à plusieurs services :

Propriété	Description
spring.cloud.azure.azure-service.client	Configure les clients de transport sous un sdk de service Azure.
spring.cloud.azure.azure-service.credential	Configure l’authentification avec l’ID Microsoft Entra pour un sdk de service Azure.
spring.cloud.azure.azure-service.profile	Configure l’environnement cloud Azure pour un sdk de service Azure.
spring.cloud.azure.azure-service.proxy	Configure les options de proxy pour un sdk de service Azure.
spring.cloud.azure.azure-service.retry	Configure les options de nouvelle tentative applicables à un sdk de service Azure. Les options de nouvelle tentative ont pris en charge une partie des kits SDK, il n’existe aucune tentative spring.cloud.azure.cosmos.retry.

Les préfixes des propriétés de configuration ont été unifiés à l’espace spring.cloud.azure de noms depuis Spring Cloud Azure 4.0 pour rendre les propriétés de configuration plus cohérentes et plus intuitives. Le tableau suivant fournit un aperçu rapide des préfixes pour les services Azure pris en charge :

Service Azure	Préfixe de propriété de configuration	Lien des propriétés de configuration
Azure App Configuration	spring.cloud.azure.appconfiguration	Propriétés de configuration d’App Configuration
Azure Cosmos DB	spring.cloud.azure.cosmos	Propriétés de configuration d’Azure Cosmos DB
Azure Event Hubs	spring.cloud.azure.eventhubs	Propriétés de configuration d’Event Hubs
Certificat Azure Key Vault	spring.cloud.azure.keyvault.certificate	Propriétés de configuration des certificats Key Vault
Azure Key Vault Secret	spring.cloud.azure.keyvault.secret	Propriétés de configuration des secrets Key Vault
Azure Service Bus	spring.cloud.azure.servicebus	Propriétés de configuration service Bus
Azure Storage Blob	spring.cloud.azure.storage.blob	propriétés de configuration d’objets blob Stockage
partage de fichiers Stockage Azure	spring.cloud.azure.storage.fileshare	propriétés de configuration de partage de fichiers Stockage
File d’attente de stockage Azure	spring.cloud.azure.storage.queue	propriétés de configuration de file d’attente Stockage

Configuration globale pour les Kits de développement logiciel (SDK) azure Service

Il existe certaines propriétés que vous pouvez partager entre différents services Azure, par exemple pour utiliser le même principal de service pour accéder à Azure Cosmos DB et Azure Event Hubs. Spring Cloud Azure 4.0 vous permet de définir des propriétés qui s’appliquent à tous les Kits de développement logiciel (SDK) Azure dans l’espace de noms spring.cloud.azure.

Le tableau suivant répertorie les propriétés globales :

Propriété	Description
spring.cloud.azure.client	Configure les clients de transport ; s’applique à tous les KITS de développement logiciel (SDK) Azure par défaut.
spring.cloud.azure.credential	Configure l’authentification avec l’ID Microsoft Entra pour tous les Kits de développement logiciel (SDK) Azure par défaut.
spring.cloud.azure.profile	Configure l’environnement cloud Azure pour tous les kits SDK Azure par défaut.
spring.cloud.azure.proxy	Configure les options de proxy applicables à tous les clients du Kit de développement logiciel (SDK) Azure par défaut.
spring.cloud.azure.retry	Configure les options de nouvelle tentative applicables à tous les clients du Kit de développement logiciel (SDK) Azure par défaut.

Remarque

Les propriétés configurées sous chaque service Azure remplacent les configurations globales.

Exemples de configuration

Configuration globale des nouvelles tentatives pour les kits SDK azure Service

L’exemple suivant montre comment configurer le comportement de nouvelle tentative pour n’importe quel client azure SDK basé sur le protocole HTTP ou AMQP :

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

Configuration de nouvelle tentative pour la source de propriété Key Vault

L’exemple de configuration suivant vous montre comment configurer le comportement de nouvelle tentative pour le client secret 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