Pub/Sub 트리거

Cloud Run Functions에서 Pub/Sub 트리거는 Pub/Sub 메시지에 대한 응답으로 함수를 호출할 수 있습니다. 함수에 대해 Pub/Sub 트리거를 지정할 때는 Pub/Sub 주제도 지정합니다. 함수는 메시지가 지정된 주제에 게시될 때마다 호출됩니다.

Pub/Sub 트리거는 CloudEvent 함수로 구현되며, 여기서 Pub/Sub 이벤트 데이터는 CloudEvents 형식의 함수에 전달되고 CloudEvent 데이터 페이로드는 MessagePublishedData 유형입니다.

Google 이벤트 저장소에는 이벤트 데이터 작업을 위한 추가 리소스가 포함되어 있습니다.

배포

함수를 배포할 때 Pub/Sub 트리거를 지정할 수 있습니다. 함수 배포 방법에 대한 일반 안내는 Cloud Run Functions 배포를 참조하고 배포 중 Pub/Sub 트리거 구성에 대한 추가 정보는 이 섹션을 참조하세요.

gcloud

gcloud CLI를 사용하여 배포하는 경우에는 여기에 표시된 플래그를 사용하여 Pub/Sub 트리거를 구성합니다.

gcloud functions deploy YOUR_FUNCTION_NAME \
--trigger-topic=YOUR_PUBSUB_TOPIC \
[--retry] \
...
  • --trigger-topic 플래그는 트리거가 모니터링하는 Pub/Sub 주제를 지정합니다. 이 주제에 게시된 메시지가 함수 호출을 트리거합니다.
  • --retry 플래그는 실패한 함수 호출이 자동으로 재시도되는지 여부를 제어합니다. 자세한 내용은 이벤트 기반 함수 재시도를 참조하세요.

콘솔

Google Cloud 콘솔을 사용하여 배포하는 경우 트리거 섹션에서 Pub/Sub 트리거를 구성할 수 있습니다.

  1. 트리거 유형 필드에서 Cloud Pub/Sub를 선택합니다.
  2. Cloud Pub/Sub 주제 필드에서 트리거로 모니터링할 주제를 선택합니다. 이 주제에 게시된 메시지가 함수 호출을 트리거합니다.
  3. 실패 시 재시도 체크박스를 선택하거나 선택 해제하여 Cloud Run Functions가 실패한 함수 호출을 자동으로 재시도할지 여부를 제어합니다. 자세한 내용은 이벤트 기반 함수 재시도를 참조하세요.

  4. 옵션 더보기를 클릭하여 트리거를 추가로 구성합니다.

    • 트리거 유형 필드에서 Google 소스, 커스텀, 서드 파티 중 하나를 지정합니다.

      • Google 소스를 사용하면 Pub/Sub, Cloud Storage, Firestore, 기타 Google 이벤트 제공업체의 트리거를 지정할 수 있습니다. Eventarc 트리거 창에서 이벤트 제공자 필드를 사용하여 함수를 트리거할 이벤트 유형을 제공하는 제품을 선택하세요. 그런 다음 이벤트 필드에서 트리거로 사용할 이벤트를 선택합니다.

      • 커스텀 옵션을 사용하면 애플리케이션 코드에서 이벤트를 생성하고 사용할 수 있습니다. Eventarc 트리거 창의 메시지에 따라 채널을 만듭니다. 채널은 제작자로부터 소비자에게 맞춤 이벤트를 전달하기 위해 파이프라인으로 사용되는 리소스입니다. 맞춤 이벤트가 채널에 게시되고 Eventarc 트리거가 이러한 이벤트를 구독합니다.

      • 서드 파티 옵션을 사용하면 Eventarc 소스를 제공하는 Google 이외의 제공업체와 통합할 수 있습니다. 자세한 내용은 Eventarc의 서드 파티 이벤트를 참조하세요.

    • 이벤트 필드에서 트리거 이벤트를 선택합니다. 기본값은 google.cloud.pubsub.topic.v1.messagePublished입니다.

    • 선택적으로 서비스 계정 필드에서 Eventarc 트리거의 ID로 사용할 서비스 계정을 선택합니다. 자세한 내용은 트리거 ID를 참조하세요.

  5. 트리거 저장을 클릭합니다.

다음 단계