함수 트리거

Cloud Run으로 함수를 만들고 배포한 후 트리거를 지정하여 함수가 다양한 시나리오에 대한 응답으로 실행되도록 설정할 수 있습니다.

이 페이지에서는 Cloud Run Functions에서 지원하는 트리거를 간략하게 설명합니다.

트리거 유형

기본적으로 Cloud Run에 배포된 모든 함수는 HTTP 엔드포인트(run.app URL)가 있는 Cloud Run 소스 배포 서비스입니다.

함수가 호출되거나 트리거되는 방식은 코드를 작성할 때 지정하는 함수 유형에 따라 다릅니다.

  • CloudEvent 트리거: Google Cloud 프로젝트 내 이벤트에 반응하며 CloudEvents 함수(이벤트 기반 함수라고도 함)에 대응합니다. 지정된 이벤트에 대한 응답으로 함수를 트리거하려면 이벤트 기반 아키텍처 빌드를 지원하는 CloudEvents 사양의 Google 구현인 Eventarc를 사용해야 합니다.
  • HTTP 트리거: HTTP(S) 요청에 반응하고 HTTP 함수에 대응합니다. 다른Google Cloud 서비스(Eventarc가 아님)를 이벤트 제공업체로 사용하여 HTTP(S) 요청을 통해 함수를 호출할 수 있습니다.

함수가 Google Cloud 프로젝트 내 이벤트에 반응하도록 트리거하려면 Google Cloud 콘솔에서 함수 배포 과정의 일부로 또는 gcloud CLI를 사용할 경우 함수가 배포된 후에 트리거를 지정합니다.

같은 함수를 한 번에 트리거 두 개 이상에 바인딩할 수는 없지만 같은 트리거 설정으로 함수 여러 개를 배포하면 같은 이벤트로 인해 함수 여러 개가 실행될 수 있습니다.

트리거 예시

다음은 Cloud Run Functions에서 지원하는 트리거의 예시입니다.

모든 CloudEvents 함수는 이벤트 전송에 Eventarc를 사용합니다. Pub/Sub 트리거 및 Cloud Storage 트리거는 특정 유형의 Eventarc 트리거로 구현됩니다.

Pub/Sub 및 웹훅을 사용하는 추가 트리거

Pub/Sub 주제의 메시지로 Cloud Run Functions를 트리거할 수 있으므로 Pub/Sub을 이벤트 버스로 지원하는 다른 Google 서비스와 Cloud Run Functions를 통합할 수 있습니다. 또한 HTTP 트리거를 사용하여 HTTP 콜백(웹훅)을 제공하는 모든 서비스와 통합할 수 있습니다. 다음 섹션에서는 몇 가지 통합 예시를 설명합니다.

Cloud Logging

Cloud Logging은 로그를 Pub/Sub 주제로 라우팅할 수 있으며, 여기서 Cloud Run Functions에서 로그를 사용할 수 있습니다. 자세한 내용은 Cloud Logging 문서의 싱크 구성 및 관리를 참조하세요.

Cloud Scheduler

HTTP를 사용하여 작업을 트리거하는 Cloud Scheduler 작업을 만들어 HTTP 함수를 예약할 수 있습니다.

메시지가 Pub/Sub 주제에 게시되는 경우와 같이 Google Cloud 프로젝트 내에서 이벤트에 대한 응답으로 함수를 직접 트리거해야 하는 경우 CloudEvent 함수를 예약할 수도 있습니다.

Cloud Tasks

Cloud Tasks HTTP 대상 태스크를 사용하면 모든 HTTP 엔드포인트에서 태스크 핸들러를 실행할 수 있으므로 HTTP 트리거가 있는 HTTP 함수를 태스크 핸들러로 사용할 수 있습니다. 태스크를 사용하여 함수 호출을 제한하거나 호출 비율을 제한할 수도 있습니다. 자세한 내용은 Cloud Tasks 문서의 HTTP 대상 태스크 만들기를 참조하세요.

Gmail

Gmail Push Notification API를 사용하여 Gmail 이벤트를 Pub/Sub 주제로 전송하여 Cloud Run에서 사용할 수 있습니다.