Eventarc 트리거 구성

이 페이지에서는 Application Integration에서 Eventarc 트리거를 구성하는 방법을 설명합니다.

Eventarc 트리거를 사용하면 Eventarc Standard를 통해 라우팅된 이벤트를 기반으로 통합을 실행할 수 있습니다. Eventarc 트리거를 사용하여 다양한 Google Cloud 서비스, 서드 파티 서비스, 맞춤 이벤트 소스의 이벤트에 의해 트리거되는 통합 흐름을 빌드할 수 있습니다. 예를 들어 트리거를 사용하여 새 객체가 Cloud Storage 버킷에 업로드될 때 통합을 시작할 수 있습니다.

Google Cloud 콘솔에서 다음과 같은 방법으로 Eventarc 트리거를 만들고 구성할 수 있습니다.

시작하기 전에

Eventarc 트리거를 구성하기 전에 Eventarc API와 Pub/Sub API를 사용 설정합니다.

API 사용 설정에 필요한 역할

API를 사용 설정하려면 serviceusage.services.enable 권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한이 이미 있을 수 있습니다. 그렇지 않으면 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할을 부여하는 방법 알아보기

API 사용 설정

고려사항

Eventarc 트리거를 구성할 때 다음 사항을 고려하세요.

  • 구성 오류로 인해 통합 게시 중에 Eventarc 트리거를 만들지 못하더라도 통합은 게시되지만 트리거는 활성화되지 않습니다.

    이 문제를 해결하려면 통합을 게시 취소하고 Eventarc 트리거 구성을 신중하게 검토하고 수정한 다음 통합을 다시 게시하세요. Google Cloud 콘솔 도구 모음에서 (알림)을 클릭하여 Eventarc 트리거 생성 상태를 확인할 수 있습니다.

  • 수정된 Eventarc 트리거 구성으로 통합의 새 버전을 게시하면 이전 트리거가 새 트리거로 자동 대체됩니다. 이렇게 하면 통합에서 항상 최신 트리거 구성을 사용하고 오래된 트리거를 삭제할 수 있습니다.
  • 통합의 새 버전을 게시하고 동일한 Eventarc 트리거와 구성을 사용하는 경우 새 트리거가 생성되지 않습니다. 대신 기존 Eventarc 트리거가 새 통합 버전에서 재사용됩니다.

Application Integration에서 Eventarc 트리거 만들기

Application Integration에서 Eventarc 트리거를 만들려면 다음 단계를 수행하세요.

  1. Application Integration에서 Eventarc 트리거 추가
  2. 통합 편집기에서 Eventarc 트리거 구성

Eventarc 트리거 추가

통합에 Eventarc 트리거를 추가하려면 다음 단계를 완료하세요.

  1. Google Cloud 콘솔에서 Application Integration 페이지로 이동합니다.

    Application Integration으로 이동

  2. 탐색 메뉴에서 통합을 클릭합니다.

    Google Cloud 프로젝트에서 사용할 수 있는 모든 통합이 나열된 통합 목록 페이지가 나타납니다.

  3. 기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.

    새 통합을 만드는 경우:

    1. 통합 만들기 창에 이름과 설명을 입력합니다.
    2. 통합 리전을 선택합니다.
    3. 통합을 위한 서비스 계정을 선택합니다. 통합 툴바의 통합 요약 창에서 언제든지 통합에 대한 서비스 계정 세부정보를 변경하거나 업데이트할 수 있습니다.
    4. 만들기를 클릭합니다.

    새로 만든 통합이 통합 편집기에서 열립니다.

  4. 통합 편집기 탐색 메뉴에서 트리거를 클릭하여 사용 가능한 트리거 목록을 확인합니다.
  5. 통합 편집기에서 Eventarc 요소를 드래그 앤 드롭합니다.

Eventarc 트리거 구성

