[DevOps] 쿠버네티스 트러블슈팅 기법

쿠버네티스는 현대 애플리케이션 배포 및 관리에 있어 강력한 도구이지만, 복잡한 시스템인 만큼 다양한 문제 상황이 발생할 수 있습니다. 이 글에서는 쿠버네티스 환경에서 흔히 발생하는 문제와 이를 해결하기 위한 트러블슈팅 기법을 알아보겠습니다.

1. 파드(Pod)가 실행되지 않는 경우

쿠버네티스에서 파드는 컨테이너의 최소 단위입니다. 파드가 실행되지 않으면 애플리케이션이 정상적으로 작동하지 않을 수 있습니다.

1.1 파드 로그 확인

첫 번째로 해야 할 일은 파드의 로그를 확인하는 것입니다. 쿠버네티스에서는 kubectl logs 명령어를 사용하여 파드의 로그를 쉽게 확인할 수 있습니다.

kubectl logs <pod-name>

이 명령어를 통해 파드에서 발생한 오류나 경고 메시지를 확인할 수 있습니다.

1.2 이벤트(Event) 확인

파드의 상태를 더 자세히 파악하기 위해 이벤트를 확인할 수 있습니다. 이는 파드가 왜 스케줄링되지 않았는지, 또는 왜 종료되었는지를 알 수 있는 중요한 정보입니다.

kubectl describe pod <pod-name>

이 명령어는 해당 파드의 이벤트 로그와 상태를 상세히 보여줍니다.

2. 서비스(Service) 연결 문제

쿠버네티스 서비스는 파드 간의 네트워크 통신을 관리하는 역할을 합니다. 서비스 연결 문제는 애플리케이션이 외부나 내부와 통신하지 못하게 할 수 있습니다.

2.1 서비스와 파드 연결 확인

서비스가 올바르게 설정되어 있는지 확인하는 것이 중요합니다. kubectl get endpoints 명령어로 서비스가 올바른 파드를 가리키고 있는지 확인할 수 있습니다.

kubectl get endpoints <service-name>

이 명령어는 서비스가 연결된 엔드포인트 목록을 제공합니다.

2.2 서비스 DNS 문제 확인

서비스의 DNS가 올바르게 작동하는지 확인해야 합니다. kubectl exec 명령어를 사용하여 파드에서 DNS를 테스트할 수 있습니다.

kubectl exec -it <pod-name> -- nslookup <service-name>

이 명령어는 파드 내에서 DNS 조회를 수행하여 DNS 문제를 진단하는 데 도움을 줍니다.

3. 노드(Node) 상태 문제

쿠버네티스 클러스터의 노드 상태에 문제가 생기면 전체 시스템의 안정성이 저하될 수 있습니다.

3.1 노드 상태 확인

노드의 상태를 확인하여 문제가 있는지 확인합니다. kubectl get nodes 명령어를 사용하여 노드의 상태를 확인할 수 있습니다.

kubectl get nodes

이 명령어는 각 노드의 상태를 보여주며, Ready 상태가 아닌 노드를 쉽게 식별할 수 있습니다.

3.2 노드 로그 확인

문제가 있는 노드의 로그를 확인하여 보다 상세한 정보를 얻을 수 있습니다. 각 노드에 접근하여 시스템 로그를 확인해야 합니다.

4. 네트워킹 문제

쿠버네티스에서 네트워킹은 복잡한 주제이지만, 몇 가지 기본적인 확인 사항을 통해 문제를 진단할 수 있습니다.

4.1 네트워크 정책 확인

네트워크 정책이 올바르게 설정되어 있는지 확인합니다. kubectl get networkpolicy 명령어로 네트워크 정책을 확인할 수 있습니다.

kubectl get networkpolicy

이 명령어는 적용된 네트워크 정책 목록을 보여줍니다.

4.2 네트워크 플러그인 확인

쿠버네티스는 다양한 네트워크 플러그인을 지원합니다. 각 플러그인의 설정이나 상태를 확인하여 문제가 없는지 점검해야 합니다.

5. 스케줄링 문제

파드가 예상대로 스케줄되지 않는 경우, 스케줄러의 문제를 점검해야 합니다.

5.1 자원 요청 및 한계 확인

파드가 노드에 스케줄되지 않는 이유는 자원이 부족할 수 있습니다. 파드의 자원 요청 및 한계를 확인합니다.

resources:
  requests:
    memory: "64Mi"
    cpu: "250m"
  limits:
    memory: "128Mi"
    cpu: "500m"

이 설정은 파드의 자원 요청 및 한계를 정의하며, 이를 통해 올바른 노드에 스케줄될 수 있도록 조정할 수 있습니다.

6. 결론

쿠버네티스 트러블슈팅은 복잡할 수 있지만, 기본적인 진단 절차를 통해 문제를 해결할 수 있습니다. 로그, 이벤트, 자원 설정 등을 체계적으로 점검하여 문제의 원인을 파악하고 해결할 수 있습니다. 각 문제 상황에 맞는 적절한 명령어와 방법을 숙지하여 빠르게 문제를 해결하는 것이 중요합니다.