[프로젝트] GitHub 저장소 클론 시 발생할 수 있는 오류와 해결 방법

GitHub 저장소 클론 시 발생할 수 있는 오류와 해결 방법

GitHub 저장소를 클론(clone)할 때 다양한 인증 관련 오류가 발생할 수 있습니다. 특히, Visual Studio Code 서버를 통해 SSH로 연결된 환경이나, 개인 액세스 토큰(PAT)을 사용하는 경우라면 조금 더 복잡한 문제가 발생할 수 있습니다. 이번 포스팅에서는 fatal: cannot run .../askpass.sh: No such file or directory 오류와 같은 오류를 해결하는 방법을 설명합니다.

 

오류 상황

fatal: cannot run /root/.vscode-server/cli/servers/.../server/extensions/git/dist/askpass.sh: No such file or directory

이 오류는 Git이 인증 과정에서 필요한 askpass.sh 파일을 찾지 못할 때 발생합니다. 이는 Visual Studio Code 서버 환경에서 SSH를 통해 GitHub 저장소에 접근할 때 자주 발생합니다. 아래에서는 이 문제를 해결할 몇 가지 방법을 설명합니다.

 

해결 방법

방법 1: GIT_ASKPASS 환경 변수를 통해 인증 비활성화

Git이 askpass.sh 파일을 찾지 못하는 경우, 이를 우회하여 클론을 시도할 수 있습니다. 환경 변수 GIT_ASKPASS를 echo로 설정해 인증 프롬프트 없이 진행하도록 합니다.

GIT_ASKPASS=echo git clone https://github.com/boostcampaitech7/level2-cv-semanticsegmentation-cv-15-lv3.git

 

방법 2: 개인 액세스 토큰(PAT) 사용

비공개 저장소에 접근할 때는 GitHub에서 발급받은 개인 액세스 토큰(PAT)을 사용할 수 있습니다. 개인 토큰을 URL에 포함하면 비밀번호 대신 인증이 가능합니다.

1. GitHub에서 개인 액세스 토큰(PAT) 생성

• GitHub 프로필 → Settings → Developer settings → Personal access tokens로 이동합니다.
• 새 토큰을 발급하고 권한을 설정합니다.

2. 토큰을 사용해 클론하기

토큰을 포함한 URL로 클론 명령어를 입력합니다. 아래 예시에서 YOUR_TOKEN을 발급받은 토큰으로 교체하세요.

git clone https://YOUR_TOKEN@github.com/boostcampaitech7/level2-cv-semanticsegmentation-cv-15-lv3.git

 

방법 3: SSH 방식을 사용한 클론

HTTPS 인증 대신 SSH 방식을 통해 클론하면, 인증 관련 문제를 회피할 수 있습니다. 이 방법은 GitHub 계정에 SSH 키가 등록되어 있을 때만 가능합니다.

1. SSH 키 생성 및 GitHub에 등록

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

키가 생성되면 ~/.ssh/id_rsa.pub 파일에 저장됩니다. 이 파일의 내용을 GitHub 설정 → SSH and GPG keys에 등록합니다.

2. SSH 방식으로 클론

SSH 주소를 사용해 저장소를 클론합니다.

git clone git@github.com:boostcampaitech7/level2-cv-semanticsegmentation-cv-15-lv3.git

 

마무리

GitHub 저장소를 클론할 때 발생하는 인증 오류는 주로 인증 방식과 관련된 문제로, 다양한 해결책이 있습니다. 위의 방법 중 상황에 맞는 방법을 선택하여 적용하시면 됩니다. 개인 액세스 토큰이나 SSH 키를 사용하는 경우, 보안에 유의하고 필요 시 토큰을 재발급하는 것이 좋습니다.

위의 가이드를 참고하여 GitHub 저장소 클론 시 발생하는 오류를 해결하고, 더 원활한 개발 환경을 구축하시기 바랍니다.