Docs

Docs

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

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

차례

Part I. 시작하기

Operator 개념·사용 사례·5분 Quickstart

Part II. 아키텍처

Operator·Cluster·인스턴스 매니저·장애 모델

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·database·인스턴스 매니저

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/

차례

표기 규약

관련 사이트