Pub/Sub 주제 및 구독 구성

Application Design Center에서 Pub/Sub 주제 및 구독을 구성하여 메시지를 생성하는 서비스 프로듀서와 메시지를 처리하는 서비스를 분리하는 확장 가능한 비동기 메시징을 제공할 수 있습니다. GitHub의 terraform-google-pubsub Terraform 모듈을 기반으로 주제 및 구독의 구성요소 연결 및 구성 매개변수를 맞춤설정할 수 있습니다.

구성요소 연결

다음 표에는 Pub/Sub 주제 또는 구독에 연결할 수 있는 구성요소와 애플리케이션 및 생성된 Terraform 코드에 대한 결과 업데이트가 포함되어 있습니다.

연결된 구성요소 애플리케이션 업데이트 배경 정보

Compute Engine 인스턴스 템플릿

  • Compute Engine 인스턴스는 Pub/Sub 주제에 메시지를 게시하고 수신할 수 있습니다.
  • Pub/Sub 주제 ID가 Compute Engine 인스턴스 템플릿 메타데이터에 추가됩니다.
인스턴스 템플릿

서비스 계정

  • 서비스 계정은 Pub/Sub 주제를 관리하고 구독에서 메시지를 가져올 수 있습니다.
  • 서비스 계정에 roles/pubsub.editor 역할이 부여됩니다.
  • 서비스 계정 이름과 이메일 정보가 Pub/Sub pull 구독에 추가됩니다.
Identity and Access Management(IAM) 정책으로 액세스 제어

BigQuery

  • Pub/Sub 구독은 BigQuery 데이터 세트의 테이블에 메시지를 쓸 수 있습니다.
  • BigQuery 데이터 세트 및 테이블 정보가 Pub/Sub 구독 필드에 추가됩니다.
BigQuery 구독

Cloud Run

  • Cloud Run 서비스는 메시지를 수신하거나 Pub/Sub 주제에 게시할 수 있습니다.
  • Pub/Sub 주제 ID가 Cloud Run 환경 변수에 추가됩니다.
  • roles/pubsub.publisher 및 roles/pubsub.subscriber 역할이 Cloud Run 서비스 계정에 부여됩니다.
  • Cloud Run 서비스가 Pub/Sub 푸시 및 풀 구독 필드에 추가됩니다.
Cloud Run에서 Pub/Sub 사용 튜토리얼

Cloud Storage

  • Pub/Sub 구독은 Cloud Storage 버킷에 메시지를 쓸 수 있습니다.
  • Cloud Storage 버킷 정보가 Pub/Sub 구독 필드에 추가됩니다.
Cloud Storage 구독

필수 구성 매개변수

템플릿에 Pub/Sub 구성요소가 포함된 경우 배포하기 전에 다음 매개변수를 구성해야 합니다.

매개변수 이름 설명 및 제약조건 배경 정보

프로젝트 ID

Pub/Sub 리소스를 배포할 프로젝트입니다.

구성요소 구성

주제

name 주제, 구독, 스키마, 스냅샷 이름 지정 가이드라인

선택적 구성 매개변수

다음 매개변수는 선택사항입니다. 고급 매개변수를 표시하려면 구성 영역에서 고급 필드 표시를 선택합니다.

