---
title: "SourceBuild 문제 해결"
slug: "sourcebuild-troubleshoot"
updated: 2026-08-20T09:03:30Z
published: 2026-08-20T09:03:30Z
canonical: "guide-gov.ncloud-docs.com/sourcebuild-troubleshoot"
---

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

# SourceBuild 문제 해결

Classic/VPC 환경에서 이용 가능합니다.

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

## 빌드 결과물 업로드 시 오류

빌드는 성공했으나 빌드 결과물 업로드 시 오류가 발생합니다.

#### 원인

빌드 결과물의 경로가 잘못 설정되었을 경우, 오류가 발생할 수 있습니다.

#### 해결 방법

- 빌드 결과물이 저장될 디렉터리 경로 또는 파일 경로가 정확한지 확인해 주십시오.
- **빌드 후 명령어** 기능을 사용하여 `/build` 디렉터리가 정상적으로 생성되어 있는지 확인해 주십시오.

## 빌드 환경 이미지 퍼블릭 레지스트리 사용 시 Docker Rate Limit 오류

빌드 환경 이미지 퍼블릭 레지스트리 사용 시 "Docker Rate Limit" 오류가 발생합니다.

#### 원인

퍼블릭 레지스트리 사용 시 Docker Hub를 통해 이미지를 가져오는데, 다수의 사용자가 이용하는 서비스이므로 Rate Limit이 발생할 수 있습니다. Docker Hub에서는 과도한 이미지 pull 사용을 제한하기 위해 일정 시간 동안 일정 횟수만큼만 이미지를 pull할 수 있도록 제한하고 있으며([Docker Hub pull usage and limits](https://docs.docker.com/docker-hub/usage/pulls) 참조), 관련 정책에 따라 Docker에서 제한을 두기 때문에 구체적인 제한 기준이나 해제 조건은 안내할 수 없습니다.

#### 해결 방법

Docker Hub의 Rate Limit 없이 빌드를 수행하려면 사용할 이미지를 [Container Registry](https://www.gov-ncloud.com/product/containers/containerRegistry)에 직접 업로드한 후 해당 이미지를 빌드 환경 이미지로 사용하는 것을 권장합니다.

해결 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서  **Menu** > **All Services** > **Container** > **Container Registry** 메뉴를 차례대로 클릭해 주십시오.
2. [Container Registry 정보 확인 및 관리](/docs/container-ncr-1-3)를 참조하여 사용할 이미지를 Container Registry 레지스트리에 업로드해 주십시오.
3. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Developer Tools** > **SourceBuild** 메뉴를 차례대로 클릭해 주십시오.
4. 설정을 변경할 프로젝트를 선택한 후 **[설정 변경]** 버튼을 클릭해 주십시오.
5. **빌드 프로젝트 설정** 화면이 나타나면 **빌드 환경 이미지**의 **Container Registry의 이미지**를 선택해 주십시오.
6. 레지스트리에 업로드한 이미지로 변경한 후 **[적용]** 버튼을 클릭해 주십시오.

## 도커 빌드 사용 시 Docker Rate Limit 오류

도커 빌드 사용 시 "Docker Rate Limit" 오류가 발생합니다.

#### 원인

Dockerfile 내 FROM 절에 사용되는 베이스 이미지를 Docker Hub를 통해 가져오는데, 다수의 사용자가 이용하는 서비스이므로 Rate Limit이 발생할 수 있습니다. Docker Hub에서는 과도한 이미지 pull 사용을 제한하기 위해 일정 시간 동안 일정 횟수만큼만 이미지를 pull할 수 있도록 제한하고 있습니다([Docker Hub pull usage and limits](https://docs.docker.com/docker-hub/usage/pulls) 참조).

#### 해결 방법

Docker Hub의 Rate Limit 없이 빌드를 수행하려면 사용할 이미지를 [Container Registry](https://www.gov-ncloud.com/product/containers/containerRegistry)에 직접 업로드한 후 해당 이미지를 빌드 환경 이미지로 사용하는 것을 권장합니다.

해결 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Container** > **Container Registry** 메뉴를 차례대로 클릭해 주십시오.
2. [Container Registry 정보 확인 및 관리](/docs/container-ncr-1-3)를 참조하여 Dockerfile 에 사용할 베이스 이미지를 Container Registry 레지스트리에 업로드해 주십시오.
3. Dockerfile의 베이스이미지가 Container Registry 에 업로드한 이미지를 사용하도록 FROM 절을 수정하여 반영해주십시오.

              참고

              

이미지 다운로드(Pull) 시 별도의 인증 과정 없이 누구나 다운로드할 수 있도록 설정하려면 [Public Registry 활성화](/docs/container-ncr-1-3#%ED%8D%BC%EB%B8%94%EB%A6%AD%EB%A0%88%EC%A7%80%EC%8A%A4%ED%8A%B8%EB%A6%AC%ED%99%9C%EC%84%B1%EB%B9%84%ED%99%9C%EC%84%B1%ED%99%94)를 참조해 주십시오.

## 둘러볼 콘텐츠

네이버 클라우드 플랫폼에서는 고객에게 도움을 주기 위해 다양한 방식으로 정보를 제공하고 있습니다. SourceBuild 서비스 이용 시 활용할 수 있는 유용한 콘텐츠를 안내합니다.

- 자주 하는 질문: [SourceBuild 자주 하는 질문](https://www.gov-ncloud.com/support/faq/prod?categoryCode2=DEVTL&categoryCode3=SV_0107&page=1)
- 네이버 클라우드 플랫폼 블로그: [SourceDeploy & SourceBuild - Github Enterprise Server 연동 기능 제공](https://blog.naver.com/n_cloudplatform/223272473873?trackingCode=blog_bloghome_searchlist)
- 네이버 클라우드 플랫폼 블로그: [Kubernetes 클러스터에 애플리케이션 배포하기 - 네이버 클라우드 플랫폼 Developer Tools (개발자 도구) 활용 실습](https://blog.naver.com/n_cloudplatform/223209131446?trackingCode=blog_bloghome_searchlist)
- API 가이드: [SouceBuild API 가이드](https://api-gov.ncloud-docs.com/docs/devtools-sourcebuild)

              참고

              

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