빠른 시작: Azure Portal을 사용하여 Azure Cache for Redis 이벤트를 웹 엔드포인트로 라우팅

Azure Event Grid는 클라우드에 대한 이벤트 서비스입니다. 이 빠른 시작에서는 Azure Portal을 사용하여 Azure Cache for Redis 인스턴스를 만들고, 해당 인스턴스에 대한 이벤트를 구독하고, 이벤트를 트리거하고, 결과를 확인합니다. 일반적으로 이벤트 데이터를 처리하고 작업을 수행하는 엔드포인트에 이벤트를 보냅니다. 그러나 이 빠른 시작을 간소화하기 위해 메시지를 수집하고 표시하는 웹앱으로 이벤트를 보냅니다.

Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.

완료되면 이벤트 데이터가 웹앱에 보내졌음을 확인할 수 있습니다.

Azure Event Grid Viewer scaling in JSON format.

Azure Cache for Redis 캐시 인스턴스 만들기

  1. 캐시를 만들려면 Azure Portal에 로그인하여 리소스 만들기를 선택합니다.

    Create a resource is highlighted in the left navigation pane.

  2. 새로 만들기 페이지에서 데이터베이스를 선택한 다음, Azure Cache for Redis를 선택합니다.

    On New, Databases is highlighted, and Azure Cache for Redis is highlighted.

  3. 새 Redis Cache 페이지에서 새 캐시의 설정을 구성합니다.

    설정 값 선택 설명
    구독 드롭다운하여 구독을 선택합니다. 이 구독 아래에 새 Azure Cache for Redis 인스턴스가 만들어집니다.
    리소스 그룹 드롭다운하여 리소스 그룹을 선택하거나, 새로 만들기를 선택하고 새 리소스 그룹 이름을 입력합니다. 캐시 및 기타 리소스를 만들 새 리소스 그룹의 이름입니다. 모든 앱 리소스를 하나의 리소스 그룹에 배치하면 앱 리소스를 쉽게 관리하거나 삭제할 수 있습니다.
    DNS 이름 고유한 이름을 입력합니다. 캐시 이름은 1~63자의 문자열이어야 하며 숫자, 문자, 하이픈만 포함할 수 있습니다. 이름은 숫자 또는 문자로 시작하고 끝나야 하며 연속 하이픈을 포함할 수 없습니다. 캐시 인스턴스의 ‘호스트 이름’은 ‘DNS 이름’<>.redis.cache.windows.net입니다.
    위치 드롭다운하여 위치를 선택합니다. 캐시를 사용할 다른 서비스와 가까이 있는 Azure 지역을 선택합니다.
    캐시 유형 드롭다운하여 계층을 선택합니다. 계층에 따라 캐시에 사용 가능한 크기, 성능 및 기능이 결정됩니다. 자세한 내용은 Azure Cache for Redis 개요를 참조하세요.
  4. 네트워킹 탭을 선택하거나 페이지 맨 아래에서 네트워킹 단추를 선택합니다.

  5. 네트워킹 탭에서 연결 방법을 선택합니다.

  6. 다음: 고급 탭을 선택하거나 페이지 아래쪽에서 다음: 고급 단추를 선택하여 고급 탭을 표시합니다.

    Screenshot showing the Advanced tab in the working pane and the available option to select.

    • 기본 또는 표준 캐시의 경우 TLS가 아닌 포트에 대한 선택을 토글합니다. Microsoft Entra 인증을 사용하도록 설정할지 선택할 수도 있습니다.
    • 프리미엄 캐시의 경우 TLS가 아닌 포트, 클러스터링, 관리 ID 및 데이터 지속성에 대한 설정을 구성합니다. Microsoft Entra 인증을 사용하도록 설정할지 선택할 수도 있습니다.
  7. 다음: 태그 탭을 선택하거나 페이지 맨 아래에서 다음: 태그 단추를 선택합니다.

  8. 필요에 따라 리소스를 분류하려는 경우 태그 탭에서 이름 및 값을 입력합니다.

  9. 검토 + 만들기를 선택합니다. 검토 + 만들기 탭으로 이동됩니다. 여기서 Azure가 구성의 유효성을 검사합니다.

  10. 녹색 유효성 검사 통과 메시지가 표시되면 만들기를 선택합니다.

캐시를 만드는 데 시간이 걸립니다. Azure Cache for Redis 개요 페이지에서 진행률을 모니터링할 수 있습니다. 상태실행 중으로 표시되면 캐시를 사용할 준비가 된 것입니다.