기능 매개변수 이름 설명 및 제약 조건 정보 배경 정보
주제 만들기 기본적으로 주제가 생성됩니다. 주제를 만들지 않으려면 체크박스를 선택 해제합니다. 주제 만들기
구독 만들기 기본적으로 구독이 생성됩니다. 구독을 만들지 않으려면 체크박스를 선택 해제합니다. 정기 결제 개요
주제 라벨 키 labels 라벨을 사용하여 사용량 보고
주제 라벨 값 labels 라벨을 사용하여 사용량 보고
푸시 구독 이름 name 주제, 구독, 스키마, 스냅샷 이름 지정 가이드라인
푸시 구독 확인 기한(초) ackDeadlineSeconds 확인 기한
푸시 구독 푸시 엔드포인트 pushEndpoint 엔드포인트
푸시 구독 X-goog-version 푸시된 메시지의 Pub/Sub API 형식입니다. 예를 들면 v1beta1입니다. attributes
푸시 구독 OIDC 서비스 계정 이메일 serviceAccountEmail 인증
푸시 구독 잠재고객 audience 인증
푸시 구독 만료 정책 expirationPolicy 만료 기간
푸시 구독 데드 레터 주제 deadLetterTopic 데드 레터 주제
푸시 구독 확인된 메시지 보관 retainAckedMessages 확인한 메시지 보관
푸시 구독 메시지 보관 기간 messageRetentionDuration 메시지 보관 기간
푸시 구독 최대 전송 시도 횟수 maxDeliveryAttempts 데드 레터 주제
푸시 구독 최대 백오프 maximumBackoff 재시도 정책
푸시 구독 최소 백오프 minimumBackoff 재시도 정책
푸시 구독 필터 filter 구독 필터
푸시 구독 메시지 순서 지정 사용 설정 enableMessageOrdering 메시지 순서 지정
가져오기 구독 이름 name 주제, 구독, 스키마, 스냅샷 이름 지정 가이드라인
가져오기 구독 확인 기한(초) ackDeadlineSeconds 확인 기한
가져오기 구독 데드 레터 주제 deadLetterTopic 데드 레터 주제
가져오기 구독 최대 전송 시도 횟수 maxDeliveryAttempts 데드 레터 주제
가져오기 구독 확인된 메시지 보관 retainAckedMessages 확인한 메시지 보관
가져오기 구독 메시지 보관 기간 messageRetentionDuration 메시지 보관 기간
가져오기 구독 최대 백오프 maximumBackoff 재시도 정책
가져오기 구독 최소 백오프 minimumBackoff 재시도 정책
가져오기 구독 필터 filter 구독 필터
가져오기 구독 메시지 순서 지정 사용 설정 enableMessageOrdering 메시지 순서 지정
가져오기 구독 서비스 계정 구독에 대한 roles/pubsub.subscriber 역할이 부여된 서비스 계정입니다. IAM으로 액세스 제어
가져오기 구독 1회만 전송 사용 설정 enableExactlyOnceDelivery 1회만 전송
BigQuery 구독 이름 name 주제, 구독, 스키마, 스냅샷 이름 지정 가이드라인
BigQuery 구독 표 표 BigQuery 구독 만들기
BigQuery 구독 주제 스키마 사용 useTopicSchema 주제 스키마 사용
BigQuery 구독 테이블 스키마 사용 useTableSchema 테이블 스키마 사용
BigQuery 구독 메타데이터 쓰기 writeMetadata 메타데이터 쓰기
BigQuery 구독 알 수 없는 필드 삭제 dropUnknownFields 알 수 없는 필드 삭제
BigQuery 구독 확인 기한(초) ackDeadlineSeconds 확인 기한
BigQuery 구독 확인된 메시지 보관 retainAckedMessages 확인한 메시지 보관
BigQuery 구독 메시지 보관 기간 messageRetentionDuration 메시지 보관 기간
BigQuery 구독 메시지 순서 지정 사용 설정 enableMessageOrdering 메시지 순서 지정
BigQuery 구독 만료 정책 expirationPolicy 만료 기간
BigQuery 구독 필터 filter 구독 필터
BigQuery 구독 데드 레터 주제 deadLetterTopic 데드 레터 주제
BigQuery 구독 최대 백오프 maximumBackoff 재시도 정책
BigQuery 구독 최소 백오프 minimumBackoff 재시도 정책
Cloud Storage 구독 이름 name 주제, 구독, 스키마, 스냅샷 이름 지정 가이드라인
Cloud Storage 구독 버킷 버킷 버킷 이름
Cloud Storage 구독 파일 이름 프리픽스 filenamePrefix 파일 이름 프리픽스, 서픽스, 날짜 및 시간
Cloud Storage 구독 파일 이름 서픽스 filenameSuffix 파일 이름 프리픽스, 서픽스, 날짜 및 시간
Cloud Storage 구독 파일 이름 날짜/시간 형식 filenameDatetimeFormat 파일 이름 프리픽스, 서픽스, 날짜 및 시간
Cloud Storage 구독 최대 길이 maxDuration 파일 일괄 처리
Cloud Storage 구독 최대 바이트 maxBytes 파일 일괄 처리
Cloud Storage 구독 최대 메시지 수 maxMessages 파일 일괄 처리
Cloud Storage 구독 출력 형식 textConfig 또는 avroConfig 파일 형식
Cloud Storage 구독 메타데이터 쓰기 writeMetadata 파일 형식
Cloud Storage 구독 주제 스키마 사용 useTopicSchema 파일 형식
Cloud Storage 구독 확인 기한(초) ackDeadlineSeconds 확인 기한
Cloud Storage 구독 확인된 메시지 보관 retainAckedMessages 확인한 메시지 보관
Cloud Storage 구독 메시지 보관 기간 messageRetentionDuration 메시지 보관 기간
Cloud Storage 구독 메시지 순서 지정 사용 설정 enableMessageOrdering 메시지 순서 지정
Cloud Storage 구독 만료 정책 expirationPolicy 만료 기간
Cloud Storage 구독 필터 filter 구독 필터
Cloud Storage 구독 데드 레터 주제 deadLetterTopic 데드 레터 주제
Cloud Storage 구독 최대 백오프 maximumBackoff 재시도 정책
Cloud Storage 구독 최소 백오프 minimumBackoff 재시도 정책
구독 라벨 키 labels 라벨을 사용하여 사용량 보고
구독 라벨 값 labels 라벨을 사용하여 사용량 보고
주제 메시지 보관 기간 topicMessageRetentionDuration 메시지 보관 기간
주제 KMS 키 이름 kmsKeyName 고객 관리 암호화 키(CMEK) 사용
BigQuery 프로젝트 역할 부여 기본적으로 BigQuery 메타데이터 뷰어(roles/bigquery.metadataViewer) 및 BigQuery 데이터 편집자(roles/bigquery.dataEditor) 역할이 기본 Pub/Sub 서비스 계정에 부여됩니다. 이러한 역할을 부여하지 않으려면 체크박스를 선택 해제합니다. 서비스 계정에 IAM 역할 부여
토큰 생성자 부여 기본적으로 서비스 계정 토큰 생성자 역할은 기본 Pub/Sub 서비스 계정에 부여됩니다. 이 역할을 부여하지 않으려면 체크박스를 선택 해제합니다. Pub/Sub 인증 설정
스키마 이름 name 스키마에 대한 중요한 정보
스키마 유형 type 스키마 유형
스키마 정의 정의 스키마 유형
스키마 인코딩 encoding 스키마를 주제와 연결하기 위한 가이드라인