AKS Ingress NGINX Healthcheck 404 문제

Info

25년 2월 작업 내용을 간단히 요약한 글입니다.

문제 상황

AKS(Azure Kubernetes Service) 클러스터에서 Ingress NGINX Controller의 /healthz 경로가 404 에러를 반환하여 Health check가 실패하는 문제가 발생했습니다.

원인

기본적으로 이 경로는 매핑이 되지 않은 상태라면 200 응답을 반환하는 주소입니다.¹

하지만 Ingress NGINX Controller에서 /healthz 경로에 대한 규칙이 다른 Ingress 규칙에 의해 덮어씌워져 있으면, 그 규칙을 따릅니다.
여기서는 경로가 명시되어 있지 않으면 404 응답을 반환하는 규칙이 적용되어 있었습니다.

해결 방법

/healthz 경로에 대한 별도의 Ingress 규칙을 설정하였습니다. 이를 통해 Health check 경로가 정상적으로 200 응답을 반환하도록 할 수 있었습니다.

Footnotes

1. Default backend - Ingress-Nginx Controller ↩