초록불인데 아무도 그 근거를 모른다 — 헬스 규칙을 직접 쓴다

목표

argocd-cm 의 resource.customizations.health.<그룹>_<종류> 에 Lua 규칙을 써서 CRD 의 헬스를 Healthy·Progressing·Degraded·Suspended 네 칸으로 갈라 내고, 표본과 기대를 표로 묶어 회귀 검사한다.

왜 중요한가

Argo CD 화면에서 사람이 실제로 보는 것은 동기화가 아니라 헬스다. Deployment·Service·Job 같은 내장 종류는 컨트롤러가 알아서 판정하지만 CRD 에는 내장 규칙이 없다. 오퍼레이터가 만드는 자원이 화면에서 늘 같은 색으로 보인다면, 그건 잘 되고 있다는 뜻이 아니라 판정할 근거가 없다는 뜻이다. 규칙을 직접 쓰는 일이 중요한 이유는 두 가지다. 첫째, 아직 만들어지는 중과 이미 망가진 것을 갈라야 알림을 걸 수 있다. 둘째, 규칙은 한 번 쓰면 잊히는 코드라 표본과 기대를 함께 저장소에 두어야 나중에 status 필드가 바뀌었을 때 조용히 틀리지 않는다.

단계

1. /root/ga-health/argocd-cm.yaml 을 data: {} 인 빈 argocd-cm ConfigMap 으로 만들고, /root/ga-health/deploy.yaml 에 ga-health 네임스페이스의 Deployment web 을 두세요 — spec.replicas 는 3 이고 status 에는 observedGeneration: 1, replicas: 3, updatedReplicas: 2, readyReplicas: 1, availableReplicas: 1 을 적습니다. argocd admin settings resource-overrides health /root/ga-health/deploy.yaml --argocd-cm-path /root/ga-health/argocd-cm.yaml 의 출력을 /root/ga-health/builtin.txt 에 저장하세요.
2. /root/ga-health/w-ready.yaml 에 example.com/v1 의 Widget 을 만드세요 — 이름 w-ready, 네임스페이스 ga-health, spec.size 3, status.phase 는 Ready 입니다. 1단계의 빈 argocd-cm 으로 이 파일의 헬스를 물어 출력을 /root/ga-health/nocustom.txt 에 저장하세요.
3. /root/ga-health/argocd-cm-healthy.yaml 에 키 resource.customizations.health.example.com_Widget 를 두고, status.phase 가 Ready 면 Healthy 를, 그 밖에는 Progressing 을 돌려주는 Lua 를 쓰세요. 두 경우 모두 hs.message 를 채웁니다. /root/ga-health/w-ready.yaml 을 이 ConfigMap 으로 판정한 출력을 /root/ga-health/healthy.txt 에 저장하세요.
4. /root/ga-health/w-failed.yaml 을 만드세요 — 이름 w-failed, status.phase 는 Failed, status.reason 은 DiskFull 입니다. /root/ga-health/argocd-cm-degraded.yaml 은 3단계 규칙에 Failed 가지를 더해 Degraded 를 돌려주되, hs.message 안에 그 리소스의 status.reason 값이 들어가야 합니다. 판정 출력을 /root/ga-health/degraded.txt 에 저장하세요.
5. /root/ga-health/w-building.yaml(status.phase 가 Building, 이름 w-building)과 /root/ga-health/w-nostatus.yaml(status 자체가 없음, 이름 w-nostatus)을 만드세요. 4단계 ConfigMap 으로 둘을 차례로 판정해 출력을 /root/ga-health/progressing.txt 에 이어 붙이세요. 둘 다 Progressing 이어야 합니다.
6. /root/ga-health/w-paused.yaml 을 만드세요 — 이름 w-paused, spec.paused 는 true, status.phase 는 Ready 입니다. /root/ga-health/argocd-cm-full.yaml 은 앞 규칙에 가지를 하나 더해, spec.paused 가 참이면 다른 조건보다 먼저 Suspended 를 돌려줘야 합니다. 판정 출력을 /root/ga-health/suspended.txt 에 저장하세요.
7. /root/ga-health/argocd-cm-typo.yaml 을 만드세요 — 6단계와 내용은 같지만 키 이름만 resource.customizations.health.example.com_Widgets (종류를 복수로) 로 씁니다. 이 ConfigMap 으로 /root/ga-health/w-ready.yaml 을 판정한 출력을 /root/ga-health/typo.txt 에 저장하세요.
8. /root/ga-health/health-matrix.tsv 에 <샘플파일이름>\t<기대 STATUS> 를 네 줄 이상 적으세요 — Healthy·Degraded·Progressing·Suspended 가 모두 한 번 이상 나와야 합니다. /root/ga-health/check-health.sh 는 이 표를 읽어 /root/ga-health/argocd-cm-full.yaml 로 각 샘플을 판정하고, 맞으면 OK … 틀리면 MISMATCH … 를 표준출력에만 찍고 한 줄이라도 틀리면 0 이 아닌 코드로 끝나야 합니다. 그 출력을 /root/ga-health/health-result.txt 에 저장하세요.

참고

• Lua 조각은 obj 로 리소스를 받고 hs.status·hs.message 를 채운 테이블을 return 합니다.
• 헬스 상태 이름은 Healthy, Progressing, Degraded, Suspended, Missing, Unknown 입니다.
• 키 이름의 구분자는 점이 아니라 밑줄입니다 — resource.customizations.health.<그룹>_<종류>.
• 흔한 실수: status 가 없는 순간을 빠뜨려 새로 만든 자원이 매번 빨간불로 시작한다.
• 흔한 실수: 종류 이름을 복수로 적는다. 오류가 나지 않고 규칙이 없는 것처럼 동작한다.
• 참고: https://argo-cd.readthedocs.io/en/stable/operator-manual/health/

단계 8개

1. 내장 판정부터 본다
2. CRD 에는 규칙이 아예 없다
3. 초록불의 조건을 Lua 로 적는다
4. 빨간불에는 이유가 함께 나와야 한다
5. 모르는 상태와 상태가 없는 것은 같은 칸으로 보낸다
6. 일부러 멈춰 둔 것은 고장이 아니다
7. 키 이름을 한 글자 틀리면 규칙이 통째로 사라진다
8. 표본과 기대를 표로 묶어 규칙을 회귀 검사한다