Spring Cloud Azure 4.0 마이그레이션 가이드

이 가이드는 레거시 Azure Spring 라이브러리에서 Spring Cloud Azure 4.0으로 마이그레이션하는 데 도움이 됩니다.

소개

그룹 ID 및 아티팩트 ID가 com.azure.spring:spring-cloud-azure-* 라이브러리와 패턴 , com.azure.spring:azure-spring-boot-*또는 com.azure.spring:azure-spring-cloud-* 라이브러리를 com.azure.spring:azure-spring-integration-* 패턴을 따르는 라이브러리를 호출합니다.

이 가이드에서는 최신 라이브러리와 레거시 라이브러리 간의 유사한 구성에 대해 나란히 비교하는 데 중점을 줍니다.

com.azure.spring:azure-spring-boot-*, com.azure.spring:azure-spring-cloud-* 또는 com.azure.spring:azure-spring-integration-* 패키지에 대해 잘 알고 있다고 가정합니다.

Spring Cloud Azure 4.0 라이브러리를 접하는 경우 이 가이드 대신 Spring Cloud Azure 개발자 가이드를 참조하세요.

마이그레이션 혜택

새 버전 또는 라이브러리를 채택할지 여부를 고려할 때 묻는 자연스러운 질문은 그 이점입니다. Azure 더 다양한 개발자 그룹이 성숙하고 수용함에 따라 개발자 생산성을 가장 잘 지원하고 Spring Cloud Azure 라이브러리의 격차를 이해하기 위한 패턴과 사례를 배우는 데 중점을 두어 왔습니다.

Spring Cloud Azure 라이브러리 전반에 걸쳐 일관된 피드백이 표현된 몇 가지 영역이 있었습니다. 가장 중요한 것은 다른 Azure 서비스에 대한 라이브러리가 전체 구성 집합을 사용하도록 설정하지 않았다는 것입니다. 또한 프로젝트 명명, 아티팩트 ID, 버전 및 구성의 불일치로 인해 학습 곡선이 가파르게 증가했습니다.

Spring Cloud Azure 라이브러리의 개발 환경을 개선하기 위해 Spring Cloud Azure 라이브러리가 Spring 에코시스템과 관련하여 자연스럽고 공생적인 느낌을 갖도록 하기 위한 일련의 디자인 지침이 도입되었습니다. 자세한 내용은 디사인 문서 참조하세요.

Spring Cloud Azure 4.0은 다양한 Spring 프로젝트(예: Spring Boot, Spring Integration, Spring Cloud Stream 등)와 통합된 라이브러리 간에 공유 환경을 제공합니다. 공유 환경에는 다음이 포함됩니다.

• 모든 Spring Cloud Azure 4.0 라이브러리를 포함하는 통합 BOM입니다.
• 아티팩트에서 일관된 명명 규칙입니다.
• 자격 증명, 프록시, 다시 시도, 클라우드 환경 및 전송 계층 설정을 구성하는 통합된 방법입니다.
• Azure Service 또는 Azure Service SDK에서 지원하는 모든 인증 방법을 지원합니다.

개요

이 마이그레이션 가이드는 다음 섹션으로 구성됩니다.

• Spring Cloud Azure 4.0의 이름 변경 내용
• 아티팩트 변경 내용: 이름 바꾸기/추가/삭제됨
• 종속성 변경
• 인증 변경 내용
• 구성 속성
• API 호환성이 손상되는 변경
• 라이브러리 변경 내용

이름 변경 내용

모든 Spring Cloud Azure 라이브러리를 호출하는 일관되거나 공식적인 이름은 없었습니다. 그들 중 일부는 Azure Spring Boot 호출되었고 그 중 일부는 Spring on Azure. 4.0부터 프로젝트 이름 Spring Cloud Azure 사용하여 모든 Azure Spring 라이브러리를 나타내기 시작했습니다.

증권 시세 표시기

우리는 라이브러리에 대한 두 개의 BOM, azure-spring-boot-bom 및 azure-spring-cloud-dependencies배송하는 데 사용했지만, 이 두 BOM을 4.0 이후 하나의 BOM으로 결합하여 spring-cloud-azure-dependencies. 종속성 관리를 활용하려면 프로젝트의 dependencyManagement 섹션에 항목을 추가합니다.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.azure.spring</groupId>
      <artifactId>spring-cloud-azure-dependencies</artifactId>
      <version>7.3.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

아티팩트 변경 내용: 이름 바꾸기/추가/삭제됨

그룹 ID는 최신 및 레거시 Spring Cloud Azure 라이브러리와 동일합니다. 그들은 모두 com.azure.spring. 최신 Spring Cloud Azure 라이브러리의 아티팩트 ID가 변경되었습니다. Spring Boot, Spring Integration 또는 Spring Cloud Stream에 속하는 Spring 프로젝트에 따라 아티팩트 ID 패턴은 spring-cloud-azure-starter-[service], spring-integration-azure-[service]또는 spring-cloud-azure-stream-binder-[service]수 있습니다. 각각에 대한 레거시 시작에는 패턴 azure-spring-*따르는 아티팩트 ID가 있습니다. 이를 통해 최신 스타터 또는 레거시 스타터를 사용하는지 여부를 한눈에 이해할 수 있는 빠르고 접근성 있는 수단을 제공합니다.

Spring Cloud Azure 4.0을 개발하는 과정에서 새로운 명명 규칙을 따르도록 일부 아티팩트 이름을 변경하고, 기능을 보다 적절한 아티팩트로 삽입할 수 있도록 일부 아티팩트를 삭제하고, 일부 시나리오를 보다 효율적으로 처리하기 위해 몇 가지 새로운 아티팩트를 추가했습니다.

다음 표에서는 레거시 아티팩트 ID와 최신 아티팩트 ID 간의 매핑을 보여 줍니다.

종속성 변경

일부 불필요한 종속성이 레거시 아티팩트에서 포함되었으며, 최신 Spring Cloud Azure 4.0 라이브러리에서 제거했습니다. 충돌을 방지하기 위해 제거된 종속성을 프로젝트에 수동으로 추가해야 합니다.

종속성이 변경된 라이브러리는 다음과 같습니다.

• spring-cloud-azure-starter
• spring-cloud-azure-starter-active-directory
• spring-cloud-azure-starter-active-directory-b2c

인증 변경 내용

Spring Cloud Azure 4.0은 각 Azure Service SDK에서 지원하는 모든 인증 방법을 지원합니다. 전역 토큰 자격 증명을 구성할 뿐만 아니라 각 서비스 수준에서 토큰 자격 증명을 제공할 수 있습니다. 그러나 로컬 개발 환경에 저장된 자격 증명 또는 Azure Services의 관리 ID를 적용할 수 있으므로 Spring Cloud Azure 4.0을 구성하는 데 자격 증명이 필요하지 않습니다. 보안 주체에게 대상 Azure 리소스에 액세스할 수 있는 충분한 권한이 부여되었는지 확인합니다.

연결된 자격 증명인 DefaultAzureCredential 콩은 기본적으로 자동으로 구성되며 인증 정보가 더 이상 지정되지 않은 경우 모든 구성 요소에서 사용됩니다. 자세한 내용은 Java Azure ID 클라이언트 라이브러리의 DefaultAzureCredential 섹션을 참조하세요.

구성 속성

속성 마이그레이션

를 사용할 additional-spring-configuration-metadata.json때 속성 마이그레이션을 원활하게 하기 위해 파일을 만들었습니다spring-boot-properties-migrator. 먼저 애플리케이션에 다음 속성 마이그레이션기를 추가합니다.

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-properties-migrator</artifactId>
    <scope>runtime</scope>
</dependency>

또는 Gradle을 사용하는 경우:

runtime("org.springframework.boot:spring-boot-properties-migrator")

앱을 실행하면 Spring Cloud Azure 더 이상 관리되지 않는 속성을 식별합니다. 대체 항목이 있는 경우 경고와 함께 속성을 일시적으로 다시 매핑합니다. 대체 항목이 없으면 오류 보고서에 자세한 정보가 표시됩니다. 어느 쪽이든 구성을 업데이트한 후 구성을 업데이트하고 종속성을 제거해야 합니다.

계속 진행하기 전에 IDE의 검색 기능을 사용하여 통합 테스트에서 마이그레이션한 속성 중 하나를 사용하지 않는지 다시 확인하는 것이 좋습니다.

전역 구성

최신 spring-cloud-azure-starter 사용하면 네임스페이스 spring.cloud.azure 모든 Azure SDK 적용되는 속성을 정의할 수 있습니다. 이 기능은 레거시 azure-spring-boot-starter지원되지 않았습니다. 전역 구성은 다음 표와 같이 다섯 가지 범주로 나눌 수 있습니다.

구성의 전체 목록은 Spring Cloud Azure 구성 속성 참조하세요.

