Files
service-catalog/manifests/helm/cnpg-cluster/1.1.0/README.md
T
wbsong111 b9e94a054a cnpg-cluster 1.1.0 — postInitApplicationSQLRefs 노출
앱별 부트스트랩 SQL 을 ConfigMap/Secret 참조로 실행할 수 있게 한다. CNPG CRD 에는
이미 있는 필드(operator 0.29.0/CRD 확인됨)인데 차트가 렌더하지 않아 values 로 쓸 수
없었다.

용도: 스키마 덤프처럼 큰 SQL 을 values 에 인라인하지 않고 ConfigMap 으로 넘기는 경우.
postInitApplicationSQL(인라인)과 시점·권한이 동일(클러스터 생성 직후 1회, 앱 DB 안에서
superuser) 하고 SQL 출처만 다르다. 1회성이라 비멱등 SQL(CREATE TABLE 등)을 그대로
넣어도 재실행되지 않는다.

- values.yaml: bootstrap.initdb.postInitApplicationSQLRefs 추가(configMapRefs/secretRefs,
  기본 빈 배열)
- templates/cluster.yaml: 값이 있을 때만 렌더(있으면 렌더, 없으면 필드 자체가 안 나옴 —
  기존 클러스터에 영향 없음을 렌더 테스트로 확인)
- CUSTOM-README.md: postInitApplicationSQL 과의 차이·참조 처리 순서(Secret 전체 →
  ConfigMap 전체) 문서화

카탈로그 관례 파일(BUILD-README·CUSTOM-README 본문 대부분·dip-*.yaml·custom-values.yaml)은
1.0.0 에서 그대로 승계했다(diff 로 확인).

검증: 빈 값일 때 필드 미노출, configMapRefs 지정 시 정상 렌더, 기존 1.0.0
custom-values.yaml 로 1.1.0 렌더해도 문제없음(하위 호환) 확인.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-06 11:24:23 +09:00

1.4 KiB

cnpg-cluster

CloudNativePG 커스텀 리소스를 Helm 으로 감싼 PostgreSQL 클러스터 차트.

  • 차트 버전: 1.0.0
  • PostgreSQL: 18
  • 필요 operator: cloudnative-pg 차트 0.29.0 (operator 1.30.0) 이상

생성되는 리소스

리소스 조건 파일
Cluster 항상 templates/cluster.yaml
Database databases 가 비어있지 않을 때 templates/database.yaml
Pooler pooler.enabled: true templates/pooler.yaml
ScheduledBackup backup.enabled + scheduledBackup.enabled templates/scheduled-backup.yaml

operator 가 위 리소스를 받아 StatefulSet 없이 개별 Pod, PVC, Service(-rw/-ro/-r), TLS 시크릿을 생성한다.

빠른 시작

helm upgrade pg-cnpg ./ -f custom-values.yaml --install -n <namespace> --create-namespace

배포 옵션과 주의사항은 CUSTOM-README.md, 버전 갱신 절차는 BUILD-README.md 를 참고한다.

값 파일

파일 용도
values.yaml 차트 기본값 (전체 키 문서화)
custom-values.yaml PaaSup 표준 오버라이드
dip-values.yaml DIP 플랫폼 운영 배포값 (백업·pooler·동기복제 활성)
dip-resources-quotas.yaml Small/Medium/Large CPU·메모리 티어
dip-volumes-quotas.yaml Small/Medium/Large 볼륨 티어