8 min read

애저 CLI를 이용해 애저 이벤트그리드 구독 및 로직앱 이벤트 핸들러 프로비저닝하기

Justin Yoo

애저 이벤트그리드라는 서비스를 이용하면 다양한 형태의 이벤트 기반 아키텍처를 구성할 수 있다. 특히 다양한 형태로 기존에 존재하는 애플리케이션간 이벤트 메시지를 전송하는데 있어서 꽤 유용하게 쓰인다.

Azure Event Grid

이벤트 기반 아키텍처의 세 요소

이벤트 기반 아키텍처에는 중요한 역할을 하는 세 가지 요소가 있다.

이벤트 생성자/퍼블리셔

이벤트 생성자/퍼블리셔는 이벤트가 발생하는 근원이다. 이벤트만 발생시킬 수 있다면 무엇이든 이벤트 생성자가 될 수 있다. 아래 그림은 지난 2018년 오픈 인프라 데이즈에서 발표했던 클라우드이벤트 CloudEvents 발표 내용의 일부를 캡쳐한 것이다. 아래 그림에서는 라즈베리파이 장치에서 이벤트를 생성하는 것에 대해 묘사하고 있다.

Event Publisher

이벤트 구독자/섭스크라이버/처리자/핸들러

이벤트 구독자와 처리자는 엄밀히 말하면 다른 것이긴 하지만, 보통은 구독하면서 동시에 해당 이벤트를 처리하기 때문에 같은 것드로 봐도 큰 무리는 없다. 아래 그림에서는 이벤트 생성자가 보낸 이벤트를 받아 시각화 처리를 하는 형태를 묘사하고 있다.

Event Subscriber

이벤트 중개자/브로커

일반적으로 이 이벤트 생성자와 구독자 사이에서는 직접적인 연결을 하지 않고 비동기식으로 진행하는데, 이 때 필요한 것이 바로 애저 이벤트그리드와 같은 이벤트 중개자가 있다. 아래 그림은 바로 애저 이벤트그리드가 이벤트 생성자와 구독자 사이에서 어떤 역할을 하는지 보여준다.

Event Broker

클라우드이벤트에 대해 좀 더 알고 싶다면, 발표 영상발표 자료를 확인해 보자.

애저 이벤트그리드 구독자 생성하기

일반적인 CI/CD 환경에서 애저 이벤트그리드 토픽을 생성할 때에는 ARM 템플릿을 이용하면 쉽다. 하지만, 이벤트그리드 구독을 생성하는 ARM 템플릿은 내가 생성한 이벤트그리드 토픽을 지정할 수 없기 때문에 여기서는 사용할 수 없다. 대신, 애저 CLI를 사용해서 내가 지정한 토픽에 대해 구독을 생성하면 된다.


추가:

정확하게는 이벤트그리드 구독 리소스를 생성하면서 토픽을 지정할 수 있는 방법이 사실 두 가지가 있다.

스코프 지정하기 (권장하는 방법)

