Kubernetes 환경에서 Pod가 시작되지 않는 문제는 개발자와 운영 팀 모두에게 골칫거리로 작용할 수 있습니다. 많은 경우, 이 문제는 복잡한 원인으로 인해 발생할 수 있으며, 이를 파악하고 해결하는 과정은 특히 중요합니다. 이번 포스트에서는 Pod가 시작되지 않는 일반적인 원인과 그 해결 방법을 구체적으로 살펴보겠습니다.

1. Pod 상태 확인

Pod가 시작되지 않을 때, 가장 먼저 확인해야 할 것은 Pod의 상태입니다. Kubernetes에서는 kubectl CLI를 사용하여 Pod의 상태를 확인할 수 있습니다.

kubectl get pods

위 명령어를 실행하면, 각 Pod의 상태와 관련된 정보를 확인할 수 있습니다. 상태가 CrashLoopBackOff, ImagePullBackOff 등의 메시지를 보인다면, 각각의 원인을 분석해야 합니다.

2. 자원 부족

Pod가 시작되지 않는 일반적인 원인 중 하나는 클러스터 내의 자원이 부족한 경우입니다. Pod가 요청한 CPU나 메모리가 클러스터에서 사용 가능한 자원을 초과할 때 발생합니다. 이 경우 다음과 같이 자원 사용량을 확인해야 합니다.

kubectl describe node <node-name>

노드의 자원 사용량을 살펴보고, 필요한 경우 node의 자원을 추가하거나 파드를 다른 노드로 옮길 수 있습니다.

3. 이미지 가져오기 실패

Pod가 사용할 도커 이미지를 가져오는 데 실패하면 ImagePullBackOff 오류가 발생합니다. 이 문제는 다음의 여러 원인으로 인해 발생할 수 있습니다.

  • 잘못된 이미지 이름 또는 태그
  • 저장소 접근 권한 문제
  • 네트워크 문제

이미지를 가져오는 데 문제가 있는 경우, 다음과 같이 로그를 확인해 볼 수 있습니다.

kubectl describe pod <pod-name>
Events 섹션에서 이미지 관련 오류 메시지를 확인할 수 있습니다. 만약 잘못된 이미지 이름이라면, Deployment 또는 Pod 파일을 수정하여 올바른 이미지 이름을 입력합니다. 
apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
spec:
  replicas: 3
  template:
    spec:
      containers:
        - name: my-app-container
          image: myregistry/my-app:latest  # 올바른 이미지 이름

4. livenessProbe 및 readinessProbe 실패

Kubernetes에서는 Pod의 상태를 모니터링하기 위해 livenessProbe와 readinessProbe를 설정할 수 있습니다. 이 두 프로브가 실패할 경우 Pod가 시작되지 않거나 요청을 처리하지 않게 됩니다. 이를 확인하기 위해, kubectl describe pod <pod-name> 명령어를 사용하여 프로브 설정 및 상태를 살펴봅니다.

예를 들어, livenessProbe가 HTTP GET 요청을 통해 확인하는 경우, 해당 경로가 올바르게 작동하는지 확인해야 합니다.

livenessProbe:
  httpGet:
    path: /health
    port: 8080
  initialDelaySeconds: 30
  periodSeconds: 10

이 경로가 잘못되었거나 서비스가 제대로 작동하지 않는다면, 프로브 설정을 수정하거나 애플리케이션 코드를 점검해야 합니다.

5. 네트워크 문제

Kubernetes 클러스터 내의 네트워크 문제 또한 Pod가 정상적으로 시작되지 않는 원인이 될 수 있습니다. 특정 Pod가 다른 서비스와 통신하는 데 문제가 있을 때, DNS 설정이 잘못되었거나 네트워크 정책이 적용된 경우가 있습니다. 이를 확인하기 위해, 다음과 같이 DNS 상태를 점검해 보세요.

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

위 명령어를 통해 해당 서비스의 DNS가 제대로 작동하는지 확인할 수 있습니다. 문제가 발생한다면, CoreDNS 설정을 점검하거나 네트워크 정책을 수정해야 할 수 있습니다.

6. 컨테이너 로그 확인

마지막으로 Pod가 시작되지 않는 원인을 분석하기 위해 컨테이너 로그를 확인하는 것이 중요합니다. 다음 명령어로 로그를 확인할 수 있습니다.

kubectl logs <pod-name>

로그에서 애플리케이션이 시작되지 않는 이유를 알 수 있는 유용한 메시지를 찾을 수 있습니다. 예를 들어, 애플리케이션의 환경 변수 설정이 잘못되었거나 필수 파일이 누락된 경우, 로그에서 이러한 정보를 얻을 수 있습니다.

마무리

Kubernetes에서 Pod가 시작되지 않는 문제는 다양한 원인으로 발생할 수 있으며, 이를 해결하기 위해서는 각 상태를 꼼꼼히 점검하는 것이 필요합니다. 자원 확인, 이미지 설정, 프로브 설정, 네트워크 문제, 로그 확인 등을 통해 문제를 진단하고 해결할 수 있습니다. 이러한 과정을 통해 Kubernetes 클러스터의 안정성과 효율성을 높일 수 있습니다.