배포 문제

Ncloud Kubernetes Service를 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 문제별 원인과 해결 방법을 확인하고 적절하게 조치해 주십시오.

파드 생성 시 ImagePullBackOff 상태 발생

파드 생성 시 ImagePullBackOff 상태가 발생합니다.

원인

imagePullBackOff 상태는 파드가 사용할 이미지를 가져오지 못했을 때 발생합니다. 세부 원인을 파악해야 합니다.

해결 방법

• 이미지명 및 태그가 잘못된 경우, 이미지를 가져올 수 없습니다. 이미지명 및 태그를 확인해 주십시오.
• 프라이빗 레지스트리에서 이미지를 받아오는 경우, 인증을 진행하지 못할 때 이미지를 가져올 수 없습니다. 정확한 imagePullSecrets을 사용했는지 확인해 주십시오. Container Registry 서비스를 사용하는 경우에는 Container Registry 정보 확인 및 관리를 참조하여 imagePullSecrets을 생성해 주십시오.
• DockerHub 이미지 다운로드 정책에 의해 제한되었을 경우, 이미지를 정상적으로 이용할 수 없습니다. 유료 구독 모델을 사용하거나 프라이빗 레지스트리를 이용해 주십시오.
• Private Subnet을 사용하는 Kubernetes Cluster의 경우, 외부 이미지를 사용하기 위해 아웃바운드 트래픽이 활성화되어 있어야 합니다. 아웃바운드 트래픽을 활성화하는 방법은 다음과 같습니다.
  • NAT Gateway (Old)
    1. 네이버 클라우드 플랫폼의 콘솔에서 Services > Networking > VPC > NAT Gateway(Old) 메뉴를 차례대로 클릭해 주십시오.
    2. NAT Gateway를 생성해 주십시오.
    3. 네이버 클라우드 플랫폼의 콘솔에서 Services > Networking > VPC > Route Table 메뉴를 차례대로 클릭해 주십시오.
    4. 인터넷 통신이 필요한 Private Subnet의 라우트 테이블을 선택하고, [Routes 설정] 버튼을 클릭해 주십시오.
    5. 외부 통신을 위한 라우트 규칙을 추가해 주십시오.
       • Destination: 목적지 공인 IP 주소를 CIDR 형태로 입력 (예를 들어 인터넷 전체가 통신 대상이라면 0.0.0.0/0으로 입력)
       • Target Type: 목적지와 통신하기 위한 다음 Hop 타입을 선택 (NAT Gateway)
       • Target Name: 생성한 NAT Gateway 이름을 선택
    6. [생성] 버튼을 클릭해 주십시오.
  • NAT Gateway (New)
    1. 네이버 클라우드 플랫폼의 콘솔에서 Services > Networking > VPC > NAT Gateway(New) 메뉴를 차례대로 클릭해 주십시오.
    2. 공인 NAT Gateway를 생성해 주십시오.
    3. 네이버 클라우드 플랫폼의 콘솔에서 Services > Networking > VPC > Route Table 메뉴를 차례대로 클릭해 주십시오.
    4. NAT Gateway를 통해 통신할 네트워크 경로를 설정해 주십시오.
       • Route Table 설정 가이드 참조

특정 파드에서 간헐적으로 DNS 조회 실패 및 작업 지연

특정 파드에서 간헐적으로 DNS 조회에 실패하거나 작업 시간이 오래 소요됩니다.

원인

해당 파드에서 사용하는 이미지에 문제가 있을 때 발생합니다.

해결 방법

DNS 조회에 실패하거나 쿼리 처리에 문제가 있는 경우, 해당 파드가 사용하는 이미지를 확인해 주십시오.

• Alpine Linux에 기반한 컨테이너 이미지
  • dnsConfig 적용하여 해결

  spec:
  ...
    dnsConfig:
      options:
      - name: single-request-reopen
  

• BusyBox에 기반한 컨테이너 이미지
  • busybox 1.28 기반의 이미지 사용을 통해 해결

위와 같은 이미지를 사용하는 경우, DNS 쿼리 처리 시 문제가 발생할 수 있습니다. 이미지 내부 이슈라면 네이버 클라우드 플랫폼에서 해결할 수 없으므로 다른 컨테이너 이미지를 사용하거나 DNS 설정을 수정해 주십시오.