위에 언급한 이벤트그리드 구독용 ARM 템플릿을 사용하기 위해서는 scope 속성값을 지정해 주면 된다 (line #7). ARM 템플릿을 bicep으로 구현하면 아래와 같다.

resource evtgrdtopic 'Microsoft.EventGrid/topics@2020-06-01' = {
name: 'my-eventgrid-topic'
}
resource evtgrdsub 'Microsoft.EventGrid/eventSubscriptions@2020-06-01' = {
name: 'my-eventgrid-sub'
scope: evtgrdtopic
...
}

하위 리소스 타입 지정하기 (권장하지는 않지만 허용되는 방법)

또는 아래와 같이 하위 리소스 타입으로 구현을 해도 된다. 이 떄는 scope 속성값이 필요하진 않지만, 리소스 타입과 이름을 좀 더 번거롭게 정해줘야 한다 (line #6-7).

resource evtgrdtopic 'Microsoft.EventGrid/topics@2020-06-01' = {
name: 'my-eventgrid-topic'
...
}
resource evtgrdsub 'Microsoft.EventGrid/topics/providers/eventSubscriptions@2020-06-01' = {
name: '${evtgrdtopic.name}/Microsoft.EventGrid/my-eventgrid-sub'
...
}

위와 같은 방식으로 애저 이벤트그리드 구독 리소스를 프로비저닝해도 되지만, 이 포스트는 애저 CLI에 초점을 맞추도록 하자.


애저 CLI 사전 준비사항

애저 CLI로 이벤트그리드 구독 리소스를 프로비저닝하기 위해서는 아래 확장기능을 먼저 설치해야 한다. 여기서 Logic애저 로직앱을 위한 것인데, 이 포스트에서는 이벤트 처리자로서 로직앱을 사용하기 때문이다.

이 두 확장기능은 이 글을 쓰는 현재 프리뷰 기능이며 언제든 구현이 바뀔 수 있다.

애저 CLI 명령어

먼저 애저 로직앱을 이벤트 처리자로 사용하기 위해서는 로직앱의 엔드포인트 URL을 알아내야 한다. 로직앱은 특성상 엔드포인트 뒤에 항상 SAS 토큰이 붙어오기 때문에 이를 함께 불러와야 한다. 먼저 엔드포인트를 찾고자 하는 로직앱의 리소스 ID를 아래와 같이 az logic workflow show 명령어를 통해 알아낸다.

logicAppResourceId=$(az logic workflow show \
-g <resource_group_name> \
-n <logic_app_name> \
--query "id" -o tsv)

그 다음에는 az rest 명령어를 통해 SAS 토큰이 붙어 있는 엔드포인트 값을 알아낸다.

logicAppEndpoint=$(az rest \
-m POST \
-u "https://management.azure.com$logicAppResourceId/triggers/manual/listCallbackUrl?api-version=2016-06-01" \
--query "value" -o tsv)
view raw 02-az-rest.sh hosted with ❤ by GitHub

이제 로직앱을 이벤트 처리자로 사용하기 위한 준비는 끝났다. 다음 순서는 이벤트그리드 토픽의 리소스 ID를 아래와 같이 az eventgrid topic show 명령어를 통해 알아낸다.

eventGridTopicId=$(az eventgrid topic show \
-g <resource_group_name> \
-n <eventgrid_topic_name> \
--query "id" -o tsv)

이벤트그리드 구독자를 생성하기 위한 모든 준비가 끝났다. 아래 az eventgrid event-subscription create 명령어를 통해 이벤트그리드 구독자를 생성한다. 여기서는 CNCF의 인큐베이팅 프로젝트인 CloudEvents 스키마를 사용하는 것으로 한다.

az eventgrid event-subscription create \
-n <eventgrid_subscription_name> \
--source-resource-id $eventGridTopicId \
--event-delivery-schema cloudeventschemav1_0 \
--endpoint-type webhook \
--endpoint $logicAppEndpoint

위와 같은 방법으로 하면 곧바로 애저 이벤트그리드 구독자 리소스를 프로비저닝할 수 있다. 위 명령어를 한줄로 합치면 아래와 같다.

az eventgrid event-subscription create \
-n <eventgrid_subscription_name> \
--source-resource-id $(az eventgrid topic show \
-g <resource_group_name> \
-n <eventgrid_topic_name> \
--query "id" -o tsv) \
--event-delivery-schema cloudeventschemav1_0 \
--endpoint-type webhook \
--endpoint $(az rest \
-m POST \
-u "https://management.azure.com$(az logic workflow show \
-g <resource_group_name> \
-n <logic_app_name> \
--query "id" -o tsv)/triggers/manual/listCallbackUrl?api-version=2016-06-01" \
--query "value" -o tsv)
view raw 05-one-liner.sh hosted with ❤ by GitHub

지금까지 이벤트그리드 구독자를 프로비저닝하고 로직앱을 그 처리자로 설정하기 위해 애저 CLI를 이용하는 방법에 대해 알아 보았다. 이를 조금 더 활용하면 깃헙 액션과 같은 CI/CD 파이프라인에서도 손쉽게 통합시킬 수 있을 것이다.