카탈로그 앱 내장 bitnami postgresql → cnpg-cluster 전환 (1차 5개 차트)

이슈 #9에서 결정된 CloudNativePG 채택을 카탈로그 앱에 확장 적용한다.
airflow/lakekeeper/mlflow/superset/flowise 5개 차트가 내장하던 bitnami
postgresql 서브차트를 끄고 앱 전용 cnpg-cluster 인스턴스를 외부 DB로 쓰도록
전환했다. 5개 모두 dev 클러스터 격리 네임스페이스에서 배포 테스트로 실측 검증했다.

gitea/keycloak/dnsup 는 서브차트가 아니라 공유 postgresql-ha 를 외부 참조하며
paasup/dipup 레포 관리 대상이라 제외했다 — 인수인계 문서만 추가했다.

배포 구조:
- ArgoCD ApplicationSet 으로 DB(syncWave 0) → 앱(syncWave 1) 순서를 보장한다.
  기존 openmetadata/victoria-metrics 관례를 따랐다. cnpg-cluster 차트는 범용
  상태로 유지하고 앱별 값은 manifests/applicationset/<app>/ 에 둔다.

검증 중 발견해 함께 고친 문제:
- lakekeeper: cnpg 의 -ro 는 replica 전용이라 instances:1 에서 엔드포인트가
  0개다. 읽기 연결을 -r(전체 라운드로빈)로 교체했다.
- airflow/superset: ingressClassName 누락 + kong 애노테이션 잔존으로 이
  클러스터(apisix 전용)에서 ingress 접근이 아예 불가능했다. apisix + regex
  path 로 교체했다.
- 배포 테스트가 PV 만 지우고 Longhorn Volume CR 을 남겨 storageScheduled 가
  누적됐다(orphan 112개 ~1TB 로 배포 차단). 두 스크립트의 정리 로직을 고쳤다.

재사용 구조화:
- .claude/skills/chart-to-cnpg/ 신규. 남은 4개 차트(langflow-ide, langfuse,
  litellm, nemo)에 같은 절차를 재사용한다. flowise 에 실제 적용해 검증했다.
- 배포 테스트 공통 절차는 .claude/deploy-test-procedure.md, 환경 함정은
  .claude/pitfalls.md 로 단일화하고 앱별 README 는 참조만 남겼다.

관련: #9, #14

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

manifests/helm/lakekeeper/0.11.0/CUSTOM-README.md

@@ -68,12 +68,20 @@ catalog:
     secret:
       secretName: root-ca-secret
 
-# lakekeeper DB
+# lakekeeper DB — 내장 postgres 서브차트 대신 cnpg-cluster(전용 인스턴스)를 외부 DB로 사용한다.
 postgresql:
-  storage:
-    className:
-    requestedSize: 5Gi
-  resources: {}
+  enabled: false
+
+externalDatabase:
+  type: postgres
+  # -ro는 replica 전용이라 instances:1(권장 기준, small 티어)에서는 엔드포인트가 없다 —
+  # -r(전체 인스턴스 라운드로빈, primary 포함)을 대신 쓴다. 배포 테스트로 실측된 문제다.
+  host_read: "lakekeeper-db-r"
+  host_write: "lakekeeper-db-rw"
+  port: 5432
+  database: lakekeeper
+  user: lakekeeper
+  password: lakekeeper
 
 # OIDC 인증
 auth:
@@ -162,11 +170,35 @@ extraVolumes:
 
 ### 4) PostgreSQL 데이터베이스 설정
 
