Cloud Run 함수 트리거

함수의 트리거를 지정하여 다양한 시나리오에 대한 응답으로 실행되도록 Cloud Run Functions를 설정할 수 있습니다. 트리거는 HTTP(S) 요청이거나 지원되는 여러 이벤트 중 하나일 수 있습니다. 이 페이지에서는 Cloud Run Functions에서 지원되는 트리거를 간략히 설명합니다.

트리거는 크게 두 가지 카테고리로 나뉩니다.

  • HTTP 트리거: HTTP(S) 요청에 응답하고 HTTP 함수에 대응합니다.

  • 이벤트 트리거: Google Cloud 프로젝트 내의 이벤트에 응답하고 이벤트 기반 함수에 대응합니다.

함수 배포의 일부로 트리거를 지정합니다. 동일한 함수를 한 번에 둘 이상의 트리거에 결합할 수는 없지만 동일한 트리거 설정으로 여러 함수를 배포하여 동일한 이벤트로 인해 여러 함수를 실행할 수 있습니다.

지원되는 트리거

Cloud Run Functions는 다음과 같은 유형의 트리거를 지원합니다.

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

Pub/Sub 및 Webhook을 통한 추가 트리거

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 Cloud Run 함수를 예약할 수 있습니다. 자세한 내용은 Cloud Scheduler 문서의 HTTP Cloud Run 함수 예약을 참고하세요.

Pub/Sub 주제에 메시지가 게시되는 경우와 같이 Google Cloud 프로젝트 내에서 이벤트에 대한 응답으로 함수를 직접 트리거해야 하는 경우 이벤트 기반 함수를 예약할 수 있습니다. 자세한 내용은 Cloud Scheduler 문서의 이벤트 기반 Cloud Run 함수 예약을 참고하세요.

Cloud Tasks

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

Gmail

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