[트러블 슈팅] Jenkins Git Clone 실패: fatal: not in a git directory 해결법

 

🧩 문제 상황

Jenkins에서 GitHub 저장소를 체크아웃하는 첫 스텝에서 아래와 같은 에러 발생

• The recommended git tool is: NONE → Git 설치 문제는 아님 (이미 해결)
• 자격 증명도 정상 연결됨 (using credential)
• Git 저장소는 public이거나 token 등록도 정상

그런데도 계속 clone 실패.

---

🔍 원인

Jenkins의 workspace 디렉토리에 이전 빌드 실패로 인한 .git 디렉토리 손상이 남아 있었음.

즉:

• Jenkins는 이미 clone 되어 있다고 착각하고
• fetch, config 등의 git 명령을 실행했지만
• .git 폴더가 없으니 실패한 것

---

✅ 해결 방법

docker exec -it -u root jenkins-container bash
cd /var/jenkins_home/workspace
rm -rf "Fitnut - API Server"
exit

 

workspace 안의 해당 Job 디렉토리를 강제 삭제하고, Jenkins에서 빌드를 다시 시작하니 정상적으로 clone 성공.

---

💡 참고

• Jenkins UI에서 "Wipe Out Current Workspace" 메뉴를 눌러도 동일한 효과
• 간단한 문제지만, 에러 메시지가 애매해서 원인 파악 어려움
• Git 오류가 not in a git directory일 땐, .git 폴더 존재 여부부터 확인할 것

---

📌 결론

Git 관련 Jenkins 빌드 오류 중 .git 디렉토리 손상은 은근 자주 발생하는 이슈.
workspace 초기화로 간단하게 해결 가능!