wbsong111
39f4b9778f
`demo01-air` 에서 webserver 가 반복 롤링되고 migrations job 이 5분 주기로 재실행되던 것을 추적한 결과, 원인이 서로 다른 두 개였고 둘 다 카탈로그 기본값에서 비롯됐다 — 모든 airflow 테넌트가 해당된다. 원인 1 — webserverSecretKey 가 렌더할 때마다 바뀐다 값을 주지 않으면 차트가 템플릿에서 직접 난수를 만들고(`randAlphaNum 32`), 그 Secret 이 webserver·worker Deployment 의 `checksum/webserver-secret-key` 애노테이션에 물려 있어 렌더할 때마다 Deployment spec 이 바뀐다. 캐시된 매니페스트를 쓰는 reconcile 로는 일어나지 않지만 일반 refresh 만으로도 일어난다(실측). 차트 안에서는 못 고친다. `lookup` 재사용은 ArgoCD repo-server 가 클러스터 접근 없이 클라이언트 렌더를 하므로 항상 빈 값이다(클러스터에 Secret 이 실재하는데도 빈 값인 것을 확인). 릴리스명·네임스페이스 기반 결정적 파생은 렌더는 안정되지만 파생 입력이 전부 공개 정보라 세션 서명 키를 예측할 수 있어 부적합하다. 값이 차트 바깥에서 와야 한다. 그래서 `$WEBSERVER_SECRET_KEY` placeholder 를 두고, 배포 시점에 dip-console-api 가 난수로 치환한다(`catalogs/catalogtype/catalog_airflow.go` 의 `DeployPreInstall`). 치환된 values 가 tenant 레포에 저장되므로 이후 렌더는 그 고정값을 쓴다. 공용 `catalog_type_base.go` 가 아니라 airflow 전용 훅에 둔다. 원인 2 — migrations job 이 TTL 삭제 ↔ selfHeal 재생성 루프에 빠진다 `useHelmHooks: false`(업스트림이 ArgoCD 환경에 권고) 로 Job 이 ArgoCD 추적 리소스가 됐는데 차트 기본값 `ttlSecondsAfterFinished: 300` 이 그대로 남아 있었다. 완료 300초 뒤 TTL 컨트롤러가 Job 을 지우면 ArgoCD 가 OutOfSync 로 보고 selfHeal 이 다시 만든다. 템플릿에서 TTL 은 `useHelmHooks` 와 무관하게 항상 렌더되고 `kindIs "invalid"` 일 때만 빠지므로, `~` 로 꺼서 필드 자체를 없앤다. 대신 완료된 Job 객체가 남는다. 반영 위치가 2곳이다 — helm 카탈로그와 applicationset(`---` 뒤 두 번째 문서) 양쪽. 한쪽만 고치면 배포 경로에 따라 증상이 남는다. 주의 — dip-console-api 와 짝이다. 한쪽만 머지되면 placeholder 문자열이 그대로 키가 되거나(카탈로그만) 아무 일도 일어나지 않는다(console 만). 이미 배포된 테넌트는 재배포해야 적용된다. fernet key 는 같은 구조지만 체크섬에 물려 있지 않아 증상·마이그레이션 경로가 다르다 — 별건(#38)으로 둔다. Refs #29 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
airflow ArgoCD ApplicationSet
airflow-db(cnpg-cluster, syncWave 0) → airflow(syncWave 1) 2단계로 배포한다.
전체 스키마는 manifests/applicationset/openmetadata/1.12.1/와
manifests/applicationset/victoria-metrics/1.0.0/를 따른다.
구성
applicationset.yaml— list generator로 Application 2개 생성.airflow-db-values.yaml— cnpg-cluster 환경 오버레이 템플릿(DB/owner, 시크릿 참조).airflow-values.yaml— airflow 환경 오버레이 템플릿(DB 비밀번호만).
두 파일 모두 템플릿이다 — dip-console이 렌더링해 값 repo(dip/tenant-catalog)의
airflow/*.yaml로 커밋하는 것을 가정한다.
값 적용 순서 (2단)
각 Application은 baseValues(카탈로그 차트의 custom-values.yaml) + valuesPath(값 repo의
환경 오버레이, 나중 파일 우선)를 병합한다.
사전 준비 (ArgoCD 밖)
cloudnative-pgoperator(manifests/helm/cloudnative-pg/0.29.0)가 클러스터에 먼저 설치되어 있어야 한다 — 없으면airflow-db(Cluster CR)가 webhook 부재로 생성 자체가 거부된다.airflow-db-values.yaml의bootstrap.initdb.secretName과 동일한 이름·값의 K8s Secret이 대상 네임스페이스에 미리 존재해야 한다(username/password키).- ArgoCD가
Cluster.postgresql.cnpg.io커스텀 리소스의 상태를 "Healthy"로 판정하려면argocd-cm에 해당 CRD용 커스텀 헬스 체크(Lua)가 등록되어 있어야 sync-wave 1이 정상 대기한다 — 미등록 시 wave 0이 Progressing으로만 남아 wave 1로 못 넘어갈 수 있다.
배포 테스트
절차와 주의사항은 .claude/deploy-test-procedure.md
"카탈로그 앱 → cnpg-cluster 전환 배포 테스트" 절을 따른다.
APP_POD_SELECTOR="component=webserver", fixture는
scripts/deploy-test/fixtures/airflow-deploy-test-overrides.yaml.