각 SDK 구성

SDK 수준의 구성 옵션에 대한 자세한 내용은 다음 링크를 사용합니다.

• 다음으로 azure-spring-boot-starter-active-directoryspring-cloud-azure-starter-active-directory
• 다음으로 azure-spring-boot-starter-active-directory-b2cspring-cloud-azure-starter-active-directory-b2c
• 다음으로 azure-spring-boot-starter-cosmosspring-cloud-azure-starter-data-cosmos
• 다음으로 azure-spring-boot-starter-keyvault-secretsspring-cloud-azure-starter-keyvault-secrets
• 다음으로 azure-spring-boot-starter-servicebus-jmsspring-cloud-azure-starter-servicebus-jms
• 다음으로 azure-spring-boot-starter-storagespring-cloud-azure-starter-storage-blob
• 다음으로 azure-spring-boot-starter-storagespring-cloud-azure-starter-storage-file-share
• 다음으로 azure-spring-cloud-starter-eventhubsspring-cloud-azure-starter-integration-eventhubs
• 다음으로 azure-spring-cloud-starter-servicebusspring-cloud-azure-starter-integration-servicebus
• 다음으로 azure-spring-cloud-starter-storage-queuespring-cloud-azure-starter-integration-storage-queue
• 다음으로 azure-spring-cloud-stream-binder-eventhubsspring-cloud-azure-stream-binder-eventhubs
• 다음으로 azure-spring-cloud-stream-binder-servicebus-*spring-cloud-azure-stream-binder-servicebus

API 호환성이 손상되는 변경

각 라이브러리의 API 호환성이 손상되는 변경에 대한 자세한 내용은 다음 링크를 사용합니다.

• 다음으로 azure-spring-boot-starter-active-directoryspring-cloud-azure-starter-active-directory
• 다음으로 azure-spring-boot-starter-active-directory-b2cspring-cloud-azure-starter-active-directory-b2c
• 다음으로 azure-spring-boot-starter-storagespring-cloud-azure-starter-storage-blob
• 다음으로 azure-spring-boot-starter-storagespring-cloud-azure-starter-storage-file-share
• 다음으로 azure-spring-cloud-starter-eventhubsspring-cloud-azure-starter-integration-eventhubs
• 다음으로 azure-spring-integration-eventhubsspring-integration-azure-eventhubs
• 다음으로 azure-spring-cloud-starter-servicebusspring-cloud-azure-starter-integration-servicebus
• 다음으로 azure-spring-integration-servicebusspring-integration-azure-servicebus
• 다음으로 azure-spring-cloud-starter-storage-queuespring-cloud-azure-starter-integration-storage-queue
• 다음으로 azure-spring-integration-storage-queuespring-integration-azure-storage-queue
• 다음으로 azure-spring-cloud-stream-binder-eventhubsspring-cloud-azure-stream-binder-eventhubs
• 다음으로 azure-spring-cloud-stream-binder-servicebus-*spring-cloud-azure-stream-binder-servicebus

라이브러리 변경 내용

각 라이브러리의 주요 변경 내용은 다음과 같이 도입됩니다.

azure-spring-boot-starter부터 spring-cloud-azure-starter까지

이 가이드는 버전 3spring-cloud-azure-starter에서 마이그레이션을 azure-spring-boot-starter 지원하기 위한 것입니다.

일반 정보는 다음 링크를 사용합니다.

• 4.0의 변경 내용에 대한 개요는 소개 및 마이그레이션 혜택 섹션을 참조하세요.
• 프로젝트 명명의 전략 변경에 대한 자세한 내용은 명명 변경 섹션을 참조하세요.
• 모든 Spring Cloud Azure 라이브러리에 하나의 BOM을 사용하는 방법을 알아보려면 BOM 섹션을 참조하세요.
• Spring Cloud Azure 4.0에서 인증을 처리하는 방법을 알아보려면 인증 변경 섹션을 참조하세요.
• 마이그레이션 중에 spring-boot-properties-migrator 활용하는 방법을 알아보려면 각 SDK 구성 섹션을 참조하세요.
• 전역 및 일반적인 구성 변경에 대한 자세한 내용은 전역 구성 섹션을 참조하세요.

종속성 변경

일부 불필요한 종속성이 레거시 아티팩트에서 포함되었으며, 최신 Spring Cloud Azure 4.0 라이브러리에서 제거되었습니다. 의도하지 않은 충돌을 방지하려면 제거된 종속성을 프로젝트에 수동으로 추가해야 합니다.

다음 표에서는 제거된 종속성을 보여줍니다.

azure-spring-boot-starter-active-directory부터 spring-cloud-azure-starter-active-directory까지

이 가이드는 버전 3spring-cloud-azure-starter-active-directory에서 마이그레이션을 azure-spring-boot-starter-active-directory 지원하기 위한 것입니다.

일반 정보는 다음 링크를 사용합니다.

• 4.0의 변경 내용에 대한 개요는 소개 및 마이그레이션 혜택 섹션을 참조하세요.
• 프로젝트 명명의 전략 변경에 대한 자세한 내용은 명명 변경 섹션을 참조하세요.
• 모든 Spring Cloud Azure 라이브러리에 하나의 BOM을 사용하는 방법을 알아보려면 BOM 섹션을 참조하세요.
• Spring Cloud Azure 4.0에서 인증을 처리하는 방법을 알아보려면 인증 변경 섹션을 참조하세요.
• 마이그레이션 중에 spring-boot-properties-migrator 활용하는 방법을 알아보려면 각 SDK 구성 섹션을 참조하세요.
• 전역 및 일반적인 구성 변경에 대한 자세한 내용은 전역 구성 섹션을 참조하세요.

종속성 변경

최신 Spring Cloud Azure 4.0 라이브러리 이후 레거시 아티팩트에서 일부 불필요한 종속성이 제거되었습니다. 이러한 제거된 종속성을 프로젝트에 추가하여 의도하지 않은 충돌을 방지합니다.

다음 표에서는 제거된 종속성을 보여줍니다.

SDK 구성 변경 내용

이 섹션에는 추가, 제거 및 변경된 속성에 대한 변경 내용이 포함되어 있습니다.

• 다음 두 가지 사항은 주의해야 할 주요 사항입니다.

1. 모든 구성 속성 이름의 접두사는 azure.activedirectoryspring.cloud.azure.active-directory변경되었습니다.
2. Microsoft Entra 관련 기능을 사용/사용하지 않도록 설정하기 위해 새 속성 spring.cloud.azure.active-directory.enabled 추가됩니다. 기본값은 false입니다.

다음 표에서는 azure-spring-boot-starter-active-directoryspring-cloud-azure-starter-active-directory간의 속성 매핑을 보여 줍니다.

• 다음 속성의 값 형식이 longDuration변경됩니다.

  • jwt-connect-timeout
  • jwt-read-timeout
  • jwk-set-cache-lifespan
  • jwk-set-cache-refresh-time;

• 다음 속성이 제거됩니다.

  • azure.activedirectory.allow-telemetry
  • azure.activedirectory.user-group.enable-full-list
  • azure.activedirectory.graph-base-uri
  • azure.activedirectory.graph-membership-uri

• 다음 속성이 추가됩니다.

  • spring.cloud.azure.active-directory.enabled
  • spring.cloud.azure.active-directory.profile.environment.microsoft-graph-endpoint
  • spring.cloud.azure.active-directory.user-group.use-transitive-members

다음은 마이그레이션의 몇 가지 예입니다.

• 예제 1. 사례 1

  • 레거시의 경우: azure.activedirectory.graph-membership-uri=https://graph.microsoft.com/v1.0/me/memberOf

  • 최신의 경우: spring.cloud.azure.active-directory.profile.environment.microsoft-graph-endpoint=https://graph.microsoft.com/ + spring.cloud.azure.active-directory.user-group.use-transitive-members=false

• 예제 2. 사례 2

  • 레거시의 경우: azure.activedirectory.graph-membership-uri=https://graph.microsoft.com/v1.0/me/transitiveMemberOf

  • 최신의 경우: spring.cloud.azure.active-directory.profile.environment.microsoft-graph-endpoint=https://graph.microsoft.com/ + spring.cloud.azure.active-directory.user-group.use-transitive-members=true

API 변경 내용

다음 표에서는 azure-spring-boot-starter-active-directoryspring-cloud-azure-starter-active-directory클래스 매핑을 보여 줍니다.

이 섹션에서는 .에서 azure-spring-boot-starter-active-directory제거된 클래스를 나열합니다.

• 레거시 클래스 제거됨

  • com.azure.spring.aad.webapp.AADHandleConditionalAccessFilter
  • com.azure.spring.aad.webapi.validator.AADJwtAudienceValidator
  • com.azure.spring.aad.webapi.validator.AADJwtClaimValidator

