🧪 Kubernetes 디버깅 & 테스트를 위한 필수 파드(Pod) 실행 예시 9가지

💡 알아두면 좋은 점

--restart=Never: 일회성 작업을 위한 파드(Pod)를 생성합니다. 디플로이먼트(Deployment)가 아니므로 파드가 종료되어도 다시 시작되지 않습니다.

• --rm: 파드에 접속(attach)한 세션이 종료되면 파드를 자동으로 삭제해 줍니다. 임시 테스트에 유용합니다.
• -i --tty: 컨테이너의 표준 입력(stdin)과 터미널(tty)을 활성화하여 셸과 같은 대화형 세션을 사용할 수 있게 합니다.

1. 가장 기본적인 테스트: 단순 셸 접속

가장 기본적이면서도 많이 사용하는 방법입니다. 클러스터 내부에서 특정 IP로 통신이 가능한지 확인하거나 간단한 파일 다운로드를 테스트할 때 유용합니다.

🔹 사용 이미지: busybox

📝 설명:
busybox는 다양한 기본 유닉스 도구(sh, ping, wget, nslookup 등)를 포함한 초경량 이미지입니다. 파드를 실행한 후 kubectl exec 명령어로 접속하여 필요한 작업을 수행할 수 있습니다.

💻 실행 명령어:

# 1시간(3600초) 동안 실행되는 'test' 파드 생성
kubectl run test --image=busybox --restart=Never -- sleep 3600

# 생성된 파드에 셸(sh)로 접속
kubectl exec -it test -- sh

2. 강력한 네트워크 디버깅 툴 사용

ping이나 wget만으로는 부족한 복잡한 네트워크 문제를 진단해야 할 때가 있습니다. netshoot 이미지는 네트워크 전문가를 위한 거의 모든 도구를 갖추고 있습니다.

🔹 사용 이미지: nicolaka/netshoot

📝 설명:
tcpdump, dig, traceroute, curl 등 강력한 네트워크 진단 도구가 모두 포함되어 있어 파드 간 통신, DNS 문제, 외부 연결 이슈 등을 디버깅하는 데 최적입니다.

💻 실행 명령어:

# 'netshoot' 파드를 대화형 모드로 실행하고 바로 bash 셸로 접속
# 세션 종료 시 파드는 자동 삭제됨 (--rm)
kubectl run netshoot --rm -i --tty --image=nicolaka/netshoot -- bash

3. curl 테스트 전용 초경량 파드

단순히 HTTP/HTTPS 요청만 보내 상태 코드나 응답을 확인하고 싶을 때, busybox나 netshoot은 조금 무겁게 느껴질 수 있습니다. 이때는 curl 전용 이미지를 사용하는 것이 효율적입니다.

🔹 사용 이미지: curlimages/curl

📝 설명:
오직 curl 명령어 실행만을 위해 만들어진 매우 작고 가벼운 이미지입니다. 빠르게 파드를 띄워 API 요청 테스트를 수행할 때 적합합니다.

💻 실행 명령어:

# 'curl-pod'를 생성하고 1시간 동안 유지
kubectl run curl-pod --image=curlimages/curl --restart=Never -- sleep 3600

# curl-pod 내부에서 특정 서비스(myservice)로 요청 보내기
kubectl exec curl-pod -- curl http://myservice.default.svc.cluster.local

4. 간단한 HTTP 서버 직접 실행하기

클러스터 내부의 다른 파드에서 현재 파드로의 요청이 잘 들어오는지 테스트하고 싶을 때, 간단한 웹 서버를 즉시 실행할 수 있습니다.

🔹 사용 이미지: python:3.12-slim

📝 설명:
Python 표준 라이브러리를 이용하면 한 줄 명령어로 간단한 HTTP 서버를 실행할 수 있습니다. python:slim 이미지를 사용하여 가볍게 구성 가능합니다.

💻 실행 명령어:

# 5000번 포트로 HTTP 서버를 실행하는 'myserver' 파드 생성
kubectl run myserver --image=python:3.12-slim --restart=Never --expose --port=5000 --command -- python -m http.server 5000

# --expose 옵션으로 ClusterIP 타입의 서비스가 함께 생성됩니다.

5. 테스트 서버를 서비스(Service)로 노출하기

위에서 만든 myserver와 같이 파드를 생성만 하면 클러스터 내 다른 파드들이 고정된 주소로 접근하기 어렵습니다. 이럴 때 Service를 생성하여 내부 DNS 이름을 부여하고 접근성을 높일 수 있습니다.

