에러 상황
git clone {레포지토리 URL}
github에서 운영중인 private 레포지토리 코드를 clone 받으려는 상황. 아래와 같은 에러 발생
Cloning into '{레포지토리명}'...
remote: Repository not found.
fatal: repository '{레포지토리 URL}' not found
에러 코드를 읽어보면 해당 레포지토리를 찾지 못한다는 내용입니다. 하지만 보통 이런 경우 레포지토리 URL이 잘못된 경우는 많지 않습니다. 다른 이유가 더 일반적입니다. 그 이유는 바로 해당 레포지토리가 private이기 때문에 접근 권한이 없어 발생하는 에러입니다.
해결 방법
1. Github 퍼스널 토큰 발급
github 퍼스널 토근을 발급하기 위해서는 github 접속 시 우측 상단에 위치한 자신의 프로필 이미지를 클릭해 사이드 메뉴를 확인합니다. 사이드 메뉴에서 'Settings' 탭을 클릭합니다.
Settings 탭에서 왼쪽 최하단에 있는 'Developer settings' 탭을 클릭합니다.
Developer settings 탭에서 Personal access tokens 탭을 통해 private 레포지토리에 접근할 수 있게 도와주는 퍼스널 토큰 발급이 가능합니다. 위 사진과 같이 현재 토큰 방식에는 2 가지 방식이 존재합니다. 두 종류에 큰 차이는 없습니다. 원하는 방식을 선택해 안내를 따라 퍼스널 토큰 발급을 마무리 합니다.
⚠️ 퍼스널 토큰 저장해놓기
퍼스널 토큰은 발급 이후 다시 조회할 수 없습니다. 만약 퍼스널 토큰을 분실하셨을 시 재발급 밖에 방법이 없습니다. 이 때문에 퍼스널 토큰을 발급받은 뒤 계속 재사용하기 위해서는 해당 토큰을 개인적으로 보관하셔야 합니다.
2. git clone 시 유저명과 퍼스널 토큰 입력
public 레포지토리는 다음과 같은 방식으로 단순하게 클론 가능합니다.
git clone {레포지토리 URL}
하지만 private 레포지토리는 다음과 같이 clone하셔야합니다. 더 자세히 설명드리자면 기존 레포지토리 URL에서 'https://' 와 'github.com' 사이에 방금 퍼스널 토큰을 발급받은 github 계정의 유저명과 '@' 문자를 넣어주는 것입니다.
❗️public repository
git clone https://github.com/SHINDongHyeo/test.git
✅ private repository
git clone https://SHINDongHyeo@github.com/SHINDongHyeo/test.git그럼 아래와 같이 퍼스널 토큰을 입력하라는 안내가 표시됩니다.
Cloning into 'test'...
Password for 'https://SHINDongHyeo@github.com': 🔑 여기에 퍼스널 토큰값 입력
퍼스널 토큰까지 입력해주면 성공적으로 레포지토리가 clone 되는 모습을 확인할 수 있습니다.