azure-spring-boot-starter-active-directory-b2c부터 spring-cloud-azure-starter-active-directory-b2c까지

이 가이드는 버전 3spring-cloud-azure-starter-active-directory-b2c에서 마이그레이션을 azure-spring-boot-starter-active-directory-b2c 지원하기 위한 것입니다.

일반 정보는 다음 링크를 사용합니다.

• 4.0의 변경 내용에 대한 개요는 소개 및 마이그레이션 혜택 섹션을 참조하세요.
• 프로젝트 명명의 전략 변경에 대한 자세한 내용은 명명 변경 섹션을 참조하세요.
• 모든 Spring Cloud Azure 라이브러리에 하나의 BOM을 사용하는 방법을 알아보려면 BOM 섹션을 참조하세요.
• Spring Cloud Azure 4.0에서 인증을 처리하는 방법을 알아보려면 인증 변경 섹션을 참조하세요.
• 마이그레이션 중에 spring-boot-properties-migrator 활용하는 방법을 알아보려면 각 SDK 구성 섹션을 참조하세요.
• 전역 및 일반적인 구성 변경에 대한 자세한 내용은 전역 구성 섹션을 참조하세요.

종속성 변경

일부 불필요한 종속성이 레거시 아티팩트에서 포함되었으며, 최신 Spring Cloud Azure 4.0 라이브러리에서 제거되었습니다. 의도하지 않은 충돌을 방지하려면 제거된 종속성을 프로젝트에 수동으로 추가해야 합니다.

다음 표에서는 제거된 종속성을 보여줍니다.

SDK 구성 변경 내용

이 섹션에는 추가, 제거 및 변경된 속성에 대한 변경 내용이 포함되어 있습니다.

• 다음 두 가지 사항은 주의해야 할 주요 사항입니다.

1. 모든 구성 속성 이름이 접두사를 azure.activedirectory.b2cspring.cloud.azure.active-directory.b2c변경했습니다.
2. 새 속성 spring.cloud.azure.active-directory.b2c.enabled AD B2C 관련 기능을 Azure 사용/비활성화할 수 있도록 추가됩니다. 기본값은 false입니다.

다음 표에서는 azure-spring-boot-starter-active-directory-b2cspring-cloud-azure-starter-active-directory-b2c속성 매핑을 보여 줍니다.

• 다음에서 속성이 제거되었습니다.azure-spring-boot-starter-active-directory-b2c

  • azure.activedirectory.b2c.allow-telemetry
  • azure.activedirectory.b2c.tenant

• 다음 속성의 값 형식이 longDuration변경됩니다.

  • jwt-connect-timeout
  • jwt-read-timeout

API 변경 내용

다음 표에서는 azure-spring-boot-starter-active-directory-b2cspring-cloud-azure-starter-active-directory-b2c클래스 매핑을 보여 줍니다.

azure-spring-boot-starter-cosmos부터 spring-cloud-azure-starter-data-cosmos까지

이 가이드는 버전 3spring-cloud-azure-starter-data-cosmos에서 마이그레이션을 azure-spring-boot-starter-cosmos 지원하기 위한 것입니다.

일반 정보는 다음 링크를 사용합니다.

• 4.0의 변경 내용에 대한 개요는 소개 및 마이그레이션 혜택 섹션을 참조하세요.
• 프로젝트 명명의 전략 변경에 대한 자세한 내용은 명명 변경 섹션을 참조하세요.
• 모든 Spring Cloud Azure 라이브러리에 하나의 BOM을 사용하는 방법을 알아보려면 BOM 섹션을 참조하세요.
• Spring Cloud Azure 4.0에서 인증을 처리하는 방법을 알아보려면 인증 변경 섹션을 참조하세요.
• 마이그레이션 중에 spring-boot-properties-migrator 활용하는 방법을 알아보려면 각 SDK 구성 섹션을 참조하세요.
• 전역 및 일반적인 구성 변경에 대한 자세한 내용은 전역 구성 섹션을 참조하세요.

SDK 구성 변경 내용

모든 구성 속성 이름이 접두사를 azure.cosmosspring.cloud.azure.cosmos변경했습니다.

다음 표에서는 azure-spring-boot-starter-cosmosspring-cloud-azure-starter-data-cosmos클래스 매핑을 보여 줍니다.

azure-spring-boot-starter-keyvault-secrets부터 spring-cloud-azure-starter-keyvault-secrets까지

이 가이드는 버전 3spring-cloud-azure-starter-keyvault-secrets에서 마이그레이션을 azure-spring-boot-starter-keyvault-secrets 지원하기 위한 것입니다.

일반 정보는 다음 링크를 사용합니다.

• 4.0의 변경 내용에 대한 개요는 소개 및 마이그레이션 혜택 섹션을 참조하세요.
• 프로젝트 명명의 전략 변경에 대한 자세한 내용은 명명 변경 섹션을 참조하세요.
• 모든 Spring Cloud Azure 라이브러리에 하나의 BOM을 사용하는 방법을 알아보려면 BOM 섹션을 참조하세요.
• Spring Cloud Azure 4.0에서 인증을 처리하는 방법을 알아보려면 인증 변경 섹션을 참조하세요.
• 마이그레이션 중에 spring-boot-properties-migrator 활용하는 방법을 알아보려면 각 SDK 구성 섹션을 참조하세요.
• 전역 및 일반적인 구성 변경에 대한 자세한 내용은 전역 구성 섹션을 참조하세요.

SDK 구성 변경 내용

이 섹션에는 추가, 제거 및 변경된 속성에 대한 변경 내용이 포함되어 있습니다.

다음 표에서는 azure-spring-boot-starter-keyvault-secretsspring-cloud-azure-starter-keyvault-secrets속성 매핑을 보여 줍니다.

• 다음에서 속성이 제거되었습니다.spring-cloud-azure-starter-keyvault-secrets

  • azure.keyvault.allow-telemetry
  • azure.keyvault.order

다음 사항에 주의해야 합니다.

1. 모든 구성 속성 이름이 접두사를 azure.keyvaultspring.cloud.azure.keyvault.secret변경했습니다.
2. spring.cloud.azure.keyvault.secret.enabled 모든 Key Vault 비밀 기능을 사용하도록 설정하는 데 사용되며, Key Vault 비밀 클라이언트 빈(예: SecretClient 및 SecretAsyncClient)을 구성하고 KeyVaultPropertySourceConfigurableEnvironment 추가합니다.
3. spring.cloud.azure.keyvault.secret.property-source-enabled 모든 KeyVaultPropertySource사용하도록 설정하는 데 사용됩니다. spring.cloud.azure.keyvault.secret.enabled=true경우에만 적용됩니다.
4. Azure 공통 속성(예: client, proxy, retry, credential, profile) 및 Key Vault 속성(예: endpoint, service-version). spring.cloud.azure.keyvault.secret.property-sources[n].PROPERTY_NAME 구성되지 않은 경우 spring.cloud.azure.keyvault.secret.PROPERTY_NAME 사용됩니다.
5. spring.cloud.azure.keyvault.secret.property-sources[n].resource 고유한 Azure 리소스와 관련이 있으므로 구성되지 않은 경우 다른 위치에서 값을 얻지 못합니다.

azure-spring-boot-starter-servicebus-jms부터 spring-cloud-azure-starter-servicebus-jms까지

이 가이드는 버전 3spring-cloud-azure-starter-servicebus-jms에서 마이그레이션을 azure-spring-boot-starter-servicebus-jms 지원하기 위한 것입니다.

일반 정보는 다음 링크를 사용합니다.

• 4.0의 변경 내용에 대한 개요는 소개 및 마이그레이션 혜택 섹션을 참조하세요.
• 프로젝트 명명의 전략 변경에 대한 자세한 내용은 명명 변경 섹션을 참조하세요.
• 모든 Spring Cloud Azure 라이브러리에 하나의 BOM을 사용하는 방법을 알아보려면 BOM 섹션을 참조하세요.
• Spring Cloud Azure 4.0에서 인증을 처리하는 방법을 알아보려면 인증 변경 섹션을 참조하세요.
• 마이그레이션 중에 spring-boot-properties-migrator 활용하는 방법을 알아보려면 각 SDK 구성 섹션을 참조하세요.
• 전역 및 일반적인 구성 변경에 대한 자세한 내용은 전역 구성 섹션을 참조하세요.

SDK 구성 변경 내용

가독성을 위해 spring.jms.servicebus.idle-timeout 패턴으로 변경 long 된 구성 유형(밀리초) Duration 입니다.

azure-spring-boot-starter-storage부터 spring-cloud-azure-starter-storage-blob까지

이 가이드는 버전 3spring-cloud-azure-starter-storage-blob에서 마이그레이션을 azure-spring-boot-starter-storage 지원하기 위한 것입니다.

일반 정보는 다음 링크를 사용합니다.

