wbsong111
b9e94a054a
앱별 부트스트랩 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>
39 lines
1.4 KiB
Markdown
39 lines
1.4 KiB
Markdown
# 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 볼륨 티어 |
|