카탈로그 앱 내장 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,21 @@
+# airflow 배포 테스트 전용 오버라이드 — custom-values.yaml 위에 얹어서 쓴다.
+# 목적: DB(cnpg-cluster) 연결 여부만 확인한다. custom-values.yaml의 dags.gitSync는
+# 실제 운영 gitea 저장소(http://gitea-http.platform.svc.cluster.local:3000/dip/airflow-dags.git)를
+# 가리키므로, 격리된 테스트 네임스페이스에는 그 저장소가 없어 scheduler의 git-sync-init
+# 컨테이너가 "Repository not found"로 영구 CrashLoopBackOff에 빠진다(실측 — DB 연결과 무관).
+#
+# 카탈로그의 실제 권장 설정(custom-values.yaml)은 변경하지 않는다.
+dags:
+  gitSync:
+    enabled: false
+
+# 배포 테스트 시 host는 반드시 별도 값으로 덮어쓴다 — 카탈로그 기본값(airflow.example.org)이
+# 이 클러스터의 다른 실제 배포와 겹칠 수 있다(lakekeeper에서 실측 — defense-llm 네임스페이스가
+# 동일 패턴의 host를 이미 쓰고 있었다).
+ingress:
+  web:
+    hosts:
+    - name: "airflow-access-test.example.org"
+      tls:
+        enabled: true
+        secretName: "airflow-tls"
@@ -0,0 +1,16 @@
+# flowise 배포 테스트 전용 오버라이드 — custom-values.yaml 위에 얹어서 쓴다.
+#
+# 배포 테스트 시 host는 반드시 별도 값으로 덮어쓴다 — 카탈로그 기본값(flowise.example.org)이
+# 이 클러스터의 다른 실제 배포와 겹칠 수 있다(lakekeeper에서 실측 — defense-llm 네임스페이스가
+# 동일 패턴의 host를 이미 쓰고 있었다).
+#
+# 카탈로그의 실제 권장 설정(custom-values.yaml)은 변경하지 않는다.
+ingress:
+  hosts:
+  - host: flowise-access-test.example.org
+    paths:
+      - /
+  tls:
+  -  hosts:
+     - flowise-access-test.example.org
+     secretName: flowise-tls-secret
@@ -0,0 +1,34 @@
+# lakekeeper 배포 테스트 전용 오버라이드 — custom-values.yaml 위에 얹어서 쓴다.
+# 목적: DB(cnpg-cluster) 연결 여부만 확인한다. custom-values.yaml의 auth.oauth2는
+# 실제 운영 keycloak(https://keycloak.example.org/realms/paasup)을 가리키므로,
+# 격리된 테스트 네임스페이스에서는 도달 불가능해 파드가 기동하지 못한다.
+#
+# lakekeeper values.yaml 주석(line 492-494): auth.oauth2.providerUri가 비어 있고
+# auth.kubernetes.enabled가 false면 인증 자체가 꺼진다 — 이 테스트에서 노리는 상태.
+#
+# custom-values.yaml의 catalog.extraVolumes(keycloak-tls)는 root-ca-secret을 참조하는데
+# 이 시크릿도 실제 keycloak 배포 시에만 생성되는 것이라 격리된 테스트 네임스페이스에는
+# 없다 — db-migration Job의 init 컨테이너가 FailedMount로 멈춘다. oauth2를 끄면서 이 볼륨도
+# 같이 비운다(Helm은 배열 값을 병합하지 않고 통째로 교체하므로 빈 배열로 덮어써야 한다).
+#
+# 카탈로그의 실제 권장 설정(custom-values.yaml)은 변경하지 않는다.
+auth:
+  oauth2:
+    providerUri: ""
+    audience: ""
+    ui:
+      clientID: ""
+      scopes: ""
+
+catalog:
+  extraEnv: []
+  extraVolumeMounts: []
+  extraVolumes: []
+
+  # custom-values.yaml의 host(lakekeeper.example.org)는 이 클러스터에 실제 배포된 다른
+  # lakekeeper 인스턴스(defense-llm 네임스페이스)가 이미 쓰고 있다 — 같은 host로 배포하면
+  # apisix에 동일 host의 라우트가 2개 등록되어 실제 서비스의 트래픽 라우팅과 충돌한다
+  # (실측 — apisix admin API에 두 서비스가 동일 host로 동시 등록된 것 확인).
+  # 배포 테스트는 반드시 별도 host를 쓴다.
+  ingress:
+    host: "lakekeeper-access-test.example.org"
@@ -0,0 +1,14 @@
+# mlflow 배포 테스트 전용 오버라이드 — custom-values.yaml 위에 얹어서 쓴다.
+#
+# 배포 테스트 시 host는 반드시 별도 값으로 덮어쓴다 — 카탈로그 기본값(mlflow.example.org)이
+# 이 클러스터의 다른 실제 배포와 겹칠 수 있다(lakekeeper에서 실측 — defense-llm 네임스페이스가
+# 동일 패턴의 host를 이미 쓰고 있었다).
+#
+# 카탈로그의 실제 권장 설정(custom-values.yaml)은 변경하지 않는다.
+tracking:
+  ingress:
+    hostname: mlflow-access-test.example.org
+    extraTls:
+    - hosts:
+        - mlflow-access-test.example.org
+      secretName: mlflow-tls-secret
@@ -0,0 +1,28 @@
+# superset 배포 테스트 전용 오버라이드 — custom-values.yaml 위에 얹어서 쓴다.
+# 목적: DB(cnpg-cluster) 연결 여부만 확인한다. custom-values.yaml의 configOverrides.enable_oauth는
+# 실제 운영 keycloak(플레이스홀더 URL/client_secret)을 가리키는 AUTH_TYPE = AUTH_OAUTH 설정이라,
+# 격리된 테스트 네임스페이스에서 로그인 화면에 "Keycloak으로 로그인" 버튼만 뜨고 실제로는
+# 가짜 URL이라 로그인이 불가능하다(실측). 이 키를 비워 기본 AUTH_DB(아이디/비번) 로그인으로
+# 되돌린다 — 다른 configOverrides 키(secret, log_level)는 그대로 둔다(Helm은 맵을 키 단위로
+# 병합하므로 이 키만 덮어써진다).
+#
+# 카탈로그의 실제 권장 설정(custom-values.yaml)은 변경하지 않는다.
+#
+# 주의: configOverrides의 모든 키는 superset_config.py 파일 하나로 합쳐진다. log_level
+# 키(LOG_LEVEL = logging.INFO)는 자체적으로 import를 안 하고 이 enable_oauth 키 맨 위의
+# `import logging`에 의존하고 있었다(실측 — 완전히 비우면 NameError로 전체 기동 실패).
+# 그래서 완전히 비우지 않고 import만 남긴다.
+configOverrides:
+  enable_oauth: |
+    import logging
+
+# 배포 테스트 시 host는 반드시 별도 값으로 덮어쓴다 — 카탈로그 기본값(superset.example.org)이
+# 이 클러스터의 다른 실제 배포와 겹칠 수 있다(lakekeeper에서 실측 — defense-llm 네임스페이스가
+# 동일 패턴의 host를 이미 쓰고 있었다).
+ingress:
+  hosts:
+  - superset-access-test.example.org
+  tls:
+  - hosts:
+    - superset-access-test.example.org
+    secretName: superset-tls-secret