• 4.0의 변경 내용에 대한 개요는 소개 및 마이그레이션 혜택 섹션을 참조하세요.
• 프로젝트 명명의 전략 변경에 대한 자세한 내용은 명명 변경 섹션을 참조하세요.
• 모든 Spring Cloud Azure 라이브러리에 하나의 BOM을 사용하는 방법을 알아보려면 BOM 섹션을 참조하세요.
• Spring Cloud Azure 4.0에서 인증을 처리하는 방법을 알아보려면 인증 변경 섹션을 참조하세요.
• 마이그레이션 중에 spring-boot-properties-migrator 활용하는 방법을 알아보려면 각 SDK 구성 섹션을 참조하세요.
• 전역 및 일반적인 구성 변경에 대한 자세한 내용은 전역 구성 섹션을 참조하세요.

SDK 구성 변경 내용

모든 구성 속성 이름이 접두사를 azure.storagespring.cloud.azure.storage.blob변경했습니다.

다음 표에서는 azure-spring-boot-starter-storagespring-cloud-azure-starter-storage-blob속성 매핑을 보여 줍니다.

API 변경 내용

다음 표에서는 azure-spring-boot-starter-storagespring-cloud-azure-starter-storage-blob클래스 매핑을 보여 줍니다.

azure-spring-boot-starter-storage부터 spring-cloud-azure-starter-storage-file-share까지

이 가이드는 버전 3spring-cloud-azure-starter-storage-file-share에서 마이그레이션을 azure-spring-boot-starter-storage 지원하기 위한 것입니다.

일반 정보는 다음 링크를 사용합니다.

• 4.0의 변경 내용에 대한 개요는 소개 및 마이그레이션 혜택 섹션을 참조하세요.
• 프로젝트 명명의 전략 변경에 대한 자세한 내용은 명명 변경 섹션을 참조하세요.
• 모든 Spring Cloud Azure 라이브러리에 하나의 BOM을 사용하는 방법을 알아보려면 BOM 섹션을 참조하세요.
• Spring Cloud Azure 4.0에서 인증을 처리하는 방법을 알아보려면 인증 변경 섹션을 참조하세요.
• 마이그레이션 중에 spring-boot-properties-migrator 활용하는 방법을 알아보려면 각 SDK 구성 섹션을 참조하세요.
• 전역 및 일반적인 구성 변경에 대한 자세한 내용은 전역 구성 섹션을 참조하세요.

SDK 구성 변경 내용

모든 구성 속성 이름이 접두사를 azure.storagespring.cloud.azure.storage.fileshare변경했습니다.

다음 표에서는 azure-spring-boot-starter-storagespring-cloud-azure-starter-storage-file-share속성 매핑을 보여 줍니다.

API 변경 내용

다음 표에서는 azure-spring-boot-starter-storagespring-cloud-azure-starter-storage-file-share클래스 매핑을 보여 줍니다.

azure-spring-cloud-starter-eventhubs부터 spring-cloud-azure-starter-integration-eventhubs까지

이 가이드는 버전 2spring-cloud-azure-starter-integration-eventhubs에서 마이그레이션을 azure-spring-cloud-starter-eventhubs 지원하기 위한 것입니다.

일반 정보는 다음 링크를 사용합니다.

• 4.0의 변경 내용에 대한 개요는 소개 및 마이그레이션 혜택 섹션을 참조하세요.
• 프로젝트 명명의 전략 변경에 대한 자세한 내용은 명명 변경 섹션을 참조하세요.
• 모든 Spring Cloud Azure 라이브러리에 하나의 BOM을 사용하는 방법을 알아보려면 BOM 섹션을 참조하세요.
• Spring Cloud Azure 4.0에서 인증을 처리하는 방법을 알아보려면 인증 변경 섹션을 참조하세요.
• 마이그레이션 중에 spring-boot-properties-migrator 활용하는 방법을 알아보려면 각 SDK 구성 섹션을 참조하세요.
• 전역 및 일반적인 구성 변경에 대한 자세한 내용은 전역 구성 섹션을 참조하세요.

SDK 구성 변경 내용

이 접두사에 대한 자식 항목에 대한 변경 내용은 다음 표를 참조하세요.

다음 표에서는 azure-spring-cloud-starter-eventhubsspring-cloud-azure-starter-integration-eventhubs속성 매핑을 보여 줍니다.

예를 들어 다음에서 변경합니다.

spring:
  cloud:
    azure:
      eventhub:
        connection-string: ${AZURE_EVENTHUBS_CONNECTION_STRING}
        checkpoint-storage-account: ${AZURE_CHECKPOINT_STORAGE_ACCOUNT_NAME}
        checkpoint-access-key: ${AZURE_CHECKPOINT_ACCOUNT_KEY}
        checkpoint-container: ${AZURE_CHECKPOINT_CONTAINER_NAME}

받는 사람:

spring:
  cloud:
    azure:
      eventhubs:
        connection-string: ${AZURE_EVENTHUBS_CONNECTION_STRING}
        processor:
          checkpoint-store:
            container-name: ${AZURE_STORAGE_CONTAINER_NAME}
            account-name: ${AZURE_STORAGE_ACCOUNT_NAME}
            account-key: ${AZURE_STORAGE_ACCOUNT_KEY}

API 변경 내용

• 수신기 주석에 대한 변경 내용은 <<migration-azure-spring-cloud-messaging, azure-spring-cloud-messaging>> 라이브러리의 마이그레이션 가이드를 참조하세요.
• 구독 함수가 클래스 EventHubOperation 이동되고 송신 함수가 EventHubsMessageListenerContainer이동한 EventHubsTemplate 삭제합니다.
• Azure Event Hubs 서비스와 일치하도록 EventHubInboundChannelAdapter 이름을 EventHubsInboundChannelAdapter로 바꿉니다.
• 생성자를 EventHubInboundChannelAdapter(String, SubscribeByGroupOperation, String)EventHubsInboundChannelAdapter(EventHubsMessageListenerContainer)EventHubsInboundChannelAdapter(EventHubsMessageListenerContainer, ListenerMode)변경합니다.
• CheckpointConfig 인스턴스화 스타일을 빌드 스타일 대신 단순 생성자로 변경합니다.
• API EventHubOperation#setCheckpointConfig삭제합니다. 인바운드 채널 어댑터에 대한 검사점 구성을 설정하려면 사용자가 메서드 EventHubsContainerProperties#setCheckpointConfig호출할 수 있습니다.
• API EventHubOperation#setBatchConsumerConfig삭제합니다. 인바운드 채널 어댑터에 대한 일괄 처리 사용 구성을 설정하기 위해 사용자는 EventHubsContainerProperties#getBatch#setMaxSize 두 메서드를 호출하고 EventHubsContainerProperties#getBatch#setMaxWaitTime 수 있습니다.
• 일괄 처리 사용 모드의 경우 일괄 처리된 메시지에서 변환된 메시지 헤더 이름을 변경합니다.
  • 메시지 헤더를 azure_eventhub_enqueued_timeazure_eventhubs_batch_converted_enqueued_time변경합니다.
  • 메시지 헤더를 azure_eventhub_offsetazure_eventhubs_batch_converted_offset변경합니다.
  • 메시지 헤더를 azure_eventhub_sequence_numberazure_eventhubs_batch_converted_sequence_number변경합니다.
  • 메시지 헤더를 azure_partition_keyazure_batch_converted_partition_key변경합니다.
• Event Hubs에 메시지를 게시하는 경우 일괄 처리된 메시지에서 변환된 모든 메시지 헤더를 무시합니다. 헤더에는 다음이 포함됩니다.
  • azure_batch_converted_partition_key
  • azure_eventhubs_batch_converted_enqueued_time
  • azure_eventhubs_batch_converted_offset
  • azure_eventhubs_batch_converted_sequence_number
  • azure_eventhubs_batch_converted_system_properties
  • azure_eventhubs_batch_converted_application_properties
• BATCH 검사점 모드는 이제 일괄 처리 사용 모드에서만 작동하며, EventHubsInboundChannelAdapter 생성자에 ListenerMode.BATCH 전달하여 사용하도록 설정할 수 있습니다.

다음 표에서는 azure-spring-cloud-starter-eventhubsspring-cloud-azure-starter-integration-eventhubs클래스 매핑을 보여 줍니다.

샘플 코드 조각

• EventHubsInboundChannelAdapter 샘플 코드:

  레거시 코드:

  public class Demo {
      @Bean
      public EventHubInboundChannelAdapter messageChannelAdapter(
          @Qualifier("INPUT_CHANNEL") MessageChannel inputChannel, EventHubOperation   eventhubOperation) {
          eventhubOperation.setCheckpointConfig(CheckpointConfig.builder().checkpointMode  (CheckpointMode.MANUAL).build());
          EventHubInboundChannelAdapter adapter = new EventHubInboundChannelAdapter("EVENTHUB_NAME",
              eventhubOperation, "CONSUMER_GROUP");
          adapter.setOutputChannel(inputChannel);
          return adapter;
      }
  }
  

  최신 코드:

  public class Demo {
      @Bean
      public EventHubsMessageListenerContainer messageListenerContainer(EventHubsProcessorFactory processorFactory) {
          EventHubsContainerProperties containerProperties = new EventHubsContainerProperties();
          containerProperties.setEventHubName("EVENTHUB_NAME");
          containerProperties.setConsumerGroup("CONSUMER_GROUP");
          CheckpointConfig config = new CheckpointConfig(CheckpointMode.MANUAL);
          containerProperties.setCheckpointConfig(config);
          return new EventHubsMessageListenerContainer(processorFactory, containerProperties);
      }
  
      @Bean
      public EventHubsInboundChannelAdapter messageChannelAdapter(@Qualifier("INPUT_CHANNEL") MessageChannel inputChannel,
                                                                  EventHubsMessageListenerContainer listenerContainer) {
          EventHubsInboundChannelAdapter adapter = new EventHubsInboundChannelAdapter(listenerContainer);
          adapter.setOutputChannel(inputChannel);
          return adapter;
      }
  }
  

• DefaultMessageHandler 샘플 코드:

  레거시 코드:

  public class Demo {
      @Bean
      @ServiceActivator(inputChannel = "OUTPUT_CHANNEL")
      public MessageHandler messageSender(EventHubOperation eventhubOperation) {
          DefaultMessageHandler handler = new DefaultMessageHandler("EVENTHUB_NAME", eventhubOperation);
          handler.setSendCallback(new ListenableFutureCallback<Void>() {
              @Override
              public void onSuccess(Void result) {
                  LOGGER.info("Message was sent successfully.");
              }
  
              @Override
              public void onFailure(Throwable ex) {
                  LOGGER.error("There was an error sending the message.", ex);
              }
          });
          return handler;
      }
  }
  

  최신 코드:

  public class Demo {
      @Bean
      @ServiceActivator(inputChannel = "OUTPUT_CHANNEL")
      public MessageHandler messageSender(EventHubsTemplate eventhubOperation) {
          DefaultMessageHandler handler = new DefaultMessageHandler("EVENTHUB_NAME", eventhubOperation);
          handler.setSendCallback(new ListenableFutureCallback<Void>() {
              @Override
              public void onSuccess(Void result) {
                  LOGGER.info("Message was sent successfully.");
              }
  
              @Override
              public void onFailure(Throwable ex) {
                  LOGGER.error("There was an error sending the message.", ex);
              }
          });
  
          return handler;
      }
  }
  

azure-spring-integration-eventhubs부터 spring-integration-azure-eventhubs까지

이 가이드는 버전 2spring-integration-azure-eventhubs에서 마이그레이션을 azure-spring-integration-eventhubs 지원하기 위한 것입니다.

• 4.0의 변경 내용에 대한 개요는 소개 및 마이그레이션 혜택 섹션을 참조하세요.
• 프로젝트 명명의 전략 변경에 대한 자세한 내용은 명명 변경 섹션을 참조하세요.
• 모든 Spring Cloud Azure 라이브러리에 하나의 BOM을 사용하는 방법을 알아보려면 BOM 섹션을 참조하세요.

API 변경 내용

• 구독 함수가 클래스 EventHubOperation 이동되고 송신 함수가 EventHubsMessageListenerContainer이동한 EventHubsTemplate 삭제합니다.
• Azure Event Hubs 서비스와 일치하도록 EventHubInboundChannelAdapter 이름을 EventHubsInboundChannelAdapter로 바꿉니다.
• 생성자를 EventHubInboundChannelAdapter(String, SubscribeByGroupOperation, String)EventHubsInboundChannelAdapter(EventHubsMessageListenerContainer)EventHubsInboundChannelAdapter(EventHubsMessageListenerContainer, ListenerMode)변경합니다.
• CheckpointConfig 인스턴스화 스타일을 빌드 스타일 대신 단순 생성자로 변경합니다.
• API EventHubOperation#setCheckpointConfig삭제합니다. 인바운드 채널 어댑터에 대한 검사점 구성을 설정하려면 사용자가 메서드 EventHubsContainerProperties#setCheckpointConfig호출할 수 있습니다.
• API EventHubOperation#setBatchConsumerConfig삭제합니다. 인바운드 채널 어댑터에 대한 일괄 처리 사용 구성을 설정하기 위해 사용자는 EventHubsContainerProperties#getBatch#setMaxSize 두 메서드를 호출하고 EventHubsContainerProperties#getBatch#setMaxWaitTime 수 있습니다.
• 일괄 처리 사용 모드의 경우 일괄 처리된 메시지에서 변환된 메시지 헤더 이름을 변경합니다.
  • 메시지 헤더를 azure_eventhub_enqueued_timeazure_eventhubs_batch_converted_enqueued_time변경합니다.
  • 메시지 헤더를 azure_eventhub_offsetazure_eventhubs_batch_converted_offset변경합니다.
  • 메시지 헤더를 azure_eventhub_sequence_numberazure_eventhubs_batch_converted_sequence_number변경합니다.
  • 메시지 헤더를 azure_partition_keyazure_batch_converted_partition_key변경합니다.
• Event Hubs에 메시지를 게시하는 경우 일괄 처리된 메시지에서 변환된 모든 메시지 헤더를 무시합니다. 헤더에는 다음이 포함됩니다.
  • azure_batch_converted_partition_key
  • azure_eventhubs_batch_converted_enqueued_time
  • azure_eventhubs_batch_converted_offset
  • azure_eventhubs_batch_converted_sequence_number
  • azure_eventhubs_batch_converted_system_properties
  • azure_eventhubs_batch_converted_application_properties
• BATCH 검사점 모드는 이제 일괄 처리 사용 모드에서만 작동하며, EventHubsInboundChannelAdapter 생성자에 ListenerMode.BATCH 전달하여 사용하도록 설정할 수 있습니다.

다음 표에서는 azure-spring-integration-eventhubs spring-integration-azure-eventhubs클래스 매핑을 보여 줍니다.

azure-spring-cloud-starter-servicebus부터 spring-cloud-azure-starter-integration-servicebus까지

이 가이드는 버전 2spring-cloud-azure-starter-integration-servicebus에서 마이그레이션을 azure-spring-cloud-starter-servicebus 지원하기 위한 것입니다.

일반 정보는 다음 링크를 사용합니다.

• 4.0의 변경 내용에 대한 개요는 소개 및 마이그레이션 혜택 섹션을 참조하세요.
• 프로젝트 명명의 전략 변경에 대한 자세한 내용은 명명 변경 섹션을 참조하세요.
• 모든 Spring Cloud Azure 라이브러리에 하나의 BOM을 사용하는 방법을 알아보려면 BOM 섹션을 참조하세요.
• Spring Cloud Azure 4.0에서 인증을 처리하는 방법을 알아보려면 인증 변경 섹션을 참조하세요.
• 마이그레이션 중에 spring-boot-properties-migrator 활용하는 방법을 알아보려면 각 SDK 구성 섹션을 참조하세요.
• 전역 및 일반적인 구성 변경에 대한 자세한 내용은 전역 구성 섹션을 참조하세요.

SDK 구성 변경 내용

spring-cloud-azure-starter-integration-servicebus지원되는 모든 구성 옵션의 경우 접두사는 spring.cloud.azure.servicebus유지됩니다.

다음 표에서는 azure-spring-cloud-starter-servicebusspring-cloud-azure-starter-integration-servicebus속성 매핑을 보여 줍니다.

API 변경 내용

• 구독 함수가 클래스 ServiceBusQueueOperation 이동하고 보내는 함수가 ServiceBusTopicOperation이동한 ServiceBusMessageListenerContainer 삭제하고 ServiceBusTemplate.
• ServiceBusQueueInboundChannelAdapter 및 ServiceBusTopicInboundChannelAdapter 삭제하고 Service Bus 큐/토픽 엔터티를 수신 대기하도록 기능을 ServiceBusInboundChannelAdapter로 이동합니다.
• 생성자를 ServiceBusQueueInboundChannelAdapter(String, SubscribeByGroupOperation, String)ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer)ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer, ListenerMode)변경합니다.
• 생성자를 ServiceBusTopicInboundChannelAdapter(String, SubscribeByGroupOperation, String)ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer)ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer, ListenerMode)변경합니다.
• API ServiceBusQueueOperation#setCheckpointConfig 삭제하고 ServiceBusTopicOperation#setCheckpointConfig. 인바운드 채널 어댑터에 대한 검사점 구성을 설정하려면 사용자가 메서드 ServiceBusContainerProperties#setAutoComplete 대신 호출할 수 있습니다. 자동 완성 모드를 사용하지 않도록 설정하는 것은 MANUAL 검사점 모드와 동일하며 이를 사용하도록 설정하면 RECORD 모드가 트리거됩니다.
• API ServiceBusQueueOperatio#setClientConfig 삭제하고 ServiceBusTopicOperation#setClientConfig. 인바운드 채널 어댑터에서 사용하는 기본 ServiceBusProcessorClient 구성하기 위해 사용자는 대신 ServiceBusContainerProperties 사용할 수 있습니다.
• CompletableFuture ServiceBusTemplate 지원을 삭제하고 DefaultMessageHandler대신 Reactor 지원합니다.
• ServiceBusTemplate#setDefaultEntityType 새 API를 추가하여 엔터티 형식을 지정합니다. 이 형식은 PropertiesSupplier<String, ProducerProperties>대해 ProducerProperties#entityType 빈이 제공되지 않는 경우에 필요합니다.
• 메시지 헤더 AzureHeaders.RAW_ID삭제합니다. ServiceBusMessageHeaders.MESSAGE_ID를 대신 사용하세요.

