wbsong111
d3816a14ca
차트가 fernet key Secret 을 직접 만들면 helm.sh/hook: pre-install + hook-delete-policy: before-hook-creation 이 붙는다. ArgoCD 는 훅을 "삭제 후 재생성" 하는데, 변경이 없는 sync 에서는 삭제 직후 operation 이 종료되어 재생성되지 않는다. 컨트롤러 로그로 확인했다. 변경 있는 sync waiting for deletion ... -> serverside-applied -> Succeeded 'all tasks run' no-op sync waiting for deletion ... -> Succeeded (같은 초) 'no more tasks' 파드는 이미 주입된 env 로 계속 돌아 증상이 즉시 드러나지 않지만, 재시작하는 순간 CreateContainerConfigError 로 기동하지 못한다. refresh·selfHeal 로 흔히 발생하는 상황이다. fernetKeySecretName 을 주면 차트가 Secret 을 아예 만들지 않으므로 (templates/secrets/fernetkey-secret.yaml:23) 훅 자체가 사라지고, 모든 워크로드가 그 이름을 secretKeyRef 로 참조한다(templates/_helpers.yaml:395-397). $FERNET_KEY_SECRET 은 placeholder 다. dip-console-api 가 <릴리스명>-fernet-key Secret 을 만들고(없을 때만) 이 자리를 그 이름으로 치환한다. 콘솔이 만든 Secret 은 ArgoCD 추적 대상이 아니라 sync 의 영향을 받지 않는다. 값이 아니라 이름을 넘기는 이유가 하나 더 있다 — fernet key 는 메타DB 의 Connection·Variable 암호화에 쓰이므로 tenant 레포(git)에 평문으로 남기지 않는다. 업스트림도 can only be set during install, not upgrade 라고 못박고 있어, 이미 배포된 테넌트는 재배포 시 현재 Secret 을 그대로 인수한다. CUSTOM-README 5절은 이 문서의 성격(배포 방법 · custom-values.yaml 키 설명)에 맞게 키 테이블과 배포 절차 중심으로 다시 썼다(69줄 -> 48줄). 상세 근거는 이슈로 넘긴다. redis 훅 Secret 2종은 CeleryExecutor 전환 예정이 없어 조치하지 않는다. 참조 워크로드가 0개인 것을 클러스터에서 확인했다. 전환 시 처리 방법만 문서에 남긴다. 검증 service-catalog 에 선반영해 테스트 클러스터에서 확인했다. 재배포 후 sync 를 걸었을 때 훅인 redis Secret 2종은 또 삭제됐고 콘솔이 관리하는 fernet Secret 만 살아남았다(resourceVersion 미동, 값 동일). 이 레포 기준으로도 helm template 2회 렌더에서 차트가 fernet Secret 을 만들지 않고 webserver 체크섬이 동일함을 확인했다. 관련: paasup/dip-catalog#38, paasup/dip-console-api#100 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.