Files

T

wbsong111 3ee1c1ee23 카탈로그 앱 내장 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 는 참조만 남겼다.

README.md

flowise ArgoCD ApplicationSet

flowise-db(cnpg-cluster, syncWave 0) → flowise(syncWave 1) 2단계로 배포한다. 전체 스키마는 manifests/applicationset/openmetadata/1.12.1/와 manifests/applicationset/victoria-metrics/1.0.0/를 따른다.

구성

applicationset.yaml — list generator로 Application 2개 생성.
flowise-db-values.yaml — cnpg-cluster 환경 오버레이 템플릿(DB/owner, 시크릿 참조).
flowise-values.yaml — flowise 환경 오버레이 템플릿(DB 비밀번호만).

두 파일 모두 템플릿이다 — dip-console이 렌더링해 값 repo(dip/tenant-catalog)의 flowise/*.yaml로 커밋하는 것을 가정한다.

값 적용 순서 (2단)

각 Application은 baseValues(카탈로그 차트의 custom-values.yaml) + valuesPath(값 repo의 환경 오버레이, 나중 파일 우선)를 병합한다.

사전 준비 (ArgoCD 밖)

cloudnative-pg operator(manifests/helm/cloudnative-pg/0.29.0)가 클러스터에 먼저 설치되어 있어야 한다.
flowise-db-values.yaml의 bootstrap.initdb.secretName과 동일한 이름·값의 K8s Secret이 대상 네임스페이스에 미리 존재해야 한다(username/password 키).
ArgoCD가 Cluster.postgresql.cnpg.io 커스텀 리소스의 상태를 "Healthy"로 판정하려면 argocd-cm에 해당 CRD용 커스텀 헬스 체크(Lua)가 등록되어 있어야 sync-wave 1이 정상 대기한다.
flowise는 내장 postgresql을 끄는 것(postgresql.enabled: false)만으로는 부족하고 externalPostgresql.enabled: true를 함께 켜야 한다 — 다른 차트와 다른 점이다.

배포 테스트

절차와 주의사항은 .claude/deploy-test-procedure.md "카탈로그 앱 → cnpg-cluster 전환 배포 테스트" 절을 따른다. APP_POD_SELECTOR="app.kubernetes.io/component=flowise", fixture는 scripts/deploy-test/fixtures/flowise-deploy-test-overrides.yaml.