다음 표에서는 azure-spring-cloud-starter-servicebusspring-cloud-azure-starter-integration-servicebus클래스 매핑을 보여 줍니다.

샘플 코드 조각

• ServiceBusInboundChannelAdapter 샘플 코드:

  ServiceBusQueueInboundChannelAdapter 또는 ServiceBusTopicInboundChannelAdapter사용하는 레거시 코드:

  public class Demo {
      @Bean
      public ServiceBusQueueInboundChannelAdapter queueMessageChannelAdapter(
          @Qualifier("INPUT_CHANNEL_NAME") MessageChannel inputChannel, ServiceBusQueueOperation queueOperation) {
          queueOperation.setCheckpointConfig(CheckpointConfig.builder().checkpointMode(CheckpointMode.MANUAL).build());
          ServiceBusQueueInboundChannelAdapter adapter = new ServiceBusQueueInboundChannelAdapter("QUEUE_NAME",
              queueOperation);
          adapter.setOutputChannel(inputChannel);
          return adapter;
      }
  
      @Bean
      public ServiceBusTopicInboundChannelAdapter topicMessageChannelAdapter(
          @Qualifier("INPUT_CHANNEL_NAME") MessageChannel inputChannel, ServiceBusTopicOperation topicOperation) {
          topicOperation.setCheckpointConfig(CheckpointConfig.builder().checkpointMode(CheckpointMode.MANUAL).build());
          ServiceBusTopicInboundChannelAdapter adapter = new ServiceBusTopicInboundChannelAdapter("TOPIC_NAME",
              topicOperation, "SUBSCRIPTION_NAME");
          adapter.setOutputChannel(inputChannel);
          return adapter;
      }
  
  }
  

  최신 코드:

  public class Demo {
      @Bean("queue-listener-container")
      public ServiceBusMessageListenerContainer messageListenerContainer(ServiceBusProcessorFactory processorFactory) {
          ServiceBusContainerProperties containerProperties = new ServiceBusContainerProperties();
          containerProperties.setEntityName("QUEUE_NAME");
          containerProperties.setAutoComplete(false);
          return new ServiceBusMessageListenerContainer(processorFactory, containerProperties);
      }
  
      @Bean
      public ServiceBusInboundChannelAdapter queueMessageChannelAdapter(
          @Qualifier("INPUT_CHANNEL") MessageChannel inputChannel,
          @Qualifier("queue-listener-container") ServiceBusMessageListenerContainer listenerContainer) {
          ServiceBusInboundChannelAdapter adapter = new ServiceBusInboundChannelAdapter(listenerContainer);
          adapter.setOutputChannel(inputChannel);
          return adapter;
      }
  
      @Bean("topic-listener-container")
      public ServiceBusMessageListenerContainer messageListenerContainer(ServiceBusProcessorFactory processorFactory) {
          ServiceBusContainerProperties containerProperties = new ServiceBusContainerProperties();
          containerProperties.setEntityName("TOPIC_NAME");
          containerProperties.setSubscriptionName("SUBSCRIPTION_NAME");
          containerProperties.setAutoComplete(false);
          return new ServiceBusMessageListenerContainer(processorFactory, containerProperties);
      }
  
      @Bean
      public ServiceBusInboundChannelAdapter topicMessageChannelAdapter(
          @Qualifier("INPUT_CHANNEL") MessageChannel inputChannel,
          @Qualifier("topic-listener-container") ServiceBusMessageListenerContainer listenerContainer) {
          ServiceBusInboundChannelAdapter adapter = new ServiceBusInboundChannelAdapter(listenerContainer);
          adapter.setOutputChannel(inputChannel);
          return adapter;
      }
  }
  

• DefaultMessageHandler 샘플 코드:

  레거시 코드, 큐를 예로 들면 다음과 같습니다.

  public class Demo {
      @Bean
      @ServiceActivator(inputChannel = "OUTPUT_CHANNEL_NAME")
      public MessageHandler queueMessageSender(ServiceBusQueueOperation queueOperation) {
          DefaultMessageHandler handler = new DefaultMessageHandler("QUEUE_NAME", queueOperation);
          handler.setSendCallback(new ListenableFutureCallback<Void>() {
              @Override
              public void onSuccess(Void result) {
                  LOGGER.info("Message was sent successfully.");
              }
              @Override
              public void onFailure(Throwable ex) {
                  LOGGER.info("There was an error sending the message.");
              }
          });
          return handler;
      }
  }
  

  최신 코드:

  public class Demo {
  
      @Bean
      @ServiceActivator(inputChannel = "OUTPUT_CHANNEL_NAME")
      public MessageHandler queueMessageSender(ServiceBusTemplate serviceBusTemplate) {
          serviceBusTemplate.setDefaultEntityType(ServiceBusEntityType.QUEUE);
          DefaultMessageHandler handler = new DefaultMessageHandler("QUEUE_NAME", serviceBusTemplate);
          handler.setSendCallback(new ListenableFutureCallback<Void>() {
              @Override
              public void onSuccess(Void result) {
                  LOGGER.info("Message was sent successfully for {}.", "QUEUE_NAME");
              }
  
              @Override
              public void onFailure(Throwable ex) {
                  LOGGER.info("There was an error sending the message.");
              }
          });
  
          return handler;
      }
  }
  

azure-spring-integration-servicebus부터 spring-integration-azure-servicebus까지

이 가이드는 버전 2spring-integration-azure-servicebus에서 마이그레이션을 azure-spring-integration-servicebus 지원하기 위한 것입니다.

• 4.0의 변경 내용에 대한 개요는 소개 및 마이그레이션 혜택 섹션을 참조하세요.
• 프로젝트 명명의 전략 변경에 대한 자세한 내용은 명명 변경 섹션을 참조하세요.
• 모든 Spring Cloud Azure 라이브러리에 하나의 BOM을 사용하는 방법을 알아보려면 BOM 섹션을 참조하세요.

API 변경 내용

• 구독 함수가 클래스 ServiceBusQueueOperation 이동하고 보내는 함수가 ServiceBusTopicOperation이동한 ServiceBusMessageListenerContainer 삭제하고 ServiceBusTemplate.
• ServiceBusQueueInboundChannelAdapter 및 ServiceBusTopicInboundChannelAdapter 삭제하고 Service Bus 큐/토픽 엔터티를 수신 대기하도록 기능을 ServiceBusInboundChannelAdapter로 이동합니다.
• 생성자를 ServiceBusQueueInboundChannelAdapter(String, SubscribeByGroupOperation, String)ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer)ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer, ListenerMode)변경합니다.
• 생성자를 ServiceBusTopicInboundChannelAdapter(String, SubscribeByGroupOperation, String)ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer)ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer, ListenerMode)변경합니다.
• API ServiceBusQueueOperation#setCheckpointConfig 삭제하고 ServiceBusTopicOperation#setCheckpointConfig. 인바운드 채널 어댑터에 대한 검사점 구성을 설정하려면 사용자가 메서드 ServiceBusContainerProperties#setAutoComplete 대신 호출할 수 있습니다. 자동 완성 모드를 사용하지 않도록 설정하는 것은 MANUAL 검사점 모드와 동일하며 이를 사용하도록 설정하면 RECORD 모드가 트리거됩니다.
• API ServiceBusQueueOperation#setClientConfig 삭제하고 ServiceBusTopicOperation#setClientConfig. 인바운드 채널 어댑터에서 사용하는 기본 ServiceBusProcessorClient 구성하기 위해 사용자는 대신 ServiceBusContainerProperties 사용할 수 있습니다.
• CompletableFuture ServiceBusTemplate 지원을 삭제하고 DefaultMessageHandler대신 Reactor 지원합니다.
• ServiceBusTemplate#setDefaultEntityType 새 API를 추가하여 엔터티 형식을 지정합니다. 이 형식은 PropertiesSupplier<String, ProducerProperties>대해 ProducerProperties#entityType 빈이 제공되지 않는 경우에 필요합니다.
• 메시지 헤더 AzureHeaders.RAW_ID삭제합니다. ServiceBusMessageHeaders.MESSAGE_ID를 대신 사용하세요.