메시지 엔드포인트 만들기

캐시 인스턴스에 대한 이벤트를 구독하기 전에 이벤트 메시지에 대한 엔드포인트를 만들어 보겠습니다. 일반적으로 엔드포인트는 이벤트 데이터를 기반으로 작업을 수행합니다. 이 빠른 시작을 간소화하기 위해 이벤트 메시지를 표시하는 미리 작성된 웹앱을 배포합니다. 배포된 솔루션은 App Service 계획, App Service 웹앱 및 GitHub의 소스 코드를 포함합니다.

  1. GitHub README에서 Azure에 배포를 선택하여 솔루션을 구독에 배포합니다.

    Deploy to Azure button.

  2. 사용자 지정 배포 페이지에서 다음 단계를 수행합니다.

    1. 리소스 그룹에서 캐시 인스턴스를 만들 때 만든 리소스 그룹을 선택합니다. 자습서를 완료한 후 리소스 그룹을 삭제하면 더 쉽게 정리할 수 있습니다.
    2. 사이트 이름에 웹앱의 이름을 입력합니다.
    3. 호스팅 계획 이름에 웹앱을 호스팅하는 데 사용할 App Service 계획의 이름을 입력합니다.
    4. 위에 명시된 사용 약관에 동의함 확인란을 선택합니다.
    5. 구매를 선택합니다.
    설정 제안 값 설명
    구독 드롭다운하여 구독을 선택합니다. 이 웹앱을 만들려는 구독
    리소스 그룹 드롭다운하여 리소스 그룹을 선택하거나, 새로 만들기를 선택하고 새 리소스 그룹 이름을 입력합니다. 모든 앱 리소스를 하나의 리소스 그룹에 배치하면 앱 리소스를 쉽게 관리하거나 삭제할 수 있습니다.
    사이트 이름 웹앱의 이름을 입력합니다. 이 값은 비워둘 수 없습니다.
    호스팅 계획 이름 웹앱을 호스팅하는 데 사용할 App Service 요금제의 이름을 입력합니다. 이 값은 비워둘 수 없습니다.
  3. 포털에서 경고(벨 아이콘)를 선택하고 리소스 그룹으로 이동을 선택합니다.

    Azure portal deployment notification.

  4. 리소스 그룹 페이지의 리소스 목록에서 자신이 만든 웹앱을 선택합니다. 이 목록에는 App Service 요금제 및 캐시 인스턴스도 표시됩니다.

  5. 웹앱의 App Service 페이지에서 URL을 선택하여 웹 사이트로 이동합니다. URL은 https://<your-site-name>.azurewebsites.net 형식이어야 합니다.

  6. 사이트가 보이지만 사이트에 이벤트가 아직 게시되지 않았음을 확인합니다.

    Empty Event Grid Viewer site.

Event Grid 리소스 공급자 등록

이전에 Event Grid를 사용하지 않은 경우 Event Grid 리소스 공급자를 등록해야 합니다. 이전에 Event Grid 사용한 경우 다음 섹션으로 건너뜁니다.

Azure Portal에서 다음 단계를 수행합니다.

  1. 왼쪽 메뉴에서 구독을 선택합니다.

  2. 구독 목록에서 Event Grid에 사용할 구독을 선택합니다.

  3. 구독 페이지의 왼쪽 메뉴에 있는 설정에서 리소스 공급자를 선택합니다.

  4. Microsoft.EventGrid를 검색하고 상태등록되지 않음인지 확인합니다.

  5. 공급자 목록에서 Microsoft.EventGrid를 선택합니다.

  6. 명령 모음에서 등록을 선택합니다.

    Image showing the registration of Microsoft.EventGrid provider with the Azure subscription.

  7. 새로 고침하여 Microsoft.EventGrid의 상태가 Registered로 변경되었는지 확인합니다.

    Image showing the successful registration of Microsoft.EventGrid provider with the Azure subscription.

Azure Cache for Redis 인스턴스 구독

