카탈로그 앱 내장 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,85 @@
+# MLflow 배포
+
+bitnami/mlflow 차트(2.1.0) 기반 배포 가이드다.
+
+## 1. 배포 방법
+
+### 1) 사전 조건
+
+- 내장 bitnami postgresql 서브차트 대신 `cnpg-cluster`(전용 인스턴스)를 외부 DB로 사용한다.
+  `cloudnative-pg` operator(`manifests/helm/cloudnative-pg/0.29.0`)가 클러스터에 먼저 설치되어
+  있어야 한다.
+
+### 2) 배포 순서
+
+```sh
+git clone https://github.com/paasup/dip-catalog.git
+cd dip-catalog
+
+# 1) mlflow용 DB 계정 시크릿 생성 (password는 externalDatabase.password와 동일해야 한다)
+kubectl create secret generic mlflow-db-app-secret \
+  --from-literal=username=mlflow --from-literal=password=mlflow1234 -n mlflow
+
+# 2) 전용 cnpg-cluster 배포
+helm upgrade mlflow-db manifests/helm/cnpg-cluster/1.0.0 \
+  -f manifests/helm/cnpg-cluster/1.0.0/custom-values.yaml \
+  -f manifests/applicationset/mlflow/2.1.0/mlflow-db-values.yaml \
+  --install -n mlflow --create-namespace
+
+# 3) mlflow 배포
+helm upgrade mlflow manifests/helm/mlflow/2.1.0 -f custom-values.yaml --install -n mlflow
+```
+
+ArgoCD로 배포한다면 `manifests/applicationset/mlflow/2.1.0/`의 ApplicationSet을 쓴다 —
+`mlflow-db`(syncWave 0) → `mlflow`(syncWave 1) 순서로 자동 배포된다. 자세한 내용은 해당
+디렉토리의 `README.md` 참고.
+
+## 2. custom-values.yaml 설명
+
+### 1) 이미지 설정
+
+private 환경 배포 시 registry를 변경한다.
+
+```yaml
+image:
+  repository: bitnamilegacy/mlflow
+gitImage:
+  repository: bitnamilegacy/git
+waitContainer:
+  image:
+    repository: bitnamilegacy/os-shell
+```
+
+### 2) PostgreSQL 설정
+
+내장 postgresql 서브차트를 끄고 `externalDatabase`로 cnpg-cluster를 가리킨다.
+
+```yaml
+postgresql:
+  enabled: false
+
+externalDatabase:
+  dialectDriver: "postgresql"
+  host: "mlflow-db-rw"    # cnpg-cluster 릴리스명이 mlflow-db일 때의 rw 서비스명
+  port: 5432
+  user: mlflow
+  password: mlflow1234     # 위 시크릿 생성 시 사용한 password와 동일해야 한다
+  database: mlflow
+```
+
+참고: `manifests/applicationset/mlflow/2.1.0/mlflow-db-values.yaml`
+
+### 3) MinIO 설정
+
+아티팩트 저장소로 내장 minio 서브차트를 사용한다(`minio.enabled: true`). private 환경에서는
+`minio.image.repository`를 내부 registry로 변경한다.
+
+```yaml
+minio:
+  enabled: true
+  auth:
+    rootUser: admin
+    rootPassword: admin1234
+  image:
+    repository: bitnamilegacy/minio
+```
@@ -45,20 +45,20 @@ run:
      cpu: 250m
      memory: 512Mi
  
+# 내장 bitnami postgresql 서브차트 대신 cnpg-cluster(전용 인스턴스)를 외부 DB로 사용한다.
+# 사전 배포: helm install mlflow-db manifests/helm/cnpg-cluster/1.0.0 \
+#   -f manifests/helm/cnpg-cluster/1.0.0/custom-values.yaml \
+#   -f manifests/applicationset/mlflow/2.1.0/mlflow-db-values.yaml -n <ns>
 postgresql:
-  auth:
-    username: mlflow
-    password: mlflow1234
-  image:
-    repository: bitnamilegacy/postgresql
-  primary:
-    reousrces:
-      limits:
-        cpu: 500m
-        memory: 1Gi
-      requests:
-        cpu: 250m
-        memory: 512Mi
+  enabled: false
+
+externalDatabase:
+  dialectDriver: "postgresql"
+  host: "mlflow-db-rw"
+  port: 5432
+  user: mlflow
+  password: mlflow1234
+  database: mlflow
 minio:
  enabled: true
  auth: