SourceCommit 문제 해결

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

"The requested URL returned error: 403" 오류 메시지

"The requested URL returned error: 403" 오류 메시지가 표시됩니다.

원인

자격 증명이 발급되지 않았거나, 인증 정보가 유효하지 않은 경우에 발생합니다.

해결 방법

Git 클라이언트 사용을 참조하여 접속 방법(HTTPS/SSH)에 맞는 자격 증명을 발급하거나 인증 정보를 다시 확인해 주십시오.

외부 리포지토리 복사 불가

외부 리포지토리를 복사하기 위해 Github URL과 ID, 비밀번호를 정확하게 입력했는데 오류가 발생합니다.

원인

Github에서 Password를 통한 인증을 허용하지 않습니다. Token 방식으로만 인증할 수 있습니다.

해결 방법

Github의 경우, 외부 리포지토리 복사 시 ID와 비밀번호가 아닌 ID와 Token 값을 입력해야 합니다. https://github.com/settings/tokens를 참조하여 토큰을 생성하고 관련 권한(Contents)을 확인해 주십시오.

대용량 프로젝트 업로드 시 오류

용량이 큰 프로젝트를 업로드하면 오류가 발생합니다.

원인

Git 리포지토리에 업로드할 수 있는 파일 용량은 최대 500MB로 제한됩니다.

해결 방법

• Git LFS(Large File System)를 활용해 주십시오. Git LFS는 대용량 파일에 대한 메타데이터(metadata)만 리포지토리에 커밋하고 실제 파일 내용은 별도의 원격 저장소에 저장하는 방식으로 작동합니다. 자세한 설명은 대용량 파일 업로드를 참조해 주십시오.
• 모든 파일을 한 번에 커밋하지 않고 작은 단위로 나누어 커밋하고 푸시하는 방식을 이용해 주십시오.

Permission 오류

Permission 오류가 발생합니다.
"Permission denied (publickey)." 오류 메시지가 표시됩니다.

원인

SSH 키 설정이 올바르지 않을 경우 발생하는 문제입니다.

해결 방법

• SourceCommit 서비스에 등록한 퍼블릭 키와 config 내의 IdentityFile이 일치하는지 확인해 주십시오.
• GIT SSH 접속 설정이 올바른지 점검해 주십시오.

Git 계정 재설정 후 403 오류 발생

Git 계정을 재설정한 후 git clone 실행 시 403 오류가 발생합니다.

원인

기존 인증 정보가 남아 있을 경우, 해당 문제가 발생할 수 있습니다.

해결 방법

Git 설정 범위에 따라 git config 내 인증 정보(credential.helper)를 초기화하는 방법은 다음과 같습니다.

• 현재 GIT 프로젝트 설정 초기화

  git config --local --unset credential.helper
  

• 로그인한 사용자 설정 초기화

  git config --global --unset credential.helper
  

• 시스템 설정 초기화

  git config --system --unset credential.helper
  

둘러볼 콘텐츠

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

• 네이버 클라우드 플랫폼 블로그: Kubernetes 클러스터에 애플리케이션 배포하기  - 네이버 클라우드 플랫폼 Developer Tools (개발자 도구) 활용 실습
• API 가이드: SouceCommit API 가이드