Kubernetes Ingress 라우팅 — 404/503 디버깅 — 실습 Lab

INCIDENT RESPONSE

0 / 5 단계 완료

📚 PREREQUISITES

Labk8s-service-networking

Theorykubernetes/ingress-controller

Theorykubernetes/service-types

TRACK

KUBERNETES

SLA

45분

SEV

SEV-2

PHASES

3단계

ENV

local

INCOMING TICKET

“장애: "app.example.com으로 접속하면 404 Not Found(또는 503)인데, kubectl port-forward로 파드에 직접 붙으면 잘 돼요."”

YOUR ROLE

쿠버네티스 운영 엔지니어인 당신이

IMPACT IF UNRESOLVED

도메인 경로로 서비스가 노출되지 않음. 파드는 정상인데 외부 진입(Ingress)이 끊겨 사용자 접근 불가.

🚨INCIDENT BRIEF

app.example.com으로 접속하면 404(또는 503)가 납니다.

그런데 `kubectl port-forward svc/app 8080:80`로 직접 붙으면 멀쩡히 응답합니다.

"파드도 서비스도 사는데 왜 도메인만 안 되지?"

Ingress 라우팅은 사슬입니다: Ingress 규칙(host/path) → Service → Endpoints(실제 Pod IP).

도메인만 안 된다는 건 이 사슬의 어딘가가 끊겼다는 뜻 — port-forward는 그 사슬을 건너뛰고 서비스에 직접 붙기 때문에 됩니다.

한 고리씩 짚어 끊긴 지점을 특정합니다.

⏱ 45분📊 중급🔧 3단계#kubernetes#ingress#service#endpoints

MISSION

Ingress 규칙과 컨트롤러 상태 확인

Ingress 객체가 올바른 host/path와 backend service를 가리키는지, 컨트롤러가 사는지 본다

Service → Endpoints 사슬 확인 (503의 핵심)

Ingress가 가리키는 Service의 셀렉터가 실제 Pod를 잡아 Endpoints가 채워졌는지 본다

교정 + end-to-end 검증

끊긴 고리(규칙/셀렉터/포트)를 고치고, 실제 도메인 경로로 200이 오는지 검증한다

📌 선수 지식

ℹ️ 실습 환경

환경: local

필요 도구: kubectl

🔒

실습 실행은 Pro 플랜 전용입니다

인시던트 브리프와 학습 자료는 지금 바로 확인할 수 있습니다. 실제 실습 진행 및 터미널 사용은 Pro 플랜에서 가능합니다.

>_ LAB TERMINAL↔ 너비 조절

NOTES