카탈로그 앱 내장 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/superset/0.13.5/CUSTOM-README.md

@@ -247,34 +247,38 @@ bootstrapScript: |
 
 ### 6) postgresql
 
-- subchart로 포함된 postgresql을 배포하기 위한 설정이다.
+- 내장 bitnami postgresql 서브차트 대신 `cnpg-cluster`(전용 인스턴스)를 외부 DB로 사용한다.
+- **사전 조건**: `cloudnative-pg` operator가 클러스터에 먼저 설치되어 있어야 한다.
+- **배포 순서**
+  ``` sh
+  kubectl create secret generic superset-db-app-secret \
+    --from-literal=username=superset --from-literal=password=superset -n superset
 
-``` yaml
-postgresql:
-  enabled: true
-  auth:
-    # DB의 계정 및 기본 생성되는 database를 설정한다.
-    username: superset
-    password: superset
-    database: superset
-  image:
-    # private 환경에서 배포할 때 사용할 registry로 설정을 변경한다.
-    registry: docker.io
-  primary:
-    # DB의 리소스를 설정한다.
-    resources:
-      limits: {}
-      requests:
-        memory: 256Mi
-        cpu: 250m
-    # DB에서 사용할 Disk 설정으로 StorageClass와 사이즈를 설정한다.
-    persistence:
-      enabled: true
-      storageClass: ""
-      accessModes:
-        - ReadWriteOnce
-      size: 8Gi
-```
+  helm upgrade superset-db manifests/helm/cnpg-cluster/1.0.0 \
+    -f manifests/helm/cnpg-cluster/1.0.0/custom-values.yaml \
+    -f manifests/applicationset/superset/0.13.5/superset-db-values.yaml \
+    --install -n superset
+
+  helm upgrade superset ../superset --install -n superset --create-namespace \
+    -f ./custom-values.yaml
+  ```
+- ArgoCD로 배포한다면 `manifests/applicationset/superset/0.13.5/`의 ApplicationSet을 쓴다 —
+  `superset-db`(syncWave 0) → `superset`(syncWave 1) 순서로 자동 배포된다. 자세한 내용은
+  해당 디렉토리의 `README.md` 참고.
+- custom-values.yaml
+  ``` yaml
+  postgresql:
+    enabled: false
+
+  supersetNode:
+    connections:
+      db_host: 'superset-db-rw'   # cnpg-cluster 릴리스명이 superset-db일 때의 rw 서비스명
+      db_port: "5432"
+      db_user: superset
+      db_pass: superset            # 위 시크릿 생성 시 사용한 password와 동일해야 한다
+      db_name: superset
+  ```
+- 참고: `manifests/applicationset/superset/0.13.5/superset-db-values.yaml`
 
 
 

manifests/helm/superset/0.13.5/custom-values.yaml

@@ -99,11 +99,17 @@ tolerations: []
 
 ingress:
   enabled: true
-  annotations: 
-    cert-manager.io/cluster-issuer: "selfsigned-issuer" 
-    cert-manager.io/duration: 8760h  
+  # airflow와 동일하게 실측된 문제 — ingressClassName 미지정 시 이 클러스터의 apisix가
+  # 아예 인식하지 않아 CLASS: <none>으로 뜨고 접근이 불가능하다. path도 exact "/" 만
+  # 매치되면 superset의 내부 리다이렉트(예: /login/) 이후 전부 404가 나 regex로 바꾼다.
+  ingressClassName: "apisix"
+  annotations:
+    cert-manager.io/cluster-issuer: "selfsigned-issuer"
+    cert-manager.io/duration: 8760h
     cert-manager.io/renew-before: 720h
-  path: /
+    k8s.apisix.apache.org/use-regex: "true"
+    k8s.apisix.apache.org/ssl-redirect: "true"
+  path: /.*
   pathType: ImplementationSpecific
   hosts:
   - superset.example.org
@@ -133,8 +139,11 @@ supersetNode:
     redis_ssl:
       enabled: false
       ssl_cert_reqs: CERT_NONE
-    # You need to change below configuration incase bringing own PostgresSQL instance and also set postgresql.enabled:false
-    db_host: '{{ .Release.Name }}-postgresql'
+    # 내장 bitnami postgresql 서브차트 대신 cnpg-cluster(전용 인스턴스)를 외부 DB로 사용한다.
+    # 사전 배포: helm install superset-db manifests/helm/cnpg-cluster/1.0.0 \
+    #   -f manifests/helm/cnpg-cluster/1.0.0/custom-values.yaml \
+    #   -f manifests/applicationset/superset/0.13.5/superset-db-values.yaml -n <ns>
+    db_host: 'superset-db-rw'
     db_port: "5432"
     db_user: superset
     db_pass: superset
@@ -160,23 +169,7 @@ supersetCeleryFlower:
   resources: {}
 
 postgresql:
-  enabled: true
-  auth:
-    username: superset
-    password: superset
-    database: superset
-  image:
-    registry: docker.io
-  primary:
-    resources:
-      limits: {}
-      requests:
-        memory: 256Mi
-        cpu: 250m
-    persistence:
-      enabled: true
-      storageClass: ""
-      size: 8Gi
+  enabled: false
 
 redis:
   enabled: true