Pub/Sub 트리거(1세대)

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

함수가 Pub/Sub 트리거를 사용할 수 있으려면 이벤트 기반 함수로 구현되어야 합니다.

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

배포

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

gcloud

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

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

기존 Pub/Sub 이벤트

Cloud Run Functions(1세대)의 기존 함수는 Pub/Sub 트리거에 대해 다른 이벤트 유형을 사용합니다.

gcloud functions deploy YOUR_FUNCTION_NAME \
--no-gen2 \
--trigger-event=providers/cloud.pubsub/eventTypes/topic.publish \
--trigger-resource=YOUR_PUBSUB_TOPIC \
...

이 이벤트 유형은 이미 이러한 이벤트를 사용 중인 기존 함수에 대해 지원됩니다. 하지만 기존 이벤트 유형은 향후에 삭제 될 수 있으므로 대신 --trigger-topic 플래그를 사용하는 것이 좋습니다.

콘솔

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

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

다음 단계