Docs

CloudNativePG는 Kubernetes 위에서 PostgreSQL 클러스터를 선언적으로 운영하는 오픈소스 Operator입니다. 이 노트는 CloudNativePG 1.30 공식 문서를 바탕으로, 쿠버네티스나 CloudNativePG를 처음 접하는 사람도 따라올 수 있도록 개념 설명과 도식을 덧붙여 정리했습니다.

왼쪽 사이드바에서 챕터를 선택해 읽거나, 아래 차례에서 원하는 Part로 들어가세요. 처음이라면 Part I → II → IV 순서를 권합니다.

차례

• Part I. 시작하기 — Operator 개념·사용 사례·5분 Quickstart
• Part II. 아키텍처 — Operator·Cluster·Custom Resource 지도·인스턴스 매니저·장애 모델·CNPG-I 플러그인
• Part III. 설치와 업그레이드 — Operator 설치·Image Catalog·Operator 설정
• Part IV. 클러스터 만들기 — bootstrap·initdb·기존 DB 가져오기·Pod 설정
• Part V. 스토리지와 리소스 — Storage·resource·tablespace·scheduling
• Part VI. 복제와 고가용성 — streaming·자동 failover·rolling update·replica cluster
• Part VII. 백업과 복구 — object store·snapshot·WAL archiving·PITR
• Part VIII. 보안과 접속 — TLS 인증서·클라이언트 접속·애플리케이션 연결·pooling
• Part IX. PostgreSQL 관리 — 설정·role(DatabaseRole)·database·Service·extension 공급과 통제
• Part X. 모니터링과 운영 — Prometheus·Grafana·로깅·service·label
• Part XI. 운영 도구와 트러블슈팅 — cnpg 플러그인·fencing·hibernation·문제 해결
• Part XII. 확장 주제 — logical replication·PostGIS·networking·benchmark·FAQ

표기 규약

• 본문 산문은 PostgreSQL·CloudNativePG 풀네임. 짧게 줄일 때만 CNPG
• 별도 명시가 없으면 CloudNativePG 1.30 기준
• 쿠버네티스·PostgreSQL 고유 용어(Operator, Pod, WAL, replication, failover, primary, replica 등)는 번역하지 않고 영문 그대로
• kubectl·매니페스트(YAML)는 그대로 복사·실행 가능한 형태로
• 모든 도식은 Mermaid
• 공식 문서 원문: https://cloudnative-pg.io/docs/1.30/

관련 사이트

• PostgreSQL 노트: dbalog.dev/pg
• 파라미터 레퍼런스: dbalog.dev/pg-conf
• 메인 블로그: dbalog.dev