아래 내용은 예제 레포지토리에서 직접 실행해 볼 수 있습니다.
bisect명령어는 이진탐색으로 문제가 처음 생긴 커밋이 어딘지 찾는 명령어입니다.
예를 들어서 현재 커밋에서 문제가 발생하고 있는데, 이게 어떤 커밋부터 있던 문제인지, 올바르게 동작하는 가장 최신의 커밋은 무엇인지 궁금하다고 해봅시다.
프로그램을 실행하면 다음과 같은 에러가 발생하고 있습니다.
ReferenceError: use is not defined
그리고 현재 커밋의 상황은 다음과 같습니다.
* e87d175 - (HEAD -> main) 이름이 J로 시작하는 사람만 불러와라
* d5dd426 - 나이가 30살 이상인 사람만 불러와라
* cd82e14 - 미국에 사는 사람들만 출력해라
* eb54cdb - README를 추가해라
* bf5a3c6 - First commit
그리고 First commit은 에러가 없는 곳이 자명하기 때문에, 현재 커밋과 First commit사이에
에러가 처음 발생한 커밋이 반드시 있습니다. 이를 탐색하기 위해 bisect
명령어를 실행합니다.
$ git bisect start
status: waiting for both good and bad commits
시작하면 위와 같이 good과 bad를 선택해야 한다고 나옵니다. 현재 에러가 발생하고 있으므로 bad입니다. 그래서 다음과 같이 실행합니다.
$ git bisect bad
status: waiting for good commit(s), bad commit known
이제 good을 지정해 줘야 합니다. First commit의 해시를 지정해 보겠습니다.
$ git bisect good bf5a3c6
Bisecting: 1 revision left to test after this (roughly 1 step)
[cd82e14fe34b396884f6a5a9ba9e5cf29df4608c] 미국에 사는 사람들만 출력해라
그러면 이진 탐색을 시작하고, 최대 1 스텝이 남았다고 출력됩니다. 그리고 지금 확인 중인 커밋이 무엇인지 출력되고 있습니다.
* e87d175 - (HEAD -> main) 이름이 J로 시작하는 사람만 불러와라 # Bad
* d5dd426 - 나이가 30살 이상인 사람만 불러와라
* cd82e14 - 미국에 사는 사람들만 출력해라 # <- 현재 위치
* eb54cdb - README를 추가해라
* bf5a3c6 - First commit # Good
만약 현재 위치에서도 에러가 발생한다면 그 아래의 커밋도 잘못되었는지 확인해야 합니다. 만약 정상적으로 실행된다면 그 위의 커밋에서 잘못되었는지 확인해야 합니다.
코드를 실행해서 확인해 보니 문제가 없다고 가정해 보겠습니다. 그러면 good 커밋이겠죠?
$ git bisect good
Bisecting: 0 revisions left to test after this (roughly 0 steps)
[d5dd426b79b7e2fc45415aff341ea80bc7b7e7fa] 나이가 30살 이상인 사람만 불러와라
* e87d175 - (HEAD -> main) 이름이 J로 시작하는 사람만 불러와라 # Bad
* d5dd426 - 나이가 30살 이상인 사람만 불러와라 # <- 현재 위치
* cd82e14 - 미국에 사는 사람들만 출력해라 # Good
* eb54cdb - README를 추가해라 # 얘도 자동으로 Good으로 가정합니다.
* bf5a3c6 - First commit # Good
그러면 아래는 이제 검사할 필요가 없이 위의 커밋만 검사하면 됩니다. 이제 현재 커밋을 검사했을 경우 문제가 없다면 가장 위의 커밋이 처음 에러가 발생한 곳이고, 문제가 있다면 현재 커밋이 처음 에러가 발생한 곳입니다.
코드를 실행해보니 에러가 발생하네요. 그럼 이 커밋은 bad 커밋입니다.
$ git bisect bad
d5dd426b79b7e2fc45415aff341ea80bc7b7e7fa is the first bad commit
commit d5dd426b79b7e2fc45415aff341ea80bc7b7e7fa
Author: Username <user@gmail.com>
Date: Wed Sep 25 20:00:59 2024 +0900
나이가 30살 이상인 사람만 불러와라
app.js | 5 +++--
1 file changed, 3 insertions(+), 2 deletions(-)
이제 이진 탐색이 모두 끝났고 처음 문제가 발생한 커밋을 찾았습니다. 이런 식으로 반씩 나눠가며 문제가 발생한 곳을 훨씬 빠르게 찾을 수 있었습니다.
이제 초기화 명령어를 실행해서 마무리합니다. 이진 탐색 중간에라도 멈추고 싶다면, 초기화 명령어를 실행하면 됩니다.
$ git bisect reset
Previous HEAD position was d5dd426 나이가 30살 이상인 사람만 불러와라
Switched to branch 'main'
위의 과정에서 오류가 없는지 명령어를 실행해서 확인하고 있습니다. 제가 작성한
예제는 Node.js로 작성한 간단한 코드라서 node app.js로 실행해서 에러가 있으면
bad, 없으면 good으로 표기해서 에러를 찾고 있습니다. git bisect 명령어에는 이
과정을 스크립트로 자동화할 수 있습니다.
git bisect start # bisect 시작
git bisect bad # 현재 커밋을 에러나는 커밋으로 지정
git bisect good bf5a3c6 # bf5a3c6 에러안나는 커밋으로 지정
git bisect run node app.js # 각 커밋에서 해당 스크립트를 실행해 에러가 나면 bad, 안나면 good으로 자동 실행
git bisect reset # 초기화
자바스크립트로 직접 만들면서 배우는 - 자료구조와 알고리즘 강의 바로 가기
실습으로 마스터하는 OAuth 2.0: 기본부터 보안 위험까지 - OAuth 2.0 강의 바로 가기
기계인간 이종립, 소프트웨어 개발의 지혜 - Git 강의 바로 가기
코드숨에서 매주 스터디를 진행하고 있습니다. 메일을 등록하시면 새로운 스터디가 시작될 때 알려드릴게요!