Application Integration에 지원되는 커넥터를 참조하세요.
Cloud Pub/Sub 트리거
Cloud Pub/Sub 트리거를 사용하면 Pub/Sub 미들웨어의 이벤트를 기반으로 통합을 실행할 수 있습니다.
이 트리거를 사용하면 게시자가 선택된 주제에 메시지를 쓸 때마다 통합을 실행할 수 있습니다. 주제는 통합과 동일한 Google Cloud 프로젝트에 또는 다른 Google Cloud 프로젝트에 있을 수 있습니다. 이 트리거가 실행되면 게시된 메시지도 CloudPubSubMessage
출력 변수에 작성됩니다. 요구사항에 따라 다운스트림 트리거 또는 태스크에서 이 변수를 사용할 수 있습니다.
Application Integration 및 Cloud Pub/Sub 트리거를 사용하여 샘플 통합을 만드는 방법을 알아보려면 Cloud Pub/Sub 주제를 리슨하고 이메일을 전송을 참고하세요.
시작하기 전에
Cloud Pub/Sub 트리거를 구성하기 전에 Google Cloud 프로젝트에서 다음 태스크를 수행해야 합니다.
- 이 트리거를 만드는 사용자에게 프로젝트 IAM 관리자(
roles/resourcemanager.projectIamAdmin
)를 할당합니다. - 통합이 있는 Google Cloud 프로젝트에 대해 Pub/Sub API를 사용 설정합니다.
- Pub/Sub 주제가 있는지 확인합니다. 새 Pub/Sub 주제를 만들려면 다음 안내를 따르세요.
- Cloud 콘솔에서 Pub/Sub 주제 페이지로 이동합니다.
- 주제 만들기를 클릭합니다.
- 주제 ID 필드에 고유한 주제 이름을 제공합니다.
- 저장을 클릭합니다.
IAM 역할을 사용한 액세스 관리에 대한 자세한 내용은 액세스 제어를 참조하세요.
주 구성원에게 역할을 부여하는 방법은 액세스 권한 부여, 변경, 취소를 참조하세요.
Cloud Pub/Sub 트리거 추가
신규 또는 기존 통합에 Cloud Pub/Sub 트리거를 추가하려면 다음 단계를 따르세요.- Google Cloud 콘솔에서 Application Integration 페이지로 이동합니다.
- 탐색 메뉴에서 통합을 클릭합니다.
Google Cloud 프로젝트에서 사용할 수 있는 모든 통합이 나열된 통합 목록 페이지가 나타납니다.
- 기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.
새 통합을 만드는 경우:
- 통합 만들기 창에 이름과 설명을 입력합니다.
- 통합 리전을 선택합니다.
- 통합을 위한 서비스 계정을 선택합니다. 통합 툴바의 통합 요약 창에서 언제든지 통합에 대한 서비스 계정 세부정보를 변경하거나 업데이트할 수 있습니다.
- 만들기를 클릭합니다.
통합 편집기 페이지에서 통합이 열립니다.
- 통합 편집기 탐색 메뉴에서 트리거를 클릭하여 사용 가능한 트리거 목록을 확인합니다.
- Cloud Pub/Sub 트리거 요소를 클릭하여 디자이너에 배치합니다.
Cloud Pub/Sub 트리거 구성
통합 편집기에서 Cloud Pub/Sub 트리거 요소를 클릭하여 트리거 구성 창을 확인한 후 다음 태스크를 수행합니다.
- Pub/Sub 주제 필드에 다음 형식으로 트리거로 리슨할 주제를 지정합니다.
projects/PROJECT_ID/topics/TOPIC_ID
Google Cloud 프로젝트에서 사용 가능한 모든 주제를 보려면 주제에서 주제 이름 열을 참조하세요. 다른 Google Cloud 프로젝트의 주제를 선택할 수도 있습니다.
다음을 바꿉니다.PROJECT_ID
: 주제가 생성된 Google Cloud 프로젝트입니다.TOPIC_ID
: Pub/Sub 주제 ID입니다. 주제는 통합과 동일한 Google Cloud 프로젝트에 있거나 다른 Google Cloud 프로젝트에 있을 수 있습니다.
- 통합을 호출하는 데 사용할 서비스 계정을 선택합니다. 통합에서 만든 구성 변수를 선택할 수도 있습니다. 구성 변수의 값은 다음
SERVICE_ACCOUNT_NAME@project-id.iam.gserviceaccount.com
형식의 서비스 계정 이메일 주소여야 합니다 예를 들면application-integration-invoke@project123.iam.gserviceaccount.com
입니다.구성 변수를 만드는 방법에 대한 자세한 내용은 변수 만들기를, 서비스 계정을 만드는 방법에 관한 자세한 내용은 서비스 계정 만들기를 참고하세요.
구성 변수를 선택하는 경우 구성 변수가 참조하는 서비스 계정에 필요한 역할을 부여해야 합니다. 역할 부여 방법에 대한 자세한 내용은 필수 IAM 역할을 참고하세요.
서비스 계정이 없으면 서비스 계정 목록에서 새로 만들기를 클릭하여 서비스 계정을 만듭니다.
기본적으로 구독의 만료 기간 옵션은 never expire
로 설정됩니다. 만료 시간을 다른 값으로 설정하려면 Google Cloud 콘솔에서 Pub/Sub 구독 페이지로 이동하여 구독을 수정합니다.
서비스 계정에 필요한 IAM 역할
서비스 계정을 선택할 때 권한 부여를 클릭하면 여러 서비스 계정에 다음 역할이 자동으로 제공됩니다.
서비스 계정 | 부여된 IAM 역할 |
---|---|
Application Integration 기본 서비스 계정: service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com |
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 구독은 삭제되지 않으므로 메시지가 손실되지 않습니다. 하지만 게시된 버전이나 통합의 모든 통합 버전을 삭제하면 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) 이용약관을 적용할 수 있습니다.
할당량 및 한도
할당량 및 한도에 대한 자세한 내용은 할당량 및 한도를 참조하세요.
다음 단계
- 모든 태스크 및 트리거 알아보기
- 통합을 테스트하고 게시하는 방법 알아보기
- 오류 처리에 대해 알아보기
- 통합 실행 로그에 대해 알아보기