Spring Cloud Azure 구성

아티클
10/23/2023

이 문서는 버전 4.14.0 ✔️ 버전 5.8.0에 적용됩니다. ✔️

이 문서에서는 모든 Spring Cloud Azure 공통 구성 속성에 대해 설명합니다.

각 Azure 서비스 SDK에 대한 구성

대부분의 Azure 서비스 SDK는 전송 유형( HTTP 기반 또는 AMQP 기반)으로 나눌 수 있습니다. 인증 주체 및 Azure 환경 설정과 같은 모든 SDK에 공통적인 속성이 있거나 HTTP 요청 및 응답을 기록하는 로깅 수준과 같은 HTTP 기반 클라이언트에 공통적인 속성이 있습니다. Spring Cloud Azure 4.0에서는 각 Azure 서비스에 대해 지정할 수 있는 5가지 일반적인 구성 속성 범주를 추가했습니다.

다음 표에서는 여러 서비스에 공통적인 속성을 나열합니다.

속성	설명
spring.cloud.azure.azure-service.client	하나의 Azure 서비스 SDK 아래에 전송 클라이언트를 구성합니다.
spring.cloud.azure.azure-service.credential	하나의 Azure 서비스 SDK에 대한 Microsoft Entra ID로 인증을 구성합니다.
spring.cloud.azure.azure-service.profile	하나의 Azure 서비스 SDK에 대한 Azure 클라우드 환경을 구성합니다.
spring.cloud.azure.azure-service.proxy	하나의 Azure 서비스 SDK에 대한 프록시 옵션을 구성합니다.
spring.cloud.azure.azure-service.retry	하나의 Azure 서비스 SDK에 적용할 수 있는 재시도 옵션을 구성합니다. 다시 시도 옵션은 SDK의 일부를 지원하며 spring.cloud.azure.cosmos.retry는 없습니다.

구성 속성의 접두사는 Spring Cloud Azure 4.0부터 네임스페이스에 통합 spring.cloud.azure 되어 구성 속성을 보다 일관되고 직관적으로 만듭니다. 다음 표에서는 지원되는 Azure 서비스에 대한 접두사를 빠르게 검토합니다.

Azure 서비스	구성 속성 접두사	구성 속성 링크
Azure App Configuration	spring.cloud.azure.appconfiguration	App Configuration 구성 속성
Azure Cosmos DB	spring.cloud.azure.cosmos	Azure Cosmos DB 구성 속성
Azure Event Hubs	spring.cloud.azure.eventhubs	Event Hubs 구성 속성
Azure Key Vault 인증서	spring.cloud.azure.keyvault.certificate	Key Vault 인증서 구성 속성
Azure Key Vault 비밀	spring.cloud.azure.keyvault.secret	Key Vault 비밀 구성 속성
Azure Service Bus	spring.cloud.azure.servicebus	Service Bus 구성 속성
Azure Storage Blob	spring.cloud.azure.storage.blob	Storage Blob 구성 속성
Azure Storage 파일 공유	spring.cloud.azure.storage.fileshare	스토리지 파일 공유 구성 속성
Azure Storage Queue	spring.cloud.azure.storage.queue	스토리지 큐 구성 속성

Azure 서비스 SDK에 대한 전역 구성

예를 들어 동일한 서비스 주체를 사용하여 Azure Cosmos DB 및 Azure Event Hubs에 액세스하는 등 여러 Azure 서비스 간에 공유할 수 있는 몇 가지 속성이 있습니다. Spring Cloud Azure 4.0을 사용하면 네임스페이스의 모든 Azure SDK에 적용되는 속성을 정의할 수 있습니다 spring.cloud.azure.

다음 표에서는 전역 속성을 나열합니다.

속성	설명
spring.cloud.azure.client	전송 클라이언트를 구성합니다. 는 기본적으로 모든 Azure SDK에 적용됩니다.
spring.cloud.azure.credential	기본적으로 모든 Azure SDK에 대해 Microsoft Entra ID를 사용하여 인증을 구성합니다.
spring.cloud.azure.profile	기본적으로 모든 Azure SDK에 대한 Azure 클라우드 환경을 구성합니다.
spring.cloud.azure.proxy	기본적으로 모든 Azure SDK 클라이언트에 적용할 수 있는 프록시 옵션을 구성합니다.
spring.cloud.azure.retry	기본적으로 모든 Azure SDK 클라이언트에 적용할 수 있는 재시도 옵션을 구성합니다.

참고 항목

각 Azure 서비스에서 구성된 속성은 전역 구성을 재정의합니다.

구성 예

Azure 서비스 SDK에 대한 전역 재시도 구성

다음 예제에서는 모든 HTTP 또는 AMQP 프로토콜 기반 Azure SDK 클라이언트에 대한 재시도 동작을 구성하는 방법을 보여줍니다.

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