Application Design Center에서 Pub/Sub 주제 및 구독을 구성하여 메시지를 생성하는 서비스 프로듀서와 메시지를 처리하는 서비스를 분리하는 확장 가능한 비동기 메시징을 제공할 수 있습니다. GitHub의 terraform-google-pubsub Terraform 모듈을 기반으로 주제 및 구독의 구성요소 연결 및 구성 매개변수를 맞춤설정할 수 있습니다.
구성요소 연결
다음 표에는 Pub/Sub 주제 또는 구독에 연결할 수 있는 구성요소와 애플리케이션 및 생성된 Terraform 코드에 대한 결과 업데이트가 포함되어 있습니다.
| 연결된 구성요소 | 애플리케이션 업데이트 | 배경 정보 |
|---|---|---|
|
인스턴스 템플릿 | |
|
Identity and Access Management(IAM) 정책으로 액세스 제어 | |
|
BigQuery 구독 | |
|
Cloud Run에서 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 | 스키마를 주제와 연결하기 위한 가이드라인 |