study.

Service 이름으로 HTTP 요청 보내기 · Kubernetes

변하는 Pod IP 대신 안정적인 서비스 이름을 사용합니다.

← Kubernetes

진도·퀴즈와 함께 학습하기

먼저, 개념을 잡아볼게요.

연결 대상을 고르는 selector

Service selector는 Pod label과 일치해야 합니다. Deployment 이름이 같다는 이유만으로 연결되지는 않습니다.

ClusterIP와 DNS

ClusterIP는 클러스터 내부 접근 지점입니다. 같은 namespace의 클라이언트는 web 같은 짧은 이름으로 Service를 찾을 수 있습니다.

실제 백엔드 확인

EndpointSlice를 보면 대상 주소와 readiness를 확인할 수 있습니다. 이름은 풀리는데 응답이 없다면 백엔드와 포트를 따로 조사합니다.

왜 필요한가요?

Pod IP를 설정 파일에 적으면 교체 때마다 연결 주소를 갱신해야 합니다. Service 이름은 바뀌는 백엔드 집합 앞에 안정적인 접점을 둡니다.

차례대로 이해하기

이름에서 대상까지

클라이언트가 Service 이름을 조회한 다음 Service 주소로 요청합니다. selector에 맞고 준비된 Pod가 일반적인 백엔드가 됩니다. EndpointSlice를 보면 그 시점에 연결된 주소를 확인할 수 있습니다.

실제 응답 확인

실습에서는 같은 namespace의 클라이언트 Pod에서 HTTP 요청을 보냅니다. Service가 존재한다는 조회 결과와 HTML 응답을 받은 결과를 따로 기록하세요. 후자가 실제 경로를 더 많이 확인합니다.

직접 실행하며 익혀보세요.

kubectl과 개인 실습용 Kubernetes 클러스터, POSIX 셸이 필요합니다. 매 실습에서 context를 확인하고 전용 namespace를 사용하세요. 실습별 정리는 해당 namespace의 모든 리소스를 삭제합니다.

web Deployment와 Service를 만들고 임시 BusyBox Pod에서 HTTP 요청을 보내세요. Service가 생긴 뒤 클라이언트를 실행합니다.

kubectl config current-context
kubectl create namespace study-k8s-service --dry-run=client -o yaml | kubectl apply -f -
kubectl create deployment web --image=nginx:stable-alpine -n study-k8s-service --dry-run=client -o yaml | kubectl apply -f -
kubectl rollout status deployment/web -n study-k8s-service --timeout=120s
kubectl expose deployment web --port=80 --target-port=80 -n study-k8s-service --dry-run=client -o yaml | kubectl apply -f -
kubectl run client --image=busybox:1.36 --restart=Never -n study-k8s-service --command -- wget -qO- http://web
kubectl wait --for=jsonpath='{.status.phase}'=Succeeded pod/client -n study-k8s-service --timeout=90s
kubectl logs client -n study-k8s-service
kubectl get endpointslices -n study-k8s-service -l kubernetes.io/service-name=web
kubectl get pods -n study-k8s-service -o wide

이렇게 확인하세요

클라이언트가 nginx HTML을 출력해야 합니다. EndpointSlice 주소와 Pod IP를 비교하세요. DNS 오류면 클러스터 DNS를, 연결 실패면 selector·readiness·targetPort를 확인합니다.

실습 리소스 정리

결과 확인을 마친 뒤 실행하세요. 이 실습에서 만든 리소스와 보존할 데이터가 없는지 확인합니다.

kubectl delete namespace study-k8s-service

응용해보기

Pod가 교체되어 IP가 바뀌었습니다. 클라이언트 설정에서 무엇은 그대로 두고 무엇을 관찰할까요?

생각해본 뒤 풀이 보기

Service 이름과 port는 유지하고 EndpointSlice의 backend 주소 변화와 준비 상태를 관찰합니다. 새 Pod의 label이 selector에 맞는지도 확인하며 새 IP를 클라이언트에 수동으로 박아 넣지 않습니다.

잠깐, 이해했는지 확인해볼까요?

Service에 대상 Pod가 연결되는 핵심 조건은?

  1. Service와 Pod의 이름이 같음
  2. selector와 Pod label이 일치함
  3. Pod 로그에 Service 이름이 있음
  4. 이미지 태그가 latest임
생각해본 뒤 풀이 보기

selector와 Pod label이 일치함

Service는 이름이 아니라 selector에 맞는 Pod를 선택합니다. 준비 상태와 포트도 정상이어야 실제 요청을 처리합니다.

공식 문서 · Service 이름으로 HTTP 요청 보내기