버전 관리
시간에 따라 변하는 무언가를 작업할 때는 그 변화를 추적할 수 있으면 유용합니다. 이유는 여러 가지입니다. 무엇이 바뀌었는지, 어떻게 되돌릴 수 있는지, 누가 바꾸었는지, 어쩌면 왜 바꾸었는지까지 기록으로 남길 수 있습니다. 버전 관리 시스템(VCS)은 이러한 기능을 제공합니다. 파일 모음의 변경 사항을 설명하는 메시지와 함께 커밋할 수 있고, 과거에 했던 변경을 살펴보거나 되돌릴 수도 있습니다.
대부분의 VCS는 여러 사용자 사이에 커밋 기록을 공유하는 기능을 지원합니다. 덕분에 편리하게 협업할 수 있습니다. 여러분은 제가 한 변경을 볼 수 있고, 저는 여러분이 한 변경을 볼 수 있습니다. 또한 VCS는 변경 사항을 추적하므로, 서로 비교적 겹치지 않는 부분을 건드렸다면 대체로 (항상은 아니지만) 변경 사항을 합치는 방법도 알아낼 수 있습니다.
VCS는 아주 많으며, 지원하는 기능, 동작 방식, 상호작용 방식도 크게 다릅니다. 여기서는 더 널리 쓰이는 것 중 하나인 git에 집중하겠지만, Mercurial도 살펴보기를 권합니다.
그럼 이제 CliffNotes로!
git은 흑마법일까요?
꼭 그렇지는 않습니다.. 데이터 모델을 이해해야 합니다. 몇몇 세부 사항은 건너뛰겠지만, 대략적으로 말하면 git의 핵심 “대상”은 커밋입니다.
- 모든 커밋에는 “리비전 해시”라는 고유한 이름이 있습니다.
998622294a6c520db718867354bf98348ae3c7e2같은 긴 해시이며, 짧은 (어느 정도 고유한) 접두사로 줄여 쓰는 경우가 많습니다:9986222 - 커밋에는 작성자와 커밋 메시지가 있습니다.
- 조상 커밋의 해시도 있습니다. 보통은 이전 커밋의 해시만 있습니다.
- 커밋은 차이도 나타냅니다. 이는 커밋의 조상에서 해당 커밋으로 어떻게 바뀌는지를 표현한 것입니다(예: 이 파일에서 이 줄을 지우고, 이 파일에 이 줄들을 추가하고, 저 파일의 이름을 바꾸는 등).
- 실제로 git은 변경 전후의 전체 상태를 저장합니다.
- 변경되는 대용량 파일은 저장하지 않는 편이 좋을 것입니다!
처음에는 저장소(대략 git이 관리하는 폴더)에 내용도 커밋도 없습니다. 이를 만들어 봅시다.
$ git init hackers
$ cd hackers
$ git status
이 출력은 사실 좋은 출발점이 됩니다. 자세히 살펴보면서 전부 이해했는지 확인해 봅시다.
먼저 “On branch master”입니다.
- 해시를 항상 사용하고 싶지는 않습니다.
- 브랜치는 해시를 가리키는 이름입니다.
- master는 전통적으로 “최신” 커밋을 가리키는 이름입니다. 새 커밋을 만들 때마다 master라는 이름은 새 커밋의 해시를 가리키게 됩니다.
- 특별한 이름
HEAD는 “현재” 이름을 가리킵니다. git branch(또는git tag)로 자신만의 이름을 만들 수도 있습니다. 이 내용은 나중에 다시 살펴보겠습니다.
“No commits yet”은 말 그대로이므로 건너뛰겠습니다.
다음은 “nothing to commit”입니다.
- 모든 커밋에는 여러분이 한 모든 변경 사항의 차이가 담겨 있습니다. 그런데 그 차이는 애초에 어떻게 만들어질까요?
- 마지막 커밋 이후에 한 모든 변경을 항상 커밋하는 방법도 가능합니다.
- 때로는 일부만 커밋하고 싶을 수 있습니다(예:
TODO는 제외). - 때로는 변경을 여러 커밋으로 나누어 각각 별도의 커밋 메시지를 쓰고 싶을 수 있습니다.
- 때로는 일부만 커밋하고 싶을 수 있습니다(예:
- git에서는 변경 사항을 스테이징해 커밋을 구성할 수 있습니다.
git add로 파일 하나 또는 여러 파일의 변경을 스테이징된 변경 사항에 추가합니다.git add -p로 파일의 일부 변경만 추가할 수 있습니다.- 인자가 없으면
git add는 “알려진 모든 파일”에 적용됩니다.
git rm으로 파일을 삭제하고 그 삭제를 스테이징합니다.git reset으로 스테이징된 변경 사항 모음을 비웁니다.- 이렇게 해도 파일은 바뀌지 않습니다! 커밋에 포함할 변경 사항이 없어진다는 뜻일 뿐입니다.
- 스테이징된 변경 중 일부만 제거하려면:
git reset FILE또는git reset -p
git diff --staged로 스테이징된 변경 사항을 확인합니다.git diff로 나머지 변경 사항을 봅니다.- 스테이징 상태가 마음에 들면
git commit으로 커밋을 만듭니다.- 모든 변경 사항을 커밋하고 싶다면:
git commit -a git help add에 유용한 정보가 훨씬 더 많이 있습니다.
- 모든 변경 사항을 커밋하고 싶다면:
위 내용을 시험해 보면서 git status를 실행해 git이 여러분이 무엇을 하고 있다고 생각하는지 확인해 보세요. 놀랄 만큼 도움이 됩니다!
커밋이라고요…
좋습니다. 커밋이 생겼습니다. 이제 무엇을 할까요?
- 최근 변경 사항을 볼 수 있습니다:
git log(또는git log --oneline). - 변경 사항 전체를 볼 수 있습니다:
git log -p. - 특정 커밋을 표시할 수 있습니다:
git show master.- 또는
-p로 전체 차이/패치를 볼 수 있습니다.
- 또는
git checkout NAME으로 특정 커밋의 상태로 돌아갈 수 있습니다.NAME이 커밋 해시라면 git은 우리가 “detached” 상태라고 말합니다. 이는 이 커밋을 가리키는NAME이 없다는 뜻일 뿐이며, 따라서 여기서 커밋을 만들면 아무도 그 커밋을 알지 못합니다.
git revert NAME으로 변경을 되돌릴 수 있습니다.NAME에 있는 커밋의 차이를 역으로 적용합니다.
git diff NAME..으로 이전 버전과 이 버전을 비교할 수 있습니다.a..b는 커밋 범위입니다. 어느 한쪽이 생략되면HEAD를 뜻합니다.
git log NAME..으로 그 사이의 모든 커밋을 표시할 수 있습니다.- 여기서도
-p가 동작합니다.
- 여기서도
git reset NAME으로master가 특정 커밋을 가리키게 할 수 있습니다(사실상 그 이후의 모든 것을 되돌립니다).- 어라, 왜 그럴까요?
reset은 스테이징된 변경 사항을 바꾸는 명령어 아니었나요? reset에는 주어진 이름이 가리키는 커밋으로HEAD를 설정하는 “두 번째” 형태가 있습니다(git help reset참고). - 파일은 전혀 바뀌지 않았다는 점에 주목하세요. 이제
git diff는 사실상git diff NAME..을 보여 줍니다.
- 어라, 왜 그럴까요?
이름에는 무엇이 담겨 있을까요?
이름은 분명 git에서 중요합니다. 또한 git에서 일어나는 많은 일을 이해하는 열쇠입니다. 지금까지 커밋 해시, master, HEAD를 살펴보았습니다. 하지만 더 있습니다!
git branch b로 (master와 같은) 자신만의 브랜치를 만들 수 있습니다.HEAD에 있는 커밋을 가리키는 새 이름b를 만듭니다.- 하지만 여전히 master “위에” 있으므로, 새 커밋을 만들면 master는 그 새 커밋을 가리키지만
b는 그렇지 않습니다. git checkout b로 브랜치를 전환합니다.- 이제 만드는 모든 커밋은
b라는 이름을 업데이트합니다. git checkout master로 master로 돌아갑니다.b에서 했던 모든 변경은 숨겨집니다.
- 변경 사항을 쉽게 시험해 볼 수 있는 매우 편리한 방법입니다.
- 이제 만드는 모든 커밋은
- 태그는 바뀌지 않는 또 다른 이름이며, 자체 메시지를 가집니다. 릴리스와 변경 기록을 표시하는 데 자주 사용합니다.
NAME^는 “NAME이전의 커밋”을 뜻합니다.-는 “이전 이름”을 뜻합니다.- 대부분의 명령어는 다른 인자를 주지 않으면
HEAD에 적용됩니다.
어질러 놓은 것 정리하기
커밋 기록은 매우 자주 다음과 같은 모습이 됩니다.
add feature x– 어쩌면x에 관한 커밋 메시지까지 있을지도 모릅니다!forgot to add filefix bugtypotypo2actually fixactually actually fixtests passfix example codetypoxxxx
git으로서는 괜찮지만, 미래의 여러분이나 무엇이 바뀌었는지 궁금한 다른 사람에게는 별로 도움이 되지 않습니다. git에서는 이런 것들을 정리할 수 있습니다.
git commit --amend: 스테이징된 변경 사항을 이전 커밋에 합칩니다.- 이전 커밋을 변경해 새 해시를 부여한다는 점에 주의하세요!
git rebase -i HEAD~13은 마법 같습니다. 지난 13개 커밋 각각에 대해 무엇을 할지 선택합니다.- 기본값은
pick입니다. 아무것도 하지 않습니다. r: 커밋 메시지를 변경합니다.e: 커밋을 변경합니다(파일을 추가하거나 제거합니다).s: 이전 커밋과 합치고 커밋 메시지를 편집합니다.f: “fixup” – 이전 커밋과 합치고 커밋 메시지는 버립니다.- 마지막에는
HEAD가 이제 마지막 커밋이 된 커밋을 가리키게 됩니다. - 흔히 커밋 스쿼시라고 부릅니다.
- 실제로 하는 일은
HEAD를 리베이스 시작점으로 되감은 다음, 지시에 따라 커밋을 순서대로 다시 적용하는 것입니다.
- 기본값은
git reset --hard NAME: 모든 파일의 상태를NAME의 상태로 되돌립니다(이름이 없으면HEAD). 변경 사항을 되돌릴 때 편리합니다.
다른 사람들과 함께 사용하기
버전 관리의 흔한 사용 사례는 여러 사람이 서로 방해하지 않고 같은 파일 모음을 변경할 수 있도록 하는 것입니다. 더 정확히는, 혹시 서로 방해하더라도 아무런 말 없이 서로의 변경 사항을 덮어쓰지는 않도록 보장하는 것입니다.
git은 분산형 VCS입니다. 모든 사람이 전체 저장소의 로컬 사본을 가지고 있습니다(정확히는 다른 사람들이 공개하기로 한 모든 것의 사본입니다). 일부 VCS는 중앙집중형입니다(예: subversion). 서버가 모든 커밋을 가지고 있고, 클라이언트에는 “체크아웃”한 파일만 있습니다. 기본적으로 현재 파일만 가지고 있으며, 그 외의 것을 원하면 서버에 요청해야 합니다.
git 저장소의 사본은 각각 “원격 저장소”로 등록할 수 있습니다. git clone ADDRESS로 기존 git 저장소를 복사할 수 있습니다(git init 대신). 그러면 ADDRESS를 가리키는 origin이라는 원격 저장소가 만들어집니다. git fetch REMOTE로 원격 저장소에서 이름과 그 이름이 가리키는 커밋을 가져올 수 있습니다. 원격 저장소의 모든 이름은 REMOTE/NAME으로 사용할 수 있으며, 로컬 이름처럼 사용할 수 있습니다.
원격 저장소에 쓰기 권한이 있다면 git push로 원격 저장소의 이름이 여러분이 만든 커밋을 가리키도록 바꿀 수 있습니다. 예를 들어 원격 저장소 origin의 master라는 이름(브랜치)이 현재 우리 master 브랜치가 가리키는 커밋을 가리키도록 해 봅시다.
git push origin master:master- 편의를 위해
-u로origin/master를 현재 브랜치에서git push할 때의 기본 대상으로 설정할 수 있습니다. - 생각해 보세요. 이것은 무엇을 할까요?
git push origin master:HEAD^
원격 저장소로는 GitHub, GitLab, BitBucket 등을 사용하는 경우가 많습니다. git 입장에서 여기에 “특별한” 것은 없습니다. 모두 이름과 커밋일 뿐입니다. 누군가 master를 변경하고 github/master가 자신의 커밋을 가리키도록 업데이트하면(이에 대해서는 잠시 후 다시 살펴보겠습니다), 여러분이 git fetch github를 실행했을 때 git log github/master로 그 변경 사항을 볼 수 있습니다.
다른 사람들과 협업하기
지금까지는 브랜치가 꽤 쓸모없어 보입니다. 만들고 작업할 수는 있지만, 그다음은 무엇일까요? 결국 master가 그 브랜치를 가리키게 할 뿐 아닌가요?
- 큰 기능을 작업하던 중 무언가를 고쳐야 한다면 어떨까요?
- 그사이에 다른 사람이 master를 변경했다면 어떨까요?
자신이 한 변경이든 다른 사람이 한 변경이든, 한 브랜치의 변경 사항을 다른 브랜치의 변경 사항과 병합해야 하는 순간은 반드시 옵니다. git에서는 예상대로 git merge NAME으로 이를 할 수 있습니다. merge는 다음과 같이 동작합니다.
HEAD와NAME이 공통 조상 커밋을 가졌던 가장 최근 지점(즉, 갈라진 지점)을 찾습니다.- 그 모든 변경 사항을 현재
HEAD에 적용하려고 합니다. - 그 모든 변경 사항을 담고
HEAD와NAME을 모두 조상으로 나열하는 커밋을 만듭니다. HEAD를 그 커밋의 해시로 설정합니다.
큰 기능을 완성하면 해당 브랜치를 master에 병합할 수 있으며, git은 어느 브랜치의 변경 사항도 잃지 않도록 보장합니다!
예전에 git을 사용해 보았다면 merge를 다른 이름으로 알고 있을 수 있습니다. 바로 pull입니다. git pull REMOTE BRANCH를 실행하면 다음과 같이 동작합니다.
git fetch REMOTEgit merge REMOTE/BRANCHpush와 마찬가지로REMOTE와BRANCH를 생략하고 “추적” 중인 원격 브랜치를 사용하는 경우가 많습니다(-u가 기억나나요?).
이 방식은 대체로 아주 잘 동작합니다. 병합하는 브랜치의 변경 사항이 서로 겹치지 않는 한은요. 겹친다면 병합 충돌이 발생합니다. 무섭게 들리네요…
- 병합 충돌은 git이 최종 차이가 어떤 모습이어야 하는지 모르겠다고 알려 주는 것일 뿐입니다.
- git은 잠시 멈추고 “병합 커밋”의 스테이징을 마무리해 달라고 요청합니다.
- 편집기에서 충돌한 파일을 열고 꺾쇠괄호가 잔뜩 있는 부분(
<<<<<<<)을 찾으세요.=======위의 내용은 공통 조상 커밋 이후HEAD에서 한 변경입니다. 아래의 내용은 공통 커밋 이후NAME에서 한 변경입니다. git mergetool은 꽤 편리합니다. 차이 편집기를 열어 줍니다.- 이제 파일이 어떤 모습이어야 하는지 판단해 충돌을 해결했다면,
git add로 그 변경 사항을 스테이징하세요. - 모든 충돌을 해결하면
git commit으로 마무리하세요.git merge --abort로 포기할 수 있습니다.
방금 첫 git 병합 충돌을 해결했습니다! \o/
이제 git push로 완성된 변경 사항을 공개할 수 있습니다.
세계가 충돌할 때
push를 하면 git은 푸시 대상인 원격 이름을 업데이트해도 다른 사람의 작업이 사라지지 않는지 확인합니다. 원격 이름이 현재 가리키는 커밋이 푸시하려는 커밋의 조상인지 확인하는 방식입니다. 조상이라면 git은 안전하게 이름만 업데이트할 수 있습니다. 이를 빨리 감기라고 합니다. 조상이 아니라면 git은 원격 이름의 업데이트를 거부하고 변경 사항이 있다고 알려 줍니다.
푸시가 거부되면 어떻게 해야 할까요?
git pull(즉,fetch+merge)로 원격 변경 사항을 병합합니다.--force로 강제로 푸시합니다. 다른 사람의 변경 사항을 잃게 됩니다!--force-with-lease도 있습니다. 이 옵션은 해당 원격 저장소에서 마지막으로 가져온 이후 원격 이름이 바뀌지 않았을 때만 변경을 강제합니다. 훨씬 안전합니다!- 이전에 푸시했던 로컬 커밋을 리베이스했다면(“기록 재작성”이며, 하지 않는 편이 좋을 것입니다), 강제로 푸시해야 합니다. 왜 그런지 생각해 보세요!
- 원격에서 한 변경 “위에” 여러분의 변경 사항을 다시 적용해 봅니다.
더 읽을거리
연습 문제
-
저장소에서 기존 파일을 수정해 보세요.
git stash를 하면 어떻게 되나요?git log --all --oneline을 실행하면 무엇이 보이나요?git stash pop을 실행해git stash로 했던 일을 되돌리세요. 어떤 상황에서 유용할까요? -
git을 배울 때 흔히 하는 실수는 git으로 관리해서는 안 되는 대용량 파일을 커밋하거나 민감한 정보를 추가하는 것입니다. 저장소에 파일을 추가하고 커밋을 몇 개 만든 뒤 그 파일을 기록에서 삭제해 보세요(이 문서를 살펴보면 좋습니다). 또 git이 대용량 파일을 관리하게 하고 싶다면 Git-LFS를 알아보세요.
- Git은 변경을 되돌릴 때 정말 편리하지만, 좀처럼 일어나지 않을 법한 변경에도 익숙해져야 합니다.
- 어떤 커밋에서 파일을 실수로 수정했다면
git revert로 되돌릴 수 있습니다. 하지만 커밋에 여러 변경이 들어 있다면revert가 최선은 아닐 수 있습니다.git checkout을 사용해 특정 커밋의 파일 버전을 복구하려면 어떻게 할 수 있을까요? - 브랜치를 만들고 그 브랜치에서 커밋을 만든 뒤 브랜치를 삭제하세요. 그래도 해당 커밋을 복구할 수 있을까요?
git reflog를 살펴보세요. (참고: 참조되지 않는 것은 빠르게 복구하세요. git은 어디에서도 참조하지 않는 커밋을 주기적으로 자동 정리합니다.) git reset대신git reset --hard를 너무 거리낌 없이 사용하면 변경 사항을 쉽게 잃을 수 있습니다. 하지만 변경 사항이 스테이징되어 있었으므로 복구할 수 있습니다. (git fsck --lost-found와.git/lost-found를 알아보세요.)
- 어떤 커밋에서 파일을 실수로 수정했다면
-
아무 git 저장소에서나
.git/hooks폴더를 살펴보면.sample로 끝나는 스크립트가 많이 보입니다..sample을 빼고 이름을 바꾸면 이름에 따라 실행됩니다. 예를 들어pre-commit은 커밋하기 전에 실행됩니다. 이 스크립트들을 시험해 보세요. -
다른 많은 명령줄 도구처럼
git은~/.gitconfig라는 설정 파일(또는 닷파일)을 제공합니다.~/.gitconfig를 사용해 별칭을 만들어,git graph를 실행하면git log --oneline --decorate --all --graph의 출력이 나오게 하세요(커밋 그래프를 빠르게 시각화하기에 좋은 명령어입니다). -
Git에서는
~/.gitignore_global에 전역 무시 패턴을 정의할 수도 있습니다. RSA 키를 추가하는 것과 같은 흔한 실수를 막는 데 유용합니다.~/.gitignore_global파일을 만들고*rsa패턴을 추가한 뒤, 저장소에서 제대로 동작하는지 시험하세요. -
git에 더 익숙해지면.gitignore편집과 같은 작업을 자주 하게 됩니다. git extras는git과 연동되는 여러 작은 유틸리티를 제공합니다. 예를 들어git ignore PATTERN은 저장소의.gitignore파일에 지정한 패턴을 추가하며,git ignore-io LANGUAGE는 gitignore.io에서 해당 언어의 일반적인 무시 패턴을 가져옵니다.git extras를 설치하고git alias나git ignore같은 도구를 사용해 보세요. -
Git GUI 프로그램은 때로 큰 도움이 될 수 있습니다. git 저장소에서 gitk를 실행해 인터페이스의 여러 부분을 탐색해 보세요. 그런 다음
gitk --all을 실행해 보세요. 어떤 차이가 있나요? - 명령줄 애플리케이션에 익숙해지면 GUI 도구가 번거롭거나 비대하게 느껴질 수 있습니다. 둘 사이의 좋은 절충안은 명령줄에서 탐색할 수 있으면서 대화형 인터페이스도 제공하는 ncurses 기반 도구입니다. Git에는 tig가 있습니다. 설치해서 저장소에서 실행해 보세요. 사용 예는 여기에서 볼 수 있습니다.
한국어 각주
1: (한국어 각주) 원문은 “you most likely mean ~ when you use ~”처럼 같은 기호를 반복합니다. 문맥상 영어 원문의 두 번째 ~(한국어 문장의 첫 번째 ~)는 ^의 오기로 보입니다. Git에서 X~3은 첫 번째 부모를 세 번 따라간 조상을, X^3은 세 번째 부모를 뜻합니다. 둘 다 커밋의 부모 관계를 따르며, 커밋 작성 시각을 기준으로 세 번째 이전 커밋을 고르는 표기는 아닙니다. Git의 리비전 표기 설명서를 참고하세요. 기호가 반복된 문장으로 돌아가기 · 조상 표기 예시로 돌아가기.
CC BY-NC-SA에 따라 라이센스를 부여합니다.
