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>

manifests/helm/cnpg-cluster/1.1.0/templates/NOTES.txt

@@ -0,0 +1,55 @@
+PostgreSQL 클러스터 "{{ include "cnpg-cluster.fullname" . }}" 를 배포했습니다.
+인스턴스 {{ .Values.instances }}개 / 이미지 {{ include "cnpg-cluster.image" . }}
+
+1. 상태 확인 (반드시 FQN 을 사용하세요 — kubectl get cluster 는 Rancher/CAPI 리소스와 충돌합니다)
+
+   kubectl -n {{ include "cnpg-cluster.namespace" . }} get clusters.postgresql.cnpg.io {{ include "cnpg-cluster.fullname" . }}
+   kubectl -n {{ include "cnpg-cluster.namespace" . }} get pods -l cnpg.io/cluster={{ include "cnpg-cluster.fullname" . }} -L cnpg.io/instanceRole
+
+2. 접속 엔드포인트
+
+   {{ include "cnpg-cluster.fullname" . }}-rw   : primary (읽기/쓰기)
+   {{ include "cnpg-cluster.fullname" . }}-ro   : replica 만 (읽기 전용)
+   {{ include "cnpg-cluster.fullname" . }}-r    : 전체 인스턴스 (읽기 라운드로빈)
+{{- if .Values.pooler.enabled }}
+   {{ include "cnpg-cluster.fullname" . }}-pooler-{{ .Values.pooler.type }} : PgBouncer ({{ .Values.pooler.poolMode }} 모드)
+{{- end }}
+
+3. 자격증명
+
+   DB     : {{ .Values.bootstrap.initdb.database }}
+   User   : {{ .Values.bootstrap.initdb.owner }}
+{{- if .Values.bootstrap.initdb.secretName }}
+   Secret : {{ .Values.bootstrap.initdb.secretName }} (사용자 지정)
+{{- else }}
+   Secret : {{ include "cnpg-cluster.fullname" . }}-app (operator 자동 생성)
+
+   kubectl -n {{ include "cnpg-cluster.namespace" . }} get secret {{ include "cnpg-cluster.fullname" . }}-app \
+     -o jsonpath='{.data.password}' | base64 -d
+{{- end }}
+{{- if not .Values.enableSuperuserAccess }}
+
+   superuser(postgres) 직접 접속은 비활성화되어 있습니다 (enableSuperuserAccess: false).
+{{- end }}
+
+4. psql 접속 예시
+
+   kubectl -n {{ include "cnpg-cluster.namespace" . }} exec -it {{ include "cnpg-cluster.fullname" . }}-1 -c postgres -- \
+     psql -U postgres -d {{ .Values.bootstrap.initdb.database }}
+
+{{- if not .Values.backup.enabled }}
+
+경고: 백업이 비활성화되어 있습니다(backup.enabled: false). 운영 환경에서는
+      barmanObjectStore 를 설정하고 scheduledBackup 을 활성화하세요.
+      백업 없이는 PITR(Point-In-Time Recovery)이 불가능합니다.
+{{- end }}
+{{- if eq (int .Values.instances) 1 }}
+
+경고: instances=1 입니다. replica 가 없어 failover 가 불가능합니다.
+{{- end }}
+{{- if eq .Values.affinity.podAntiAffinityType "preferred" }}
+
+참고: podAntiAffinityType 이 "preferred" 입니다. 여러 인스턴스가 같은 노드에
+      배치될 수 있어 노드 장애 시 동시 손실 위험이 있습니다.
+      노드 수가 instances 이상인 운영 환경에서는 "required" 를 사용하세요.
+{{- end }}