Application Integration에 지원되는 커넥터를 참조하세요.

Cloud Pub/Sub 트리거

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

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

시작하기 전에

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

이 트리거를 만드는 사용자에게 프로젝트 IAM 관리자(roles/resourcemanager.projectIamAdmin)를 할당합니다.
통합이 있는 Google Cloud 프로젝트에 대해 Pub/Sub API를 사용 설정합니다.
Pub/Sub 주제가 있는지 확인합니다. 새 Pub/Sub 주제를 만들려면 다음 안내를 따르세요.
1. Cloud 콘솔에서 Pub/Sub 주제 페이지로 이동합니다.
  Pub/Sub 주제 페이지로 이동
2. 주제 만들기를 클릭합니다.
3. 주제 ID 필드에 고유한 주제 이름을 제공합니다.
4. 저장을 클릭합니다.
참고: 트리거 작동을 위해 구독을 만들 필요가 없습니다. Application Integration은 주제에 대해 구독을 자동으로 만듭니다. Pub/Sub 구독 페이지에서 모든 구독을 확인할 수 있습니다.
Application Integration 2023년 12월 1일부터는 Pub/Sub 청구 요금에 따라 구독 비용이 청구됩니다. 기존 Cloud Pub/Sub 트리거의 구독은 계속 이전과 동일하게 작동하며 청구되지 않습니다. 그러나 기존 Cloud Pub/Sub 트리거 주제를 업데이트할 경우 업데이트된 Cloud Pub/Sub 트리거에 Pub/Sub 청구가 적용됩니다.

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

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

Cloud Pub/Sub 트리거 추가

신규 또는 기존 통합에 Cloud Pub/Sub 트리거를 추가하려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 Application Integration 페이지로 이동합니다.
Application Integration으로 이동
탐색 메뉴에서 통합을 클릭합니다.
Google Cloud 프로젝트에서 사용할 수 있는 모든 통합이 나열된 통합 목록 페이지가 나타납니다.
기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.
새 통합을 만드는 경우:
1. 통합 만들기 창에 이름과 설명을 입력합니다.
2. 통합 리전을 선택합니다.
  참고: 리전 드롭다운에는 Google Cloud 프로젝트에 프로비저닝된 리전만 나열됩니다. 새 리전을 프로비저닝하려면 리전 사용 설정을 클릭합니다. 자세한 내용은 새 리전 사용 설정을 참조하세요.
3. 통합을 위한 서비스 계정을 선택합니다. 통합 툴바의 통합 요약 창에서 언제든지 통합에 대한 서비스 계정 세부정보를 변경하거나 업데이트할 수 있습니다.
  참고: 서비스 계정 선택 옵션은 선택한 리전에 대해 통합 거버넌스를 사용 설정한 경우에만 표시됩니다.
4. 만들기를 클릭합니다.
통합 편집기 페이지에서 통합이 열립니다.
통합 편집기 탐색 메뉴에서 트리거를 클릭하여 사용 가능한 트리거 목록을 확인합니다.
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입니다. 주제는 통합과 동일한 Google Cloud 프로젝트에 있거나 다른 Google Cloud 프로젝트에 있을 수 있습니다.
트리거에 사용하려는 서비스 계정을 선택합니다. 서비스 계정을 선택하면 필요한 역할을 부여하라는 메시지가 표시됩니다. 자세한 내용은 필요한 IAM 역할을 참조하세요.
서비스 계정이 없으면 서비스 계정 드롭다운에서 새로 만들기를 클릭하여 서비스 계정을 만듭니다.

참고: Application Integration 2023년 12월 1일 출시 버전부터는 Cloud Pub/Sub 트리거를 구성할 때 트리거에 대한 서비스 계정을 지정해야 합니다. 연결된 서비스 계정이 없는 기존 Pub/Sub 트리거는 계속 이전과 동일하게 작동합니다. 하지만 기존 Pub/Sub 트리거를 수정하려면 해당 트리거를 계속 사용하도록 서비스 계정을 구성해야 합니다.

서비스 계정에 필요한 IAM 역할

서비스 계정을 선택할 때 권한 부여를 클릭하면 여러 서비스 계정에 다음 역할이 자동으로 제공됩니다.

서비스 계정 부여된 IAM 역할

서비스 계정	부여된 IAM 역할
Application Integration 기본 서비스 계정: `service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com`	Pub/Sub 편집자(`roles/pubsub.editor`) 서비스 계정 사용자(`roles/iam.serviceAccountUser`) Pub/Sub 주제의 Google Cloud 프로젝트가 통합의 Google Cloud 프로젝트와 다르면 기본 서비스 계정에 해당 주제의 Google Cloud 프로젝트에서 Pub/Sub 편집자 역할이 필요합니다.
이 트리거에 선택한 서비스 계정	Application Integration 호출자(`roles/integrations.integrationInvoker`)

Application Integration 기본 서비스 계정: service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com

Pub/Sub 편집자(roles/pubsub.editor)
서비스 계정 사용자(roles/iam.serviceAccountUser)

Pub/Sub 주제의 Google Cloud 프로젝트가 통합의 Google Cloud 프로젝트와 다르면 기본 서비스 계정에 해당 주제의 Google Cloud 프로젝트에서 Pub/Sub 편집자 역할이 필요합니다.

이 트리거에 선택한 서비스 계정 Application Integration 호출자(roles/integrations.integrationInvoker)

트리거 출력

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

고려사항

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

통합의 필터로 구독 만들기

통합의 특정 이벤트를 처리하도록 Pub/Sub 구독 필터를 설정하려면 다음 단계를 수행합니다.

구성된 Cloud Pub/Sub 트리거를 사용하여 통합을 게시합니다. 이 단계에서는 통합 프로젝트에서 구독을 만듭니다.
Google Cloud 콘솔에서 구독 페이지로 이동합니다.
구독 페이지로 이동
구독을 열고 구독 이름을 포함하여 모든 세부정보를 복사합니다.
기존 구독을 삭제합니다.
3단계에서 복사한 구독 이름을 포함한 모든 삭제된 구독의 세부정보를 사용하여 새 구독을 만들고 새 구독에 필터 추가도 수행합니다.
새로 생성된 구독은 필터링된 메시지와 통합을 트리거합니다.

SLA 예외

Cloud Pub/Sub 트리거는 Pub/Sub 제품에 따라 달라집니다. 이 종속 항목은 Application Integration 외부에 있으므로 Cloud Pub/Sub 트리거가 active 통합 실행을 성공적으로 시작할 때만 Application Integration 서비스수준계약(SLA) 이용약관을 적용할 수 있습니다.