[데브옵스] 쿠버네티스 트러블슈팅 가이드

쿠버네티스는 현대 애플리케이션의 배포와 관리를 간소화하는 강력한 도구입니다. 그러나, 복잡한 시스템을 다루다 보면 예상치 못한 문제가 발생할 수 있습니다. 본 글에서는 쿠버네티스 환경에서 자주 발생하는 문제와 이를 해결하는 방법을 초급자도 이해할 수 있도록 친절하게 설명하겠습니다.

1. 파드(Pod)가 실행되지 않을 때

쿠버네티스에서 파드는 애플리케이션의 기본 실행 단위입니다. 파드가 제대로 실행되지 않을 경우, 시스템 전체에 영향을 미칠 수 있습니다.

주요 체크 포인트

• 이벤트 로그 확인: kubectl describe pod <pod-name> 명령어로 이벤트 로그를 확인하여 오류 메시지를 찾습니다.
• 리소스 부족: 노드의 CPU나 메모리가 부족할 수 있습니다. kubectl top nodes 명령어로 리소스를 모니터링합니다.
• 이미지 풀 실패: 올바른 이미지 태그를 사용하고 있는지, 이미지 레지스트리가 접근 가능한지 확인합니다.

kubectl describe pod my-pod
kubectl top nodes

2. 서비스가 외부에서 접근되지 않을 때

서비스는 파드에 외부 트래픽을 라우팅하는 역할을 합니다. 서비스가 외부에 노출되지 않는다면, 사용자 요청이 파드에 도달하지 않을 수 있습니다.

주요 체크 포인트

• 서비스 타입 확인: NodePort 또는 LoadBalancer 타입이 제대로 설정되었는지 확인합니다.
• 네트워크 정책 확인: 네트워크 정책이 트래픽을 차단하고 있을 수 있습니다. kubectl describe networkpolicy로 정책을 검토합니다.
• Ingress 설정: Ingress가 제대로 설정되어 있는지 확인하고, 필요한 경우 재설정합니다.

kubectl describe service my-service
kubectl describe networkpolicy

3. 디플로이먼트가 업데이트되지 않을 때

디플로이먼트는 애플리케이션의 선언적 업데이트를 관리합니다. 업데이트가 반영되지 않는 경우, 최신 버전의 애플리케이션이 배포되지 않을 수 있습니다.

주요 체크 포인트

• 롤아웃 상태 확인: kubectl rollout status deployment <deployment-name> 명령어로 업데이트 상태를 확인합니다.
• 레플리카셋 상태 확인: kubectl get rs 명령어로 올바른 레플리카셋이 생성되었는지 확인합니다.
• 이미지 태그 변경 여부: 새로운 이미지가 푸시되었는지 확인합니다.

kubectl rollout status deployment my-deployment
kubectl get rs

4. 노드가 정상 작동하지 않을 때

노드는 파드를 호스팅하는 물리적 또는 가상 머신입니다. 노드가 비정상적으로 작동하면, 전체 클러스터의 상태에 영향을 미칠 수 있습니다.

주요 체크 포인트

• 노드 상태 확인: kubectl get nodes 명령어로 노드의 상태를 확인합니다.
• 로그 확인: 노드의 시스템 로그를 통해 문제를 진단합니다.
• 노드 재시작: 필요에 따라 노드를 재시작하여 문제를 해결합니다.

kubectl get nodes

5. 네트워크 문제

네트워크 문제는 파드 간 통신 및 외부 서비스 연결에 영향을 줄 수 있습니다.

주요 체크 포인트

• DNS 설정 확인: kubectl exec로 파드 내에서 DNS 설정을 확인합니다.
• 네트워크 플러그인 상태 확인: 네트워크 플러그인이 올바르게 작동하는지 확인합니다.
• 네트워크 트래픽 분석: kubectl logs를 통해 네트워크 관련 로그를 분석합니다.

kubectl exec -it my-pod -- cat /etc/resolv.conf
kubectl logs <network-plugin-pod>

정리 및 요약

쿠버네티스는 애플리케이션 관리의 복잡성을 줄여주는 강력한 플랫폼이지만, 다양한 문제 상황에 대비해야 합니다. 파드 실행 문제에서 네트워크 설정까지, 각 문제는 다양한 원인에 의해 발생할 수 있으며, 이를 해결하기 위한 적절한 접근 방법이 필요합니다. 이번 가이드에서는 쿠버네티스에서 자주 발생하는 문제와 그 해결 방법을 다루었습니다. 각 문제 상황별로 체크 포인트를 통해 문제를 진단하고, 적절한 명령어를 사용하여 해결책을 제시하였습니다. 이를 통해 쿠버네티스 환경에서 안정적인 애플리케이션 운영이 가능할 것입니다.