이 단계에서는 추적하려는 이벤트와 해당 이벤트를 보낼 위치를 Event Grid에 알리는 항목을 구독합니다.

  1. 포털에서 이전에 만든 캐시 인스턴스로 이동합니다.

  2. Azure Cache for Redis 페이지의 왼쪽 메뉴에서 이벤트를 선택합니다.

  3. 웹후크를 선택합니다. 엔드포인트에 대한 웹후크를 사용하여 뷰어 앱에 이벤트를 보냅니다.

    Azure portal Events page.

  4. 이벤트 구독 만들기 페이지에서 다음을 입력합니다.

    설정 제안 값 Description
    이름 이벤트 구독의 이름을 입력합니다. 값은 3~64자여야 합니다. 문자, 숫자 및 대시만 포함할 수 있습니다.
    이벤트 유형 드롭다운을 클릭하고 대상에 푸시할 이벤트 유형을 선택합니다. 이 빠른 시작에서는 캐시 인스턴스의 크기를 조정합니다. 사용 가능한 옵션은 패치, 크기 조정, 가져오기 및 내보내기입니다.
    엔드포인트 유형 웹후크를 선택합니다. 이벤트를 받는 이벤트 처리기입니다.
    엔드포인트 엔드포인트 선택을 선택하고, 웹앱의 URL을 입력하고, api/updates를 홈페이지 URL(예: https://cache.azurewebsites.net/api/updates)에 추가한 다음, 선택 확인을 선택합니다. 이전에 만든 웹앱의 URL입니다.
  5. 이제 이벤트 구독 만들기 페이지에서 만들기를 선택하여 이벤트 구독을 만듭니다.

  6. 웹앱을 다시 확인하고, 구독 유효성 검사 이벤트를 보냈음을 확인합니다. 눈 모양 아이콘을 선택하여 이벤트 데이터를 확장합니다. Event Grid는 유효성 검사 이벤트를 보내므로 엔드포인트는 이벤트 데이터를 수신하려는 것을 확인할 수 있습니다. 웹앱은 구독의 유효성을 검사하는 코드를 포함합니다.

    Azure Event Grid Viewer.

엔드포인트에 이벤트 보내기

이제 이벤트를 트리거하여 Event Grid가 메시지를 사용자 엔드포인트에 어떻게 배포하는지 살펴 보겠습니다. Azure Cache for Redis 인스턴스의 크기를 조정합니다.

  1. Azure Portal에서 Azure Cache for Redis 인스턴스로 이동하고, 왼쪽 메뉴에서 크기 조정을 선택합니다.

  2. 크기 조정 페이지에서 원하는 가격 책정 계층을 선택하고, 선택을 선택합니다.

    다른 가격 책정 계층으로 크기를 조정할 수 있지만 다음과 같은 제한 사항이 있습니다.

    • 높은 가격 책정 계층에서 낮은 가격 책정 계층으로 크기를 조정할 수 없습니다.
      • 프리미엄 캐시에서 표준 또는 기본 캐시로 축소할 수 없습니다.
      • 표준 캐시에서 기본 캐시로 축소할 수 없습니다.
    • 기본 캐시에서 표준 캐시로 크기를 조정할 수 있지만 동시에 크기를 변경할 수는 없습니다. 다른 크기가 필요한 경우 후속 크기 조정 작업을 통해 원하는 크기로 조정할 수 있습니다.
    • 기본 캐시에서 바로 프리미엄 캐시로 확장할 수 없습니다. 먼저 크기 조정 작업을 통해 기본에서 표준으로 확장한 다음, 후속 크기 조정 작업을 통해 표준에서 프리미엄으로 확장합니다.
    • 더 큰 크기에서 C0(250MB) 크기로 축소할 수 없습니다.

    캐시가 새 가격 책정 계층으로 조정하는 동안에는 왼쪽의 Azure Cache for Redis를 사용하여 크기 조정 중 상태가 표시됩니다. 크기 조정이 완료되면 상태가 Scaling(크기 조정 중)에서 실행 중으로 변경됩니다.

  3. 이벤트를 트리거했고 Event Grid가 구독할 때 구성한 엔드포인트로 메시지를 보냈습니다. 메시지는 JSON 형식이며 하나 이상의 이벤트가 있는 배열을 포함합니다. 다음 예제에서 JSON 메시지는 이벤트가 1개 있는 배열을 포함합니다. 웹앱을 살펴보고, ScalingCompleted 이벤트를 받았는지 확인합니다.

    Azure Event Grid Viewer scaling in JSON format.

리소스 정리

이 이벤트를 계속 사용하려는 경우 이 빠른 시작에서 만든 리소스를 정리하지 마세요. 그렇지 않은 경우 이 빠른 시작에서 만든 리소스를 삭제합니다.

리소스 그룹을 선택하고 리소스 그룹 삭제를 선택합니다.

다음 단계

이제 사용자 지정 항목 및 이벤트 구독을 만드는 방법에 대해 알아보았습니다. 다음으로 어떤 Event Grid가 도움이 되는지 자세히 알아보세요.