카탈로그 앱 내장 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>
2026-08-05 15:17:46 +09:00
parent 35ce2bb80d
commit 3ee1c1ee23
42 changed files with 1650 additions and 146 deletions
@@ -0,0 +1,39 @@
+# superset ArgoCD ApplicationSet
+
+`superset-db`(cnpg-cluster, syncWave 0) → `superset`(syncWave 1) 2단계로 배포한다.
+전체 스키마는 [manifests/applicationset/openmetadata/1.12.1/](../../openmetadata/1.12.1/)와
+[manifests/applicationset/victoria-metrics/1.0.0/](../../victoria-metrics/1.0.0/)를 따른다.
+
+## 구성
+
+- `applicationset.yaml` — list generator로 Application 2개 생성.
+- `superset-db-values.yaml` — cnpg-cluster 환경 오버레이 템플릿(DB/owner, 시크릿 참조).
+- `superset-values.yaml` — superset 환경 오버레이 템플릿(DB 비밀번호만).
+
+두 파일 모두 **템플릿**이다 — dip-console이 렌더링해 값 repo(`dip/tenant-catalog`)의
+`superset/*.yaml`로 커밋하는 것을 가정한다.
+
+## 값 적용 순서 (2단)
+
+각 Application은 `baseValues`(카탈로그 차트의 `custom-values.yaml`) + `valuesPath`(값 repo의
+환경 오버레이, 나중 파일 우선)를 병합한다.
+
+## 사전 준비 (ArgoCD 밖)
+
+- `cloudnative-pg` operator(`manifests/helm/cloudnative-pg/0.29.0`)가 클러스터에 먼저
+  설치되어 있어야 한다.
+- `superset-db-values.yaml`의 `bootstrap.initdb.secretName`과 동일한 이름·값의 K8s Secret이
+  대상 네임스페이스에 미리 존재해야 한다(`username`/`password` 키).
+- ArgoCD가 `Cluster.postgresql.cnpg.io` 커스텀 리소스의 상태를 "Healthy"로 판정하려면
+  `argocd-cm`에 해당 CRD용 커스텀 헬스 체크(Lua)가 등록되어 있어야 sync-wave 1이 정상 대기한다.
+- `custom-values.yaml`은 Keycloak OIDC 연동(`AUTH_TYPE = AUTH_OAUTH`)이 기본 활성화되어
+  있고 `client_secret`/keycloak URL이 플레이스홀더다 — 실제 배포 전 반드시 실제 값으로
+  채워야 한다. 채우지 않으면 로그인 화면에 "Keycloak으로 로그인" 버튼만 뜨고 실제로는
+  로그인이 불가능하다(아이디/비번 입력폼 자체가 사라짐).
+
+## 배포 테스트
+
+절차와 주의사항은 [.claude/deploy-test-procedure.md](../../../../.claude/deploy-test-procedure.md)
+"카탈로그 앱 → cnpg-cluster 전환 배포 테스트" 절을 따른다.
+`APP_POD_SELECTOR="app=superset"`, fixture는
+`scripts/deploy-test/fixtures/superset-deploy-test-overrides.yaml`.
@@ -0,0 +1,59 @@
+apiVersion: argoproj.io/v1alpha1
+kind: ApplicationSet
+metadata:
+  name: superset
+  namespace: platform
+spec:
+  goTemplate: true
+  goTemplateOptions: ["missingkey=error"]
+  generators:
+    - list:
+        # syncWave 0: 전용 cnpg-cluster DB 인스턴스 먼저 배포
+        # syncWave 1: superset 본체 (postgresql.enabled: false, 위 DB의 -rw 서비스를 바라봄)
+        elements:
+          - name: superset-db
+            chartPath: manifests/helm/cnpg-cluster/1.0.0
+            baseValues: custom-values.yaml
+            valuesPath: superset/superset-db-values.yaml
+            syncWave: "0"
+          - name: superset
+            chartPath: manifests/helm/superset/0.13.5
+            baseValues: custom-values.yaml
+            valuesPath: superset/superset-values.yaml
+            syncWave: "1"
+  template:
+    metadata:
+      name: "{{ .name }}"
+      namespace: platform
+      annotations:
+        argocd.argoproj.io/sync-wave: "{{ .syncWave }}"
+    spec:
+      project: default
+      sources:
+        - repoURL: https://gitea.example.org/dip/service-catalog
+          targetRevision: master
+          path: "{{ .chartPath }}"
+          helm:
+            releaseName: "{{ .name }}"
+            valueFiles:
+              - "{{ .baseValues }}"
+              - $values/{{ .valuesPath }}
+        - repoURL: https://gitea.example.org/dip/tenant-catalog
+          targetRevision: master
+          ref: values
+      destination:
+        server: https://kubernetes.default.svc
+        namespace: superset
+      syncPolicy:
+        automated:
+          prune: true
+          selfHeal: true
+        syncOptions:
+          - CreateNamespace=true
+          - ServerSideApply=true
+        retry:
+          limit: 5
+          backoff:
+            duration: 10s
+            factor: 2
+            maxDuration: 3m
@@ -0,0 +1,25 @@
+# superset 전용 cnpg-cluster 환경 오버레이 템플릿.
+# dip-console이 렌더링해 값 repo(dip/tenant-catalog)의 superset/superset-db-values.yaml로
+# 커밋하는 것을 가정한 시작점이다. 배포 테스트로 검증된 값 그대로다
+# (지난 세션: manifests/helm/cnpg-cluster/1.0.0/custom-values-superset.yaml).
+instances: 1
+
+bootstrap:
+  initdb:
+    database: superset
+    owner: superset
+    secretName: "$INFISICAL_SECRET"
+
+databases:
+  - name: superset
+    owner: superset
+    ensure: present
+    reclaimPolicy: retain
+
+resources:
+  requests:
+    cpu: 500m
+    memory: 1Gi
+  limits:
+    cpu: 1000m
+    memory: 2Gi
@@ -0,0 +1,9 @@
+# superset 환경 오버레이 템플릿 — custom-values.yaml(baseValues) 위에 얹힌다.
+# DB 비밀번호처럼 환경별로 달라야 하는 민감값만 담는다. 나머지 연결 정보(host/db/user 등)는
+# custom-values.yaml에 이미 있으므로 여기서 중복 기입하지 않는다.
+#
+# superset-db-values.yaml의 bootstrap.initdb.secretName과 실제 값이 일치해야 한다
+# ($INFISICAL_SECRET 토큰은 dip-console이 같은 시크릿 값으로 렌더링하는 것을 가정).
+supersetNode:
+  connections:
+    db_pass: "$INFISICAL_SECRET"