Конфигурация Spring Cloud Azure

Статья
10/23/2023

Эта статья относится к:✅ версии 4.19.0 ✅ версии 5.19.0

В этой статье описаны все общие свойства конфигурации Azure Spring Cloud.

Настройка для каждого пакета SDK службы Azure

Большинство пакетов SDK службы Azure можно разделить на две категории по типу транспорта: на основе HTTP или AMQP. Существуют свойства, которые являются общими для всех пакетов SDK, таких как субъекты проверки подлинности и параметры среды Azure, или общие для клиентов на основе HTTP, таких как уровень ведения журнала для журналов HTTP-запросов и ответов. В Spring Cloud Azure 4.0 мы добавили пять общих категорий свойств конфигурации, которые можно указать для каждой службы Azure.

В следующей таблице перечислены свойства, общие для нескольких служб:

Свойство	Описание
spring.cloud.azure.azure-service.client	Настраивает клиенты транспорта под одним пакетом SDK службы Azure.
spring.cloud.azure.azure-service.credential	Настраивает проверку подлинности с помощью идентификатора Microsoft Entra для одного пакета SDK службы Azure.
spring.cloud.azure.azure-service.profile	Настраивает облачную среду Azure для одного пакета SDK службы Azure.
spring.cloud.azure.azure-service.proxy	Настраивает параметры прокси-сервера для одного пакета SDK службы Azure.
spring.cloud.azure.azure-serviceповторная попытка	Настраивает параметры повторных попыток, применимые к одному пакету SDK службы Azure. Параметры повторных попыток поддерживают часть пакетов SDK, не существует spring.cloud.azure.cosmos.retry.

Префиксы свойств конфигурации унифицированы с пространством имен spring.cloud.azure с Spring Cloud Azure 4.0, чтобы сделать свойства конфигурации более согласованными и более понятными. В следующей таблице приведен краткий обзор префиксов для поддерживаемых служб Azure:

Служба Azure	Префикс свойства конфигурации	Ссылка на свойства конфигурации
Конфигурация приложений Azure	spring.cloud.azure.appconfiguration	свойства конфигурации конфигурации приложений
Azure Cosmos DB	spring.cloud.azure.cosmos	свойства конфигурации Azure Cosmos DB
Центры событий Azure	spring.cloud.azure.eventhubs	свойства конфигурации Центров событий
Сертификат Azure Key Vault	spring.cloud.azure.keyvault.certificate	свойства конфигурации сертификатов Key Vault
Секрет Azure Key Vault	spring.cloud.azure.keyvault.secret	свойства конфигурации секретов Key Vault
Служебная шина Azure	spring.cloud.azure.servicebus	свойства конфигурации служебной шины
BLOB-объект службы хранилища Azure	spring.cloud.azure.storage.blob	свойства конфигурации BLOB-объектов хранилища
Общая папка службы хранилища Azure	spring.cloud.azure.storage.fileshare	свойства конфигурации общей папки хранилища
Очередь службы хранилища Azure	spring.cloud.azure.storage.queue	Свойства конфигурации очереди хранилища

Глобальная конфигурация для пакетов SDK службы Azure

Существуют некоторые свойства, которые можно совместно использовать между различными службами Azure, например использовать один субъект-службу для доступа к Azure Cosmos DB и Центрам событий Azure. Spring Cloud Azure 4.0 позволяет определять свойства, которые применяются ко всем пакетам SDK Azure в пространстве имен spring.cloud.azure.

В следующей таблице перечислены глобальные свойства:

Свойство	Описание
spring.cloud.azure.client	Настраивает транспортные клиенты; Применяется ко всем пакетам SDK Azure по умолчанию.
spring.cloud.azure.credential	Настраивает проверку подлинности с помощью идентификатора Microsoft Entra для всех пакетов SDK Azure по умолчанию.
spring.cloud.azure.profile	Настраивает облачную среду Azure для всех пакетов SDK Azure по умолчанию.
spring.cloud.azure.proxy	Настраивает параметры прокси-сервера, применимые ко всем клиентам Пакета SDK Azure по умолчанию.
spring.cloud.azure.retry	Настраивает параметры повторных попыток, применимые ко всем клиентам пакета SDK Azure по умолчанию.

Заметка

Свойства, настроенные в каждой службе Azure, переопределяют глобальные конфигурации.

Примеры конфигурации

Глобальная настройка повторных попыток для пакетов SDK службы Azure

В следующем примере показано, как настроить поведение повторных попыток для любого клиента azure SDK на основе протокола HTTP или AMQP:

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

Настройка повтора для источника свойств Key Vault

В следующем примере конфигурации показано, как настроить поведение повторных попыток для клиента Секрета 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

Поделиться через