+- 내장 postgres 서브차트(`groundhog2k/postgres`) 대신 `cnpg-cluster`(전용 인스턴스)를 외부 DB로
+  사용한다. **사전 조건**: `cloudnative-pg` operator가 클러스터에 먼저 설치되어 있어야 한다.
+- **배포 순서**
+  ``` sh
+  kubectl create secret generic lakekeeper-db-app-secret \
+    --from-literal=username=lakekeeper --from-literal=password=lakekeeper -n lakekeeper
+
+  helm upgrade lakekeeper-db manifests/helm/cnpg-cluster/1.0.0 \
+    -f manifests/helm/cnpg-cluster/1.0.0/custom-values.yaml \
+    -f manifests/applicationset/lakekeeper/0.11.0/lakekeeper-db-values.yaml \
+    --install -n lakekeeper
+
+  helm upgrade lakekeeper ./ -f custom-values.yaml --install -n lakekeeper --create-namespace
+  ```
+- ArgoCD로 배포한다면 `manifests/applicationset/lakekeeper/0.11.0/`의 ApplicationSet을 쓴다 —
+  `lakekeeper-db`(syncWave 0) → `lakekeeper`(syncWave 1) 순서로 자동 배포된다. 자세한 내용은
+  해당 디렉토리의 `README.md` 참고.
+
 | Name                      | 설명                                                         | 기본값      |
 | ------------------------- | ------------------------------------------------------------ | ----------- |
-| `postgresql.storage.className` | 스토리지 클래스                                          | `""`        |
-| `postgresql.storage.requestedSize` | PostgreSQL 스토리지 크기                            | `5Gi`       |
-| `postgresql.resources`    | PostgreSQL 리소스 설정                                       | `{}`        |
+| `postgresql.enabled`      | 내장 postgres 서브차트 사용 여부. cnpg-cluster 사용 시 `false` | `false`     |
+| `externalDatabase.host_write` | cnpg-cluster의 rw 서비스명(`<release>-rw`)                | `lakekeeper-db-rw` |
+| `externalDatabase.host_read`  | cnpg-cluster의 ro 서비스명(`<release>-ro`)                | `lakekeeper-db-ro` |
+| `externalDatabase.database`, `.user`, `.password` | DB 계정 정보. cnpg-cluster 부트스트랩 시크릿과 동일해야 한다 | 참고 예시 |
+
+> 참고: `manifests/applicationset/lakekeeper/0.11.0/lakekeeper-db-values.yaml`
+>
+> OpenFGA 인증/권한 스토어(`internalOpenFGA: true`)는 여전히 자체 bitnami postgresql
+> 서브차트(`openfga.postgresql`)를 내장 사용한다 — 이번 전환 범위에는 포함되지 않았다.
 
 ### 5) OIDC 인증 설정
 

manifests/helm/lakekeeper/0.11.0/custom-values.yaml

@@ -29,13 +29,27 @@ catalog:
     secret:
       secretName: root-ca-secret
 
-# lakekeeper DB
+# lakekeeper DB — 내장 postgres 서브차트(groundhog2k/postgres) 대신
+# cnpg-cluster(전용 인스턴스)를 외부 DB로 사용한다.
+# 사전 배포: helm install lakekeeper-db manifests/helm/cnpg-cluster/1.0.0 \
+#   -f manifests/helm/cnpg-cluster/1.0.0/custom-values.yaml \
+#   -f manifests/applicationset/lakekeeper/0.11.0/lakekeeper-db-values.yaml -n <ns>
 postgresql:
-  enabled: true
-  storage:
-    className:
-    requestedSize: 5Gi
-  resources: {}
+  enabled: false
+
+externalDatabase:
+  type: postgres
+  # cnpg-cluster의 -ro 서비스는 replica 파드에만 연결되는데, 권장 배포 기준인
+  # instances: 1(small 티어)에서는 replica가 없어 -ro가 엔드포인트 0개인 서비스가
+  # 된다 — lakekeeper의 read-connection이 영구히 재시도만 하며 멈춘다(배포 테스트로 실측).
+  # -r은 인스턴스 수와 무관하게 항상 primary를 포함해 라운드로빈하므로 이 값을 쓴다.
+  # instances를 3 이상으로 올려 실제 replica를 운용하는 경우에도 -r로 충분하다.
+  host_read: "lakekeeper-db-r"
+  host_write: "lakekeeper-db-rw"
+  port: 5432
+  database: lakekeeper
+  user: lakekeeper
+  password: lakekeeper
 
 
 # OIDC 인증