다음 표에서는 azure-spring-integration-servicebusspring-integration-azure-servicebus클래스 매핑을 보여 줍니다.

azure-spring-cloud-starter-storage-queue부터 spring-cloud-azure-starter-integration-storage-queue까지

이 가이드는 버전 2spring-cloud-azure-starter-integration-storage-queue에서 마이그레이션을 azure-spring-cloud-starter-storage-queue 지원하기 위한 것입니다.

일반 정보는 다음 링크를 사용합니다.

• 4.0의 변경 내용에 대한 개요는 소개 및 마이그레이션 혜택 섹션을 참조하세요.
• 프로젝트 명명의 전략 변경에 대한 자세한 내용은 명명 변경 섹션을 참조하세요.
• 모든 Spring Cloud Azure 라이브러리에 하나의 BOM을 사용하는 방법을 알아보려면 BOM 섹션을 참조하세요.
• Spring Cloud Azure 4.0에서 인증을 처리하는 방법을 알아보려면 인증 변경 섹션을 참조하세요.
• 마이그레이션 중에 spring-boot-properties-migrator 활용하는 방법을 알아보려면 각 SDK 구성 섹션을 참조하세요.
• 전역 및 일반적인 구성 변경에 대한 자세한 내용은 전역 구성 섹션을 참조하세요.

SDK 구성 변경 내용

모든 구성 속성 이름이 접두사를 spring.cloud.azure.storagespring.cloud.azure.storage.queue변경했습니다.

다음 표에서는 azure-spring-cloud-starter-storage-queuespring-cloud-azure-starter-integration-storage-queue속성 매핑을 보여 줍니다.

API 변경 내용

• StorageQueueOperation 삭제하고 대신 StorageQueueTemplate 제공합니다.
• checkpoint-mode StorageQueueTemplate 구성을 삭제하고 MANUAL 모드만 지원합니다.

다음 표에서는 azure-spring-cloud-starter-storage-queuespring-cloud-azure-starter-integration-storage-queue클래스 매핑을 보여 줍니다.

azure-spring-integration-storage-queue부터 spring-integration-azure-storage-queue까지

이 가이드는 버전 2spring-integration-azure-storage-queue에서 마이그레이션을 azure-spring-integration-storage-queue 지원하기 위한 것입니다.

• 4.0의 변경 내용에 대한 개요는 소개 및 마이그레이션 혜택 섹션을 참조하세요.
• 프로젝트 명명의 전략 변경에 대한 자세한 내용은 명명 변경 섹션을 참조하세요.
• 모든 Spring Cloud Azure 라이브러리에 하나의 BOM을 사용하는 방법을 알아보려면 BOM 섹션을 참조하세요.

API 변경 내용

• StorageQueueOperation 삭제하고 대신 StorageQueueTemplate 제공합니다.
• checkpoint-mode StorageQueueTemplate 구성을 삭제하고 MANUAL 모드만 지원합니다.

다음 표에서는 azure-spring-integration-storage-queuespring-integration-azure-storage-queue클래스 매핑을 보여 줍니다.

azure-spring-cloud-stream-binder-eventhubs부터 spring-cloud-azure-stream-binder-eventhubs까지

이 가이드는 버전 2spring-cloud-azure-stream-binder-eventhubs에서 마이그레이션을 azure-spring-cloud-stream-binder-eventhubs 지원하기 위한 것입니다.

일반 정보는 다음 링크를 사용합니다.

• 4.0의 변경 내용에 대한 개요는 소개 및 마이그레이션 혜택 섹션을 참조하세요.
• 프로젝트 명명의 전략 변경에 대한 자세한 내용은 명명 변경 섹션을 참조하세요.
• 모든 Spring Cloud Azure 라이브러리에 하나의 BOM을 사용하는 방법을 알아보려면 BOM 섹션을 참조하세요.
• Spring Cloud Azure 4.0에서 인증을 처리하는 방법을 알아보려면 인증 변경 섹션을 참조하세요.
• 마이그레이션 중에 spring-boot-properties-migrator 활용하는 방법을 알아보려면 각 SDK 구성 섹션을 참조하세요.
• 전역 및 일반적인 구성 변경에 대한 자세한 내용은 전역 구성 섹션을 참조하세요.

SDK 구성 변경 내용

다음 접두사에 대한 자식 항목의 변경 내용은 다음 표를 참조하세요.

다음 표에서는 azure-spring-cloud-stream-binder-eventhubsspring-cloud-azure-stream-binder-eventhubs속성 매핑을 보여 줍니다.

구성 마이그레이션 예제

인증에 연결 문자열 사용하고 위에서 언급한 속성을 마이그레이션하기 위해 구성 변경 내용이 다음과 같이 나열됩니다.

레거시 구성:

spring:
  cloud:
    azure:
      eventhub:
        connection-string: ${AZURE_EVENTHUBS_CONNECTION_STRING}
        checkpoint-storage-account: ${AZURE_CHECKPOINT_STORAGE_ACCOUNT_NAME}
        checkpoint-access-key: ${AZURE_CHECKPOINT_ACCOUNT_KEY}
        checkpoint-container: ${AZURE_CHECKPOINT_CONTAINER_NAME}
    stream:
      eventhub:
        bindings:
          <binding-name>:
            consumer:
              max-batch-size: ${AZURE_MAX_BATCH_SIZE}
              max-wait-time: ${AZURE_MAX_WAIT_TIME}
              checkpoint-mode: ${AZURE_CHECKPOINT_MODE}
              checkpoint-count: ${AZURE_CHECKPOINT_COUNT}
              checkpoint-interval: ${AZURE_CHECKPOINT_INTERVAL}
              start-position: EARLIEST

최신 구성:

spring:
  cloud:
    azure:
      eventhubs:
        connection-string: ${AZURE_EVENTHUBS_CONNECTION_STRING}
        processor:
          checkpoint-store:
            container-name: ${AZURE_STORAGE_CONTAINER_NAME}
            account-name:  ${AZURE_STORAGE_ACCOUNT_NAME}
            account-key: ${AZURE_STORAGE_ACCOUNT_KEY}
    stream:
      eventhubs:
        bindings:
          <binding-name>:
            consumer:
              batch:
                max-size: ${AZURE_MAX_BATCH_SIZE}
                max-wait-time: ${AZURE_MAX_WAIT_TIME}
              checkpoint:
                mode: ${AZURE_CHECKPOINT_MODE}
                count: ${AZURE_CHECKPOINT_COUNT}
                interval: ${AZURE_CHECKPOINT_INTERVAL}
              initial-partition-event-position:
                0:
                  offset: earliest
                1:
                  sequence-number: 100
                2:
                  enqueued-date-time: 2022-01-12T13:32:47.650005Z
                4:
                  inclusive: false

연결 문자열 대신 보안 주체를 사용하는 경우 4.0 이전 버전에서 애플리케이션은 먼저 제공된 보안 주체를 사용하여 ARM(Azure Resource Manager)에 연결한 다음 ARM을 사용하여 지정된 네임스페이스의 연결 문자열 검색합니다. 결국 애플리케이션은 검색된 연결 문자열 사용하여 Azure Event Hubs 연결합니다. 이러한 방식으로 제공된 보안 주체는 연결된 Azure Event Hubs 네임스페이스를 검색하려면 Contributor 역할을 부여해야 합니다.

Azure Spring Apps 4.0의 경우 인증을 위해 보안 주체를 활용하는 두 가지 방법을 제공합니다. 하나는 여전히 보안 주체를 사용하여 ARM에 연결하고 보안 주체에 Contributor 역할이 필요한 연결 문자열을 검색합니다. 다른 하나는 보안 주체를 활용하여 Microsoft Entra ID 인증한 다음 Azure Event Hubs 직접 연결합니다. 이 경우 Contributor 역할은 더 이상 필요하지 않지만 메시징 작업에는 다른 Data 관련 역할이 필요합니다. 보안 주체에 Azure 리소스에 액세스할 수 있는 충분한 권한이 부여되었는지 확인하려면 Microsoft Entra ID을 사용하여 액세스 권한 부여를 참조하세요.

ARM 기반 인증의 경우 서비스 주체를 예로 들어 할당된 역할이 변경되지 않아야 하는 구성 마이그레이션이 다음과 같이 나열됩니다.

레거시 구성:

spring:
  cloud:
    azure:
      client-id: ${AZURE_CLIENT_ID}
      client-secret: ${AZURE_CLIENT_SECRET}
      tenant-id: <tenant>
      resource-group: ${EVENTHUB_RESOURCE_GROUP}
      eventhub:
        namespace: ${EVENTHUB_NAMESPACE}

최신 구성에서는 Azure 구독 ID 및 리소스 그룹에 대한 속성이 필요합니다.

spring:
  cloud:
    azure:
      credential:
        client-id: ${AZURE_CLIENT_ID}
        client-secret: ${AZURE_CLIENT_SECRET}
      profile:
        tenant-id: <tenant>
        subscription-id: ${AZURE_SUBSCRIPTION_ID}
      eventhubs:
        namespace: ${EVENTHUB_NAMESPACE}
        resource:
          resource-group: ${RESOURCE_GROUP}

ARM으로 우회하지 않고 직접 Microsoft Entra ID 인증하고 권한을 부여하도록 마이그레이션할 수도 있습니다. 메시징 작업에 필요한 보안 주체 Data 역할을 부여해야 합니다. 서비스 주체 및 관리 ID의 구성 예제는 다음과 같습니다.

• 서비스 주체를 사용하는 경우

  spring:
    cloud:
      azure:
        credential:
          client-id: ${AZURE_CLIENT_ID}
          client-secret: ${AZURE_CLIENT_SECRET}
        profile:
          tenant-id: <tenant>
        eventhubs:
          namespace: ${EVENTHUB_NAMESPACE}
  

• 관리 ID를 사용하는 경우

  spring:
    cloud:
      azure:
        credential:
          managed-identity-enabled: true
          client-id: ${AZURE_MANAGED_IDENTITY_CLIENT_ID} # Only needed when using a user-assigned managed identity
        eventhubs:
          namespace: ${EVENTHUB_NAMESPACE}
  

API 변경 내용

다음 표에서는 azure-spring-cloud-stream-binder-eventhubsspring-cloud-azure-stream-binder-eventhubs클래스 매핑을 보여 줍니다.

azure-spring-cloud-stream-binder-servicebus-*부터 spring-cloud-azure-stream-binder-servicebus까지

이 가이드는 버전 2 또는 spring-cloud-azure-stream-binder-servicebus.로의 azure-spring-cloud-stream-binder-servicebus-queue 마이그레이션을 azure-spring-cloud-stream-binder-servicebus-topic 지원하기 위한 것입니다.

일반 정보는 다음 링크를 사용합니다.

• 4.0의 변경 내용에 대한 개요는 소개 및 마이그레이션 혜택 섹션을 참조하세요.
• 프로젝트 명명의 전략 변경에 대한 자세한 내용은 명명 변경 섹션을 참조하세요.
• 모든 Spring Cloud Azure 라이브러리에 하나의 BOM을 사용하는 방법을 알아보려면 BOM 섹션을 참조하세요.
• Spring Cloud Azure 4.0에서 인증을 처리하는 방법을 알아보려면 인증 변경 섹션을 참조하세요.
• 마이그레이션 중에 spring-boot-properties-migrator 활용하는 방법을 알아보려면 각 SDK 구성 섹션을 참조하세요.
• 전역 및 일반적인 구성 변경에 대한 자세한 내용은 전역 구성 섹션을 참조하세요.

SDK 구성 변경 내용

다음 표에서는 spring-cloud-azure-stream-binder-servicebus새 구성 속성을 나열합니다.

다음 표에서는 azure-spring-cloud-stream-binder-servicebus-*spring-cloud-azure-stream-binder-servicebus속성 매핑을 보여 줍니다.

구성 마이그레이션 예제

레거시 구성, 큐를 예로 들면 다음과 같습니다.

spring:
  cloud:
    azure:
      servicebus:
        connection-string: ${AZURE_SERVICEBUS_BINDER_CONNECTION_STRING}
    stream:
      function:
        definition: consume;supply
      bindings:
        consume-in-0:
          destination: ${AZURE_SERVICEBUS_QUEUE_NAME}
        supply-out-0:
          destination: ${AZURE_SERVICEBUS_QUEUE_NAME}
      servicebus:
        queue:
          bindings:
            consume-in-0:
              consumer:
                checkpoint-mode: MANUAL

최신 구성:

spring:
  cloud:
    azure:
      servicebus:
        connection-string: ${AZURE_SERVICEBUS_BINDER_CONNECTION_STRING}
    stream:
      function:
        definition: consume;supply
      bindings:
        consume-in-0:
          destination: ${AZURE_SERVICEBUS_QUEUE_NAME}
        supply-out-0:
          destination: ${AZURE_SERVICEBUS_QUEUE_NAME}
      servicebus:
        bindings:
          consume-in-0:
            consumer:
              auto-complete: false
          supply-out-0:
            producer:
              entity-type: queue #set as topic if needed

연결 문자열 대신 보안 주체를 사용하는 경우 4.0 이전 버전에서 애플리케이션은 먼저 제공된 보안 주체를 사용하여 ARM(Azure Resource Manager)에 연결한 다음 ARM을 사용하여 지정된 네임스페이스의 연결 문자열 검색합니다. 결국 애플리케이션은 검색된 연결 문자열 사용하여 Azure Service Bus 연결합니다. 이러한 방식으로 제공된 보안 주체는 연결된 Azure Service Bus 네임스페이스를 검색하려면 Contributor 역할을 부여해야 합니다.

Azure Spring Apps 4.0의 경우 인증을 위해 보안 주체를 활용하는 두 가지 방법을 제공합니다. 하나는 여전히 보안 주체를 사용하여 ARM에 연결하고 보안 주체에 Contributor 역할이 필요한 연결 문자열을 검색합니다. 다른 하나는 보안 주체를 활용하여 Microsoft Entra ID 인증한 다음 Azure Service Bus 직접 연결합니다. 이 경우 Contributor 역할은 더 이상 필요하지 않지만 메시징 작업에는 다른 Data 관련 역할이 필요합니다. 보안 주체에 Azure 리소스에 액세스할 수 있는 충분한 권한이 부여되었는지 확인하려면 Microsoft Entra ID을 사용하여 액세스 권한 부여를 참조하세요.

ARM 기반 인증의 경우 서비스 주체를 예로 들어 할당된 역할이 변경되지 않아야 하는 구성 마이그레이션이 다음과 같이 나열됩니다.

레거시 구성:

spring:
  cloud:
    azure:
      client-id: ${AZURE_CLIENT_ID}
      client-secret: ${AZURE_CLIENT_SECRET}
      tenant-id: <tenant>
      resource-group: ${SERVICEBUS_RESOURCE_GROUP}
      servicebus:
        namespace: ${SERVICEBUS_NAMESPACE}

최신 구성에서는 Azure 구독 ID 및 리소스 그룹에 대한 속성이 필요합니다.

spring:
  cloud:
    azure:
      credential:
        client-id: ${AZURE_CLIENT_ID}
        client-secret: ${AZURE_CLIENT_SECRET}
      profile:
        tenant-id: <tenant>
        subscription-id: ${AZURE_SUBSCRIPTION_ID}
      servicebus:
        namespace: ${SERVICEBUS_NAMESPACE}
        resource:
          resource-group: ${SERVICEBUS_RESOURCE_GROUP}

ARM으로 우회하지 않고 직접 Microsoft Entra ID 인증하고 권한을 부여하도록 마이그레이션할 수도 있습니다. 메시징 작업에 필요한 보안 주체 Data 역할을 부여해야 합니다. 서비스 주체 및 관리 ID의 구성 예제는 다음과 같습니다.

• 서비스 주체를 사용하는 경우

  spring:
    cloud:
      azure:
        credential:
          client-id: ${AZURE_CLIENT_ID}
          client-secret: ${AZURE_CLIENT_SECRET}
        profile:
          tenant-id: <tenant>
        servicebus:
          namespace: ${SERVICEBUS_NAMESPACE}
  

• 관리 ID를 사용하는 경우

  spring:
    cloud:
      azure:
        credential:
          managed-identity-enabled: true
          client-id: ${AZURE_MANAGED_IDENTITY_CLIENT_ID} # Only needed when using a user-assigned   managed identity
        servicebus:
          namespace: ${SERVICEBUS_NAMESPACE}
  

API 변경 내용

• 메시지 헤더 AzureHeaders.RAW_ID삭제합니다. ServiceBusMessageHeaders.MESSAGE_ID를 대신 사용하세요.

다음 표에서는 azure-spring-cloud-stream-binder-eventhubsspring-cloud-azure-stream-binder-eventhubs클래스 매핑을 보여 줍니다.

azure-spring-cloud-messaging

com.azure.spring:azure-spring-cloud-messaging 라이브러리는 4.0에 대해 준비되지 않았습니다. 수신기 주석의 함수는 다시 디자인 중이므로 @AzureMessageListener, @AzureMessageListeners및 @EnableAzureMessaging 주석은 현재 지원되지 않습니다.