Azure Event Hubs를 사용하는 Spring Cloud Stream

아티클
10/23/2023

이 자습서에서는 Spring Boot 애플리케이션에서 Azure Event Hubs 및 Spring Cloud Stream Binder Eventhubs를 사용하여 메시지를 보내고 받는 방법을 보여 줍니다.

필수 조건

Azure 구독 - 체험 구독 만들기
JDK(Java Development Kit) 버전 8 이상.
Apache Maven, 버전 3.2 이상.
cURL 또는 유사한 HTTP 유틸리티를 사용하여 기능을 테스트합니다.
Azure 이벤트 허브입니다. 없는 경우 Azure Portal을 사용하여 이벤트 허브를 만듭니다.
이벤트 허브 검사포인트에 대한 Azure Storage 계정입니다. 계정이 없으면 스토리지 계정을 만듭니다.
Spring Boot 애플리케이션 없는 경우 Spring Initializr를 사용하여 Maven 프로젝트를 만듭니다. Maven 프로젝트를 선택하고 종속성에서 Spring Web 및 Azure 지원 종속성을 추가한 다음 Java 버전 8 이상을 선택합니다.

참고 항목

계정에 리소스에 대한 액세스 권한을 부여하려면 Azure Event Hubs에서 현재 사용 중인 Microsoft Entra 계정에 해당 및 Azure Event Hubs Data Sender 역할을 할당 Azure Event Hubs Data Receiver 합니다. 그런 다음, Azure Storage 계정에서 현재 사용 중인 Microsoft Entra 계정에 역할을 할당 Storage Blob Data Contributor 합니다. 액세스 역할 부여에 대한 자세한 내용은 Azure Portal 을 사용하여 Azure 역할 할당 및 Microsoft Entra ID를 사용하여 Event Hubs 리소스에 대한 액세스 권한 부여를 참조하세요.

Important

이 자습서의 단계를 완료하려면 Spring Boot 버전 2.5 이상이 필요합니다.

Azure Event Hubs에서 메시지 보내기 및 받기

Azure Storage 계정 및 Azure 이벤트 허브를 사용하면 Spring Cloud Azure Stream Binder Event Hubs를 사용하여 메시지를 보내고 받을 수 있습니다.

Spring Cloud Azure Stream Binder Event Hubs 모듈을 설치하려면 pom.xml 파일에 다음 종속성을 추가합니다.

Spring Cloud AZURE BOM(청구서)
```
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.azure.spring</groupId>
      <artifactId>spring-cloud-azure-dependencies</artifactId>
      <version>5.11.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>
```
참고 항목

Spring Boot 2.x를 사용하는 경우 버전을 .로 설정 spring-cloud-azure-dependencies 해야 합니다 4.17.0. 이 BOM(청구서)은 pom.xml 파일의 섹션에서 구성 <dependencyManagement> 해야 합니다. 이렇게 하면 모든 Spring Cloud Azure 종속성이 동일한 버전을 사용합니다. 이 BOM에 사용되는 버전에 대한 자세한 내용은 어떤 버전의 Spring Cloud Azure를 사용해야 하는지를 참조하세요.

Spring Cloud Azure Stream Binder Event Hubs 아티팩트:

<dependency>
   <groupId>com.azure.spring</groupId>
   <artifactId>spring-cloud-azure-stream-binder-eventhubs</artifactId>
</dependency>

애플리케이션 코딩

다음 단계를 사용하여 Azure Event Hubs를 사용하여 메시지를 생성하고 사용하도록 애플리케이션을 구성합니다.

application.properties 파일에 다음 속성을 추가하여 이벤트 허브 자격 증명을 구성합니다.

 spring.cloud.azure.eventhubs.namespace=${AZURE_EVENTHUBS_NAMESPACE}
 spring.cloud.azure.eventhubs.processor.checkpoint-store.account-name=${AZURE_STORAGE_ACCOUNT_NAME}
 spring.cloud.azure.eventhubs.processor.checkpoint-store.container-name=${AZURE_STORAGE_CONTAINER_NAME}
 spring.cloud.stream.bindings.consume-in-0.destination=${AZURE_EVENTHUB_NAME}
 spring.cloud.stream.bindings.consume-in-0.group=${AZURE_EVENTHUB_CONSUMER_GROUP}
 spring.cloud.stream.bindings.supply-out-0.destination=${AZURE_EVENTHUB_NAME}
 spring.cloud.stream.eventhubs.bindings.consume-in-0.consumer.checkpoint.mode=MANUAL
 spring.cloud.function.definition=consume;supply;
 spring.cloud.stream.poller.initial-delay=0
 spring.cloud.stream.poller.fixed-delay=1000

다음 표에서는 구성의 필드에 대해 설명합니다.

필드	설명
`spring.cloud.azure.eventhubs.namespace`	Azure Portal에서 이벤트 허브에서 가져온 네임스페이스를 지정합니다.
`spring.cloud.azure.eventhubs.processor.checkpoint-store.account-name`	이 자습서에서 만든 스토리지 계정을 지정합니다.
`spring.cloud.azure.eventhubs.processor.checkpoint-store.container-name`	스토리지 계정의 컨테이너를 지정합니다.
`spring.cloud.stream.bindings.consume-in-0.destination`	이 자습서에서 사용한 이벤트 허브를 지정합니다.
`spring.cloud.stream.bindings.consume-in-0.group`	Event Hubs 인스턴스에서 소비자 그룹을 지정합니다.
`spring.cloud.stream.bindings.supply-out-0.destination`	이 자습서에서 사용한 것과 동일한 이벤트 허브를 지정합니다.
`spring.cloud.stream.eventhubs.bindings.consume-in-0.consumer.checkpoint.mode`	`MANUAL`을 지정합니다.
`spring.cloud.function.definition`	바인딩에 의해 노출되는 외부 대상에 바인딩할 기능 빈을 지정합니다.
`spring.cloud.stream.poller.initial-delay`	주기적 트리거에 대한 초기 지연을 지정합니다. 기본값은 0입니다.
`spring.cloud.stream.poller.fixed-delay`	기본 폴러의 고정 지연 시간(밀리초)을 지정합니다. 기본값은 1000L입니다.

