---
title: "배포 문제"
slug: "k8s-troubleshoot-deploying"
updated: 2026-07-23T09:02:32Z
published: 2026-07-23T09:02:32Z
canonical: "guide-fin.ncloud-docs.com/k8s-troubleshoot-deploying"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 배포 문제

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

## 파드 생성 시 ImagePullBackOff 상태 발생

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

#### 원인

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

#### 해결 방법

- 이미지명 및 태그가 잘못된 경우, 이미지를 가져올 수 없습니다. 이미지명 및 태그를 확인해 주십시오.
- 프라이빗 레지스트리에서 이미지를 받아오는 경우, 인증을 진행하지 못할 때 이미지를 가져올 수 없습니다. 정확한 `imagePullSecrets`을 사용했는지 확인해 주십시오. Container Registry 서비스를 사용하는 경우에는 [Container Registry 정보 확인 및 관리](/docs/container-ncr-1-3)를 참조하여 `imagePullSecrets`을 생성해 주십시오.
- DockerHub [이미지 다운로드 정책](https://docs.docker.com/docker-hub/download-rate-limit/)에 의해 제한되었을 경우, 이미지를 정상적으로 이용할 수 없습니다. 유료 구독 모델을 사용하거나 프라이빗 레지스트리를 이용해 주십시오.
- Private Subnet을 사용하는 Kubernetes Cluster의 경우, 외부 이미지를 사용하기 위해 아웃바운드 트래픽이 활성화되어 있어야 합니다. 아웃바운드 트래픽을 활성화하는 방법은 다음과 같습니다.
  - NAT Gateway (Old)
    1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Networking** > **VPC** > **NAT Gateway(Old)** 메뉴를 차례대로 클릭해 주십시오.
    2. NAT Gateway를 생성해 주십시오.
    3. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All 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. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Networking** > **VPC** > **NAT Gateway(New)** 메뉴를 차례대로 클릭해 주십시오.
    2. 공인 NAT Gateway를 생성해 주십시오.
    3. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Networking** > **VPC** > **Route Table** 메뉴를 차례대로 클릭해 주십시오.
    4. NAT Gateway를 통해 통신할 네트워크 경로를 설정해 주십시오.
      - [Route Table 설정 가이드](/docs/networking-vpc-vpcdetailedroutetable) 참조

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

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

#### 원인

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

#### 해결 방법

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

- [Alpine Linux에 기반한 컨테이너 이미지](https://github.com/kubernetes/kubernetes/issues/56903)

```
spec:
...
  dnsConfig:
    options:
    - name: single-request-reopen
```
  - [dnsConfig](https://kubernetes.io/ko/docs/concepts/services-networking/dns-pod-service/#pod-dns-config) 적용하여 해결
- [BusyBox에 기반한 컨테이너 이미지](https://github.com/kubernetes/kubernetes/issues/66924)
  - busybox 1.28 기반의 이미지 사용을 통해 해결

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

              참고

              

이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다.