Cloud Pub/Sub 트리거

Cloud Pub/Sub 트리거를 사용하면 Pub/Sub 미들웨어의 이벤트를 기반으로 통합을 실행할 수 있습니다.

이 트리거를 사용하면 게시자가 선택된 주제에 메시지를 쓸 때마다 통합을 실행할 수 있습니다. 이 트리거가 실행되면 게시된 메시지도 CloudPubSubMessage 출력 변수에 작성됩니다. 요구사항에 따라 다운스트림 트리거 또는 태스크에서 이 변수를 사용할 수 있습니다.

시작하기 전에

Cloud Pub/Sub 트리거를 구성하기 전에 Google Cloud 프로젝트에서 다음 태스크를 수행해야 합니다.

  • 다음 IAM 역할을 기본 서비스 계정(service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com)에 할당합니다.
  • Pub/Sub 주제가 있는지 확인합니다. 새 Pub/Sub 주제를 만들려면 다음 안내를 따르세요.
    1. Cloud 콘솔에서 Pub/Sub 주제 페이지로 이동합니다.

      Pub/Sub 주제 페이지로 이동

    2. 주제 만들기를 클릭합니다.
    3. 주제 ID 필드에 고유한 주제 이름을 제공합니다.
    4. 저장을 클릭합니다.

IAM 역할을 사용한 액세스 관리에 대한 자세한 내용은 액세스 제어를 참조하세요.

주 구성원에게 역할을 부여하는 방법은 액세스 권한 부여, 변경, 취소를 참조하세요.

Cloud Pub/Sub 트리거 추가

신규 또는 기존 통합에 Cloud Pub/Sub 트리거를 추가하려면 다음 단계를 따르세요.
  1. Apigee UI에서 Apigee 조직을 선택합니다.
  2. 개발 > 통합을 클릭합니다.
  3. 기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.

    새 통합을 만드는 경우:

    1. 통합 만들기 대화상자에 이름과 설명을 입력합니다.
    2. 지원되는 리전 목록에서 통합에 대한 리전을 선택합니다.
    3. 만들기를 클릭합니다.

    통합 디자이너 페이지에서 통합이 열립니다.

  4. 통합 디자이너 탐색 메뉴에서 +태스크/트리거 추가 > 트리거를 클릭하여 사용 가능한 트리거 목록을 봅니다.
  5. Cloud Pub/Sub 트리거 요소를 클릭하여 디자이너에 배치합니다.

Cloud Pub/Sub 트리거 구성

통합 편집기에서 Cloud Pub/Sub 트리거 요소를 클릭하여 트리거 구성 창을 확인한 후 다음 태스크를 수행합니다.

Pub/Sub 주제 필드에 다음 형식으로 트리거로 리슨할 주제를 지정합니다.

projects/PROJECT_ID/topics/TOPIC_ID

Google Cloud 프로젝트에서 사용 가능한 모든 주제를 보려면 주제에서 주제 이름 열을 참조하세요.

다음을 바꿉니다.

  • PROJECT_ID: 주제가 생성된 Google Cloud 프로젝트입니다.
  • TOPIC_ID: Pub/Sub 주제 ID입니다.

트리거 출력

각 이벤트에 대해 Cloud Pub/Sub 트리거는 다운스트림 태스크에서 사용할 수 있는 CloudPubSubMessage 출력 변수를 생성합니다. 변수는 JSON 형식이며 PubsubMessage 구조를 갖습니다.

고려사항

  • Pub/Sub 메시지 최대 크기는 10MB입니다. Pub/Sub의 모든 제한사항을 이해하려면 Pub/Sub 할당량 및 한도를 참조하세요.
  • Pub/Sub가 같은 메시지를 두 번 이상 주제에 쓸 수 있습니다. Pub/Sub의 이 동작을 이해하려면 최소 1회 전송을 참조하세요. 따라서 메시지가 주제에 두 번 이상 작성되지 않도록 통합이 멱등성을 갖도록 설계해야 합니다.

    메시지 헤더의 message_id 필드는 Pub/Sub 메시지를 고유하게 식별합니다.

  • 통합을 게시 취소해도 Pub/Sub 구독은 삭제되지 않으므로 메시지가 손실되지 않습니다. 하지만 게시된 버전이나 통합의 모든 통합 버전을 삭제하면 Pub/Sub 구독도 삭제됩니다.

할당량 및 한도

할당량 및 한도에 대한 자세한 내용은 할당량 및 한도를 참조하세요.

다음 단계