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>
This commit is contained in:
wbsong111
2026-08-06 11:24:23 +09:00
parent e527131fd0
commit b9e94a054a
15 changed files with 1292 additions and 0 deletions
@@ -0,0 +1,38 @@
# 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 시크릿을 생성한다.
## 빠른 시작
```sh
helm upgrade pg-cnpg ./ -f custom-values.yaml --install -n <namespace> --create-namespace
```
배포 옵션과 주의사항은 [CUSTOM-README.md](CUSTOM-README.md), 버전 갱신 절차는
[BUILD-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 볼륨 티어 |