Eventarc 트리거를 구성하려면 통합 편집기에서 Eventarc 트리거 요소를 클릭합니다. Eventarc 트리거 구성 창이 표시되고 다음 필드가 표시됩니다.

  • 라벨: (선택사항) 통합에서 표시되는 Eventarc 트리거의 이름입니다. 라벨을 원하는 이름으로 변경할 수 있습니다.
  • 참고: (선택사항) 트리거에 대한 추가 정보를 제공하기 위해 메모를 추가할 수 있습니다.
  • Eventarc 트리거 구성을 클릭하고 Eventarc 트리거 편집기에 다음 입력을 제공합니다.
    • 트리거 이름: 트리거 이름을 입력합니다.
    • 트리거 유형: 다음 트리거 유형 중 하나를 선택합니다.
      • Google 소스: Pub/Sub, Cloud Storage, Firestore, 기타 Google 이벤트 제공자의 트리거를 만들려면 이 옵션을 선택합니다.
      • 맞춤: 맞춤 이벤트 소스의 트리거를 만들려면 이 옵션을 선택합니다.
      • 서드 파티: Eventarc 소스를 제공하는 Google 이외의 제공업체의 트리거를 만들려면 이 옵션을 선택합니다. 자세한 내용은 Eventarc의 서드 파티 이벤트를 참고하세요.
    • 이벤트 제공자: 트리거의 이벤트 제공자를 선택합니다. 이벤트 제공업체 목록은 트리거 유형에 따라 다릅니다. 자세한 내용은 이벤트 제공자 및 대상을 참고하세요.
    • 이벤트 유형: 트리거의 이벤트 유형을 선택합니다. 트리거 구성은 선택한 이벤트 제공업체에 따라 다릅니다. 자세한 내용은 이벤트 유형을 참고하세요.
    • 리전: 트리거의 리전을 선택합니다.
    • 필터: (선택사항) 필터를 추가하여 기준과 일치하는 API를 선택합니다. 예를 들어 특정 이름별로 API를 필터링하면 필터 기준과 일치하는 API가 업데이트된 경우에만 이벤트가 트리거됩니다.
    • 서비스 계정: 트리거에 사용할 서비스 계정을 선택합니다. 서비스 계정을 선택하지 않으면 트리거는 서비스를 호출할 때 Compute Engine 기본 서비스 계정을 ID로 사용합니다. 트리거와 연결된 서비스 계정에는 서비스를 호출하는 데 필요한 권한이 있어야 합니다.

    • 실패 시 재시도: 도착 페이지에서 이벤트를 처리하지 못하는 경우 트리거 재시도를 사용 설정하려면 선택합니다.
    • 네트워크 연결: 트리거에 사용할 네트워크 연결을 선택합니다. 이 목록은 프로젝트에서 생성된 네트워크 연결을 기반으로 생성됩니다.

      네트워크 연결은 서비스 프로듀서 가상 프라이빗 클라우드 (VPC) 네트워크와 소비자 VPC 네트워크 간의 통신을 지원합니다. Eventarc는 구성된 네트워크 연결을 사용하여 소비자 VPC 네트워크 내에 호스팅된 내부 HTTP 엔드포인트에 연결하여 이벤트 데이터 전송을 지원합니다. 네트워크 연결을 만들고 관리하는 방법에 대한 자세한 내용은 네트워크 연결 만들기 및 관리를 참고하세요.

  • 트리거 구성을 저장하려면 트리거 저장을 클릭합니다.

Eventarc 콘솔을 사용하여 Eventarc 트리거 만들기

Eventarc 콘솔 페이지에서 Eventarc 트리거를 만들려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 Eventarc > 트리거 페이지로 이동합니다.

    트리거로 이동

    트리거 페이지에 프로젝트의 모든 트리거가 나열됩니다.

  2. 트리거 만들기를 클릭합니다.
  3. 트리거 만들기 페이지에서 다음 입력을 제공합니다.
    1. 트리거 이름: 트리거 이름을 입력합니다.
    2. 트리거 유형: 다음 트리거 유형 중 하나를 선택합니다.
      • Google 소스: Pub/Sub, Cloud Storage, Firestore, 기타 Google 이벤트 제공자의 트리거를 만들려면 이 옵션을 선택합니다.
      • 맞춤: 맞춤 이벤트 소스의 트리거를 만들려면 이 옵션을 선택합니다.
      • 서드 파티: Eventarc 소스를 제공하는 Google 이외의 제공업체의 트리거를 만들려면 이 옵션을 선택합니다. 자세한 내용은 Eventarc의 서드 파티 이벤트를 참고하세요.
    3. 이벤트 제공자: 트리거의 이벤트 제공자를 선택합니다. 이벤트 제공업체 목록은 트리거 유형에 따라 다릅니다. 자세한 내용은 이벤트 제공자 및 대상을 참고하세요.
    4. 이벤트 유형: 트리거의 이벤트 유형을 선택합니다. 트리거 구성은 선택한 이벤트 제공업체에 따라 다릅니다. 자세한 내용은 이벤트 유형을 참조하세요.
    5. 이벤트 데이터 콘텐츠 유형: 이벤트 콘텐츠의 데이터 유형을 선택합니다. application/json 또는 application/protobuf를 선택합니다.
    6. 리전: 트리거의 리전을 선택합니다.
    7. 서비스 계정: 트리거에 사용할 서비스 계정을 선택합니다. 서비스 계정을 선택하지 않으면 트리거는 서비스를 호출할 때 Compute Engine 기본 서비스 계정을 ID로 사용합니다. 트리거와 연결된 서비스 계정에는 서비스를 호출하는 데 필요한 권한이 있어야 합니다.
    8. 이벤트 대상: Application Integration을 선택합니다.
    9. 통합 선택: 트리거를 만들 통합을 선택합니다. 통합이 게시된 경우 Application Integration은 Eventarc 트리거를 추가하기 위해 통합의 새 초안 버전을 만듭니다.
    10. 네트워크 연결: 트리거에 사용할 네트워크 연결을 선택합니다. 이 목록은 프로젝트에서 생성된 네트워크 연결을 기반으로 생성됩니다.

      네트워크 연결은 서비스 프로듀서 가상 프라이빗 클라우드 (VPC) 네트워크와 소비자 VPC 네트워크 간의 통신을 지원합니다. Eventarc는 구성된 네트워크 연결을 사용하여 소비자 VPC 네트워크 내에 호스팅된 내부 HTTP 엔드포인트에 연결하여 이벤트 데이터를 전송할 수 있습니다. 네트워크 연결에 관한 자세한 내용은 네트워크 연결 정보를 참고하세요.

  4. 통합 열기를 클릭합니다.

    통합이 선택되고 새 Eventarc 트리거 요소가 통합에 추가된 상태로 Application Integration 편집기 페이지가 열립니다.

  5. Eventarc 트리거 요소를 클릭하고 트리거 구성 창을 엽니다.
  6. Eventarc 트리거 편집기 페이지에서 트리거 구성을 검토하고 확인합니다.
  7. 새 Eventarc 트리거를 통합 흐름에 연결하고 통합을 게시합니다.