📝 설명:
kubectl expose 명령어를 사용하면 이미 실행 중인 파드를 손쉽게 Service로 노출시킬 수 있습니다. ClusterIP 타입은 클러스터 내부에서만 접근 가능한 고유 IP를 할당합니다.

💻 실행 명령어:

# 'myserver' 파드를 5000번 포트로 노출하는 ClusterIP 타입의 서비스 생성
# (만약 4번 예제에서 --expose 옵션을 쓰지 않았다면 이 명령어를 사용하세요)
kubectl expose pod myserver --type=ClusterIP --port=5000

6. 간단한 TCP 서버 테스트

HTTP가 아닌 순수 TCP 통신을 테스트해야 할 때가 있습니다. netcat(nc)을 이용하면 간단한 TCP 리스닝 서버를 만들 수 있습니다.

🔹 사용 이미지: appropriate/nc

📝 설명:
방화벽 규칙이나 네트워크 정책(NetworkPolicy)이 TCP 트래픽을 올바르게 허용하는지 확인할 때 유용합니다. 지정된 포트에서 연결을 기다리는 서버를 즉시 생성합니다.

💻 실행 명령어:

# 1234번 포트에서 TCP 연결을 기다리는 'nc-server' 파드 생성
kubectl run nc-server --image=appropriate/nc --restart=Never -i --tty -- sh -c "nc -lkp 1234"

7. DNS 해석(Resolution) 전문 테스트

쿠버네티스에서 가장 흔한 문제 중 하나는 DNS 해석 문제입니다. CoreDNS가 정상적으로 작동하는지, 서비스 이름이 IP로 잘 변환되는지 확인할 때 특화된 도구를 사용할 수 있습니다.

🔹 사용 이미지: infoblox/dnstools

📝 설명:
dig, nslookup, host 등 DNS 진단에 필요한 모든 도구가 포함되어 있어 서비스 디스커버리 문제를 해결하는 데 큰 도움이 됩니다.

💻 실행 명령어:

# 'dnstools' 파드 생성 후 1시간 동안 유지
kubectl run dnstools --image=infoblox/dnstools --restart=Never -- sleep 3600

# 생성된 파드에서 구글 DNS 서버에 대해 nslookup 실행
kubectl exec dnstools -- nslookup google.com

8. 간단한 HTTP 부하 테스트

새로운 애플리케이션을 배포한 후 간단하게 성능을 점검하고 싶을 때, hey라는 경량 부하 테스트 도구를 사용할 수 있습니다.

🔹 사용 이미지: rakyll/hey

📝 설명:
hey는 Go로 작성된 간단한 부하 생성기입니다. 별도의 복잡한 설정 없이 클러스터 내부에서 특정 서비스에 트래픽을 보내 응답 시간, 성공률 등을 확인할 수 있습니다.

💻 실행 명령어:

# 'hey' 도구를 사용할 파드 생성
kubectl run hey --image=rakyll/hey --restart=Never -- sleep 3600

# 'hey' 파드에서 myserver 서비스에 10초간, 10개의 동시 연결로 부하 테스트
kubectl exec hey -- hey -z 10s -c 10 http://myserver:5000

9. 리소스 스트레스 테스트 (CPU/Memory)

파드의 resources.limits와 requests 설정이 올바르게 동작하는지, 혹은 노드에 부하를 주어 오토스케일링(HPA)이 잘 작동하는지 테스트할 때 유용합니다.

🔹 사용 이미지: alpine/stress

📝 설명:
stress-ng 도구를 포함한 이미지로, CPU, 메모리, I/O 등 시스템에 의도적으로 부하를 발생시켜 한계 상황을 테스트하는 데 사용됩니다.

💻 실행 명령어:

# 1개의 CPU 코어에 30초 동안 부하를 주는 'stress' 파드 생성
kubectl run stress --image=alpine/stress --restart=Never -- --cpu 1 --timeout 30s

---

쿠버네티스 패키지관리

     📕교보문고 종이책 구매
     📱교보문고 이북 구매
🛒부크크 종이책 구매

실수로 배우는 자바

📕교보문고 종이책 구매
📱교보문고 이북 구매
🛒 부크크 종이책 구매

AI와 함께하는 협업 바이블

📱교보문고 이북 구매
     🛒부크크 종이책 구매
책은 yes24, 알라딘에도 판매 되고 있습니다.