01
관련 리소스를 함께 넣기
Ingress와 Service를 ---로 구분하고 필요하면 Deployment나 Pod도 넣으세요. 다른 네임스페이스의 동명 Service는 참조 대상이 아닙니다.
Kubernetes / Helm
인그레스 경로 매칭 확인
렌더링된 YAML과 요청 Host·경로를 입력해 정적인 라우팅 체인을 확인하세요.
인그레스 경로 매칭 확인
라우팅 보고서
매니페스트를 넣거나 예시를 불러오세요.
브라우저 안에서만 분석하며 클러스터 연결이나 HTTP 요청을 하지 않습니다.
요청 설정
Exact와 Prefix는 Kubernetes 규칙으로 판단하며 컨트롤러 고유 경로는 제외합니다.
제한: 300,000자, 리소스 100개, 경로 500개.
매니페스트를 넣거나 예시를 불러오세요.
Ingress 경로는 맞아 보여도 백엔드가 Service에 없는 포트를 가리킬 수 있습니다. 인그레스 경로 매칭 확인은 요청 한 건을 따라가며 어디에서 연결이 끊기는지 보여 줍니다.
규칙이 맞는 것과 실제 네트워크 연결은 다릅니다. 이 도구는 붙여 넣은 리소스만 읽고 클러스터에는 연결하지 않습니다.
인그레스 경로 매칭 확인이 필요한 이유
요청 하나의 경로를 끝까지 추적
인그레스 경로 매칭 확인은 가장 긴 경로를 선택하고 길이가 같으면 Exact를 우선합니다. 선택된 Service port가 어떤 targetPort로 이어지는지도 보여 줍니다.
확실한 오류와 정보 부족을 구별
Service에 없는 포트를 참조하면 끊긴 지점을 표시합니다. Pod 리소스를 붙여 넣지 않았다면 장애로 단정하지 않고 확인할 수 없음으로 남깁니다.
매니페스트 수정 전 확인할 세 가지
02
요청 조건을 구체적으로 지정
초기 경로는 /입니다. /api/orders 같은 실제 경로와 HTTP Host를 입력하세요. Host를 비우면 Host 없는 규칙만 시험할 수 있습니다.
03
결과의 근거 읽기
매칭은 정적 규칙의 결과입니다. 끊긴 참조, 정보 부족, 컨트롤러 의존 상태를 구분하고 입력을 고친 뒤 다시 검사해야 복사할 수 있습니다.
Ingress에서 대상 포트까지
Host와 경로 선택
인그레스 경로 매칭 확인은 Exact, 경로 구간별 Prefix, 정확한 Host와 한 단계 와일드카드 Host를 다룹니다. /api는 /apix에 맞지 않습니다. 쿠버네티스 인그레스 라우팅 전체가 아니라 표준 경로 규칙을 정적으로 확인합니다.
Service 포트 매핑
Ingress 백엔드는 Service port나 포트 이름을 먼저 찾습니다. 그다음 Service의 targetPort를 표시하며 생략 시 port 값을 사용합니다.
선택적 워크로드 단서
Deployment 템플릿이나 Pod가 있으면 selector와 라벨을 비교합니다. 리소스가 없으면 실제 엔드포인트가 있다고 추정하지 않습니다.
정적 검사의 한계
- 컨트롤러별 경로는 확정하지 않음
- ImplementationSpecific, 정규식, rewrite 어노테이션은 컨트롤러에 따라 달라집니다. 인그레스 경로 매칭 확인은 이를 Prefix로 가장하지 않습니다.
- 실제 HTTP 요청은 보내지 않음
- Ingress 404 원인을 확정하려면 컨트롤러 로그, DNS, EndpointSlice와 실제 응답을 확인해야 합니다. 이 페이지는 로컬 YAML만 읽습니다.
- 누락된 Pod는 곧 단절이 아님
- 붙여 넣지 않은 Pod나 수동 엔드포인트가 있을 수 있습니다. Service 또는 포트 참조가 없을 때만 확실한 단절로 표시합니다.
- 입력 범위
- 최대 300,000자, 리소스 100개, 경로 500개를 처리합니다. 렌더링된 networking.k8s.io/v1 Ingress와 v1 Service만 검사하며 Helm 템플릿과 Gateway API는 제외합니다.
인그레스 경로 매칭 확인 질문
인그레스 Prefix 경로는 /foo-bar에도 매칭되나요?
아니요. Prefix는 /로 나눈 구간을 비교합니다. /foo는 /foo/bar와 맞지만 /foo-bar와는 맞지 않고 대소문자도 구별합니다.
인그레스 백엔드는 서비스 port와 targetPort 중 무엇을 가리키나요?
Ingress 백엔드는 Service의 port 숫자 또는 이름을 가리킵니다. targetPort는 Service가 Pod 쪽으로 보내는 포트이므로 두 단계를 혼동하면 참조가 끊깁니다.
호스트가 맞지 않으면 기본 백엔드로 가나요?
Host가 일치하지 않으면 그 규칙은 선택되지 않습니다. defaultBackend가 있으면 후보가 되며 없을 때의 실제 응답은 컨트롤러가 결정합니다.
인그레스에서 404가 나는 이유는 무엇인가요?
Host나 경로 불일치, 기본 백엔드, rewrite, 애플리케이션 응답 등 여러 원인이 있습니다. 정적 경로를 본 뒤 컨트롤러 로그와 실제 요청을 확인하세요.
YAML만으로 파드 연결 상태를 확인할 수 있나요?
아니요. YAML만으로 Pod 준비 상태, EndpointSlice, DNS 또는 네트워크 연결을 알 수 없습니다.
경로에 대해 더 궁금한 점이 있나요?