본문으로 건너뛰기

pubsub

Cloud Pub/Sub​

개요​

Cloud Pub/Sub는 GCP에서 제공하는 완전 관리형 실시간 메시징 서비스입니다. DTA-WIDE 시스템에서는 다음과 같은 용도로 사용됩니다:

  • 이벤트 기반 아키텍처 구현
  • 시스템 간 비동기 통신
  • 마이크로서비스 간 메시지 교환
  • 실시간 데이터 스트리밍

초기 설정​

Pub/Sub 서비스를 사용하기 위한 초기 설정 단계입니다:

  1. 토픽 생성

    • 도메인별 토픽 구성
    • 메시지 보존 정책 설정
    • 게시 권한 구성

  2. 스키마 정의

    • 메시지 구조 정의 (Avro/JSON/Proto)
    • 스키마 버전 관리 설정
    • 스키마 유효성 검사 구성

  3. 구독 설정

    • Push/Pull 구독 유형 결정
    • 메시지 필터링 설정
    • 배달 재시도 정책 구성
    • 데드레터 토픽 구성

  4. 인증 및 권한

    • 서비스 계정 설정
    • IAM 역할 할당
    • API 키 생성 (필요한 경우)

  5. 모니터링 구성

    • 알림 설정
    • 지표 대시보드 생성

구성​

  • 토픽 구조: 도메인별 토픽 분리
  • 구독 유형: Pull 및 Push 구독 혼합
  • 메시지 보존: 7일
  • 메시지 정렬: 타임스탬프 기준

보안 설정​

  • IAM 기반 접근 제어
  • VPC 서비스 제어 적용
  • 메시지 암호화
  • 비공개 서비스 액세스

모니터링​

  • 메시지 처리량 모니터링
  • 지연 시간 알림 설정
  • 오류율 모니터링
  • 구독 백로그 모니터링

운영 가이드​

TBD

변경 이력​

버전날짜작성자변경 내용
0.1.02025-03-25bok@weltcorp.com최초 작성
0.2.02025-04-10bok@weltcorp.com이벤트 시스템 아키텍처 문서 참조 추가

관련 문서​

TBD