SourceBuild 문제 해결

Prev Next

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

빌드 결과물 업로드 시 오류

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

원인

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

해결 방법

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

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

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

원인

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

해결 방법

Docker Hub의 Rate Limit 없이 빌드를 수행하려면 사용할 이미지를 Container Registry에 직접 업로드한 후 해당 이미지를 빌드 환경 이미지로 사용하는 것을 권장합니다.

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

  1. 네이버 클라우드 플랫폼 콘솔에서 Services > Container > Container Registry 메뉴를 차례대로 클릭해 주십시오.
  2. Container Registry 정보 확인 및 관리를 참조하여 사용할 이미지를 Container Registry 레지스트리에 업로드해 주십시오.
  3. 네이버 클라우드 플랫폼 콘솔에서 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 참조).

해결 방법

Docker Hub의 Rate Limit 없이 빌드를 수행하려면 사용할 이미지를 Container Registry에 직접 업로드한 후 해당 이미지를 빌드 환경 이미지로 사용하는 것을 권장합니다.

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

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

이미지 다운로드(Pull) 시 별도의 인증 과정 없이 누구나 다운로드할 수 있도록 설정하려면 Public Registry 활성화를 참조해 주십시오.

둘러볼 콘텐츠

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

참고

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