이벤트로 트리거

Eventarc는 기본 인프라를 구현, 맞춤설정, 유지보수할 필요 없이 이벤트 기반 아키텍처를 빌드할 수 있게 해주는 Google Cloud 서비스입니다.

이벤트 소스 및 대상 Cloud Run 서비스를 포함하여 트리거의 필터를 지정하고 이벤트 라우팅을 구성하여 Eventarc 트리거를 만들 수 있습니다. 지정된 이벤트 또는 이벤트 집합이 필터와 일치하면 이벤트 응답으로 Cloud Run 서비스가 자동으로 호출됩니다.

Cloud Run 서비스에 전송되는 이벤트는 HTTP 요청 형식으로 수신됩니다.

다음 이벤트 유형은 서비스 요청을 트리거합니다.

이 페이지에서는 Cloud Run 콘솔 페이지를 통해 서비스의 트리거를 만드는 방법을 보여줍니다. 함수의 트리거를 만드는 간단한 방법은 Cloud Run에서 함수 배포를 참조하세요.

또한 Google Cloud CLI 또는 Eventarc 콘솔 페이지를 통해 Eventarc 트리거를 만들 수 있습니다. 특정 공급자, 이벤트 유형, 대상에 대한 트리거를 만드는 방법을 보려면 필터를 사용해서 Eventarc의 이벤트 공급자 및 대상에 대해 자세히 알아보세요.

시작하기 전에

Eventarc에서 트리거를 만들려면 먼저 트리거 ID에 필요한 역할을 이해해야 합니다.

  1. Eventarc API를 사용 설정합니다.

    API 사용 설정

  2. 모든 Eventarc 트리거는 트리거가 생성될 때 Identity and Access Management(IAM) 서비스 계정과 연결됩니다. 이 서비스 계정을 트리거 서비스 계정이라고 하며 Eventarc API 호출을 위해 사용됩니다. 예를 들어 인증이 필요한 Cloud Run 서비스로 이벤트를 전송하려면 트리거 ID에 Cloud Run 호출자 IAM(roles/run.invoker) 역할이 부여되었는지 확인합니다.

  3. Cloud Storage에서 직접 이벤트의 트리거를 만드는 경우 pubsub.publisher 역할을 Cloud Storage 서비스 계정에 부여합니다.

    SERVICE_ACCOUNT="$(gcloud storage service-agent --project=PROJECT_ID)"

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="serviceAccount:${SERVICE_ACCOUNT}" \
    --role='roles/pubsub.publisher'

    PROJECT_ID를 Google Cloud 프로젝트 ID로 바꿉니다. 프로젝트 ID는 Google Cloud 콘솔의 시작 페이지에서 찾을 수 있습니다.

트리거 만들기

서비스를 배포한 후 Cloud Run 콘솔 페이지를 사용하여 Eventarc 트리거를 만듭니다.

  1. Google Cloud 콘솔에서 Cloud Run으로 이동합니다.

    Cloud Run으로 이동

  2. 서비스 목록에서 기존 서비스를 클릭하거나 새 서비스를 만듭니다.

  3. 서비스 세부정보 페이지에서 트리거 탭을 클릭합니다.

  4. Eventarc 트리거 추가를 클릭합니다.

    Eventarc 트리거 창이 열립니다. 이벤트를 라우팅하는 최선의 방법을 결정하려면 이벤트 라우팅 옵션을 참조하세요.

  5. 안내에 따라 특정 제공업체, 이벤트 유형, 대상에 대한 트리거를 만들고 '트리거 만들기' 섹션의 콘솔 안내를 참조합니다.

  6. Cloud Run 서비스를 호출하는 서비스 계정을 선택하거나 새 서비스 계정을 만듭니다.

    이렇게 하면 트리거와 연결된 IAM 서비스 계정 이메일이 지정됩니다. Cloud Run 대상의 경우 서비스를 호출할 때 ID 토큰을 생성하는 데 이 서비스 계정이 사용됩니다.

  7. 선택적으로 수신 요청을 전송할 서비스 URL 경로를 지정합니다.

    이는 트리거의 이벤트가 전송되어야 하는 대상 서비스의 상대 경로입니다. 예: /, /route, route, route/subroute

  8. 트리거를 만든 후에는 트리거 탭에 체크 표시 이 있는지 확인하면 상태를 확인합니다.

다음 단계