시작 클래스 파일을 편집하여 다음 콘텐츠를 표시합니다.

import com.azure.spring.messaging.checkpoint.Checkpointer;
import com.azure.spring.messaging.eventhubs.support.EventHubsHeaders;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.messaging.Message;
import org.springframework.messaging.support.MessageBuilder;
import reactor.core.publisher.Flux;
import reactor.core.publisher.Sinks;
import java.util.function.Consumer;
import java.util.function.Supplier;
import static com.azure.spring.messaging.AzureHeaders.CHECKPOINTER;

@SpringBootApplication
public class EventHubBinderApplication implements CommandLineRunner {

    private static final Logger LOGGER = LoggerFactory.getLogger(EventHubBinderApplication.class);
    private static final Sinks.Many<Message<String>> many = Sinks.many().unicast().onBackpressureBuffer();

    public static void main(String[] args) {
        SpringApplication.run(EventHubBinderApplication.class, args);
    }

    @Bean
    public Supplier<Flux<Message<String>>> supply() {
        return ()->many.asFlux()
                       .doOnNext(m->LOGGER.info("Manually sending message {}", m))
                       .doOnError(t->LOGGER.error("Error encountered", t));
    }

    @Bean
    public Consumer<Message<String>> consume() {
        return message->{
            Checkpointer checkpointer = (Checkpointer) message.getHeaders().get(CHECKPOINTER);
            LOGGER.info("New message received: '{}', partition key: {}, sequence number: {}, offset: {}, enqueued "
                    +"time: {}",
                message.getPayload(),
                message.getHeaders().get(EventHubsHeaders.PARTITION_KEY),
                message.getHeaders().get(EventHubsHeaders.SEQUENCE_NUMBER),
                message.getHeaders().get(EventHubsHeaders.OFFSET),
                message.getHeaders().get(EventHubsHeaders.ENQUEUED_TIME)
            );
            checkpointer.success()
                        .doOnSuccess(success->LOGGER.info("Message '{}' successfully checkpointed",
                            message.getPayload()))
                        .doOnError(error->LOGGER.error("Exception found", error))
                        .block();
        };
    }

    @Override
    public void run(String... args) {
        LOGGER.info("Going to add message {} to sendMessage.", "Hello World");
        many.emitNext(MessageBuilder.withPayload("Hello World").build(), Sinks.EmitFailureHandler.FAIL_FAST);
    }

}

팁

이 자습서에서는 구성 또는 코드에 인증 작업이 없습니다. 그러나 Azure 서비스에 연결하려면 인증이 필요합니다. 인증을 완료하려면 Azure ID를 사용해야 합니다. Spring Cloud Azure는 코드 변경 없이 자격 증명을 가져오는 데 도움이 되는 Azure ID 라이브러리를 사용합니다 DefaultAzureCredential.

DefaultAzureCredential은 여러 인증 방법을 지원하고 런타임에 사용할 방법을 결정합니다. 이 방법을 사용하면 앱이 환경별 코드를 구현하지 않고도 다양한 환경(예: 로컬 및 프로덕션 환경)에서 다양한 인증 방법을 사용할 수 있습니다. 자세한 내용은 DefaultAzureCredential을 참조 하세요.

로컬 개발 환경에서 인증을 완료하려면 Azure CLI, Visual Studio Code, PowerShell 또는 기타 방법을 사용할 수 있습니다. 자세한 내용은 Java 개발 환경에서 Azure 인증을 참조 하세요. Azure 호스팅 환경에서 인증을 완료하려면 사용자 할당 관리 ID를 사용하는 것이 좋습니다. 자세한 내용은 Azure 리소스에 대한 관리 ID란?을 참조하세요.

애플리케이션을 시작합니다. 다음과 같은 메시지는 다음 예제 출력과 같이 애플리케이션 로그에 게시됩니다.

New message received: 'Hello World', partition key: 107207233, sequence number: 458, offset: 94256, enqueued time: 2023-02-17T08:27:59.641Z
Message 'Hello World!' successfully checkpointed

Azure Spring Apps에 배포

이제 Spring Boot 애플리케이션을 로컬로 실행했으므로 이제 프로덕션으로 이동해야 합니다. Azure Spring Apps 를 사용하면 코드를 변경하지 않고도 Spring Boot 애플리케이션을 Azure에 쉽게 배포할 수 있습니다. 이 서비스는 개발자가 코드에 집중할 수 있도록 Spring 애플리케이션의 인프라를 관리합니다. Azure Spring Apps는 포괄적인 모니터링 및 진단, 구성 관리, 서비스 검색, CI/CD 통합, 파란색-녹색 배포 등을 사용하여 수명 주기 관리를 제공합니다. Azure Spring Apps에 애플리케이션을 배포하려면 Azure Spring Apps에 첫 번째 애플리케이션 배포를 참조하세요.

다음 단계

Spring 개발자 용 Azure Spring Cloud Azure Stream Binder Event Hubs 샘플