버전 관리

시간에 따라 변하는 무언가를 작업할 때는 그 변화를 추적할 수 있으면 유용합니다. 이유는 여러 가지입니다. 무엇이 바뀌었는지, 어떻게 되돌릴 수 있는지, 누가 바꾸었는지, 어쩌면 왜 바꾸었는지까지 기록으로 남길 수 있습니다. 버전 관리 시스템(VCS)은 이러한 기능을 제공합니다. 파일 모음의 변경 사항을 설명하는 메시지와 함께 커밋할 수 있고, 과거에 했던 변경을 살펴보거나 되돌릴 수도 있습니다.

대부분의 VCS는 여러 사용자 사이에 커밋 기록을 공유하는 기능을 지원합니다. 덕분에 편리하게 협업할 수 있습니다. 여러분은 제가 한 변경을 볼 수 있고, 저는 여러분이 한 변경을 볼 수 있습니다. 또한 VCS는 변경 사항을 추적하므로, 서로 비교적 겹치지 않는 부분을 건드렸다면 대체로 (항상은 아니지만) 변경 사항을 합치는 방법도 알아낼 수 있습니다.

VCS는 아주 많으며, 지원하는 기능, 동작 방식, 상호작용 방식도 크게 다릅니다. 여기서는 더 널리 쓰이는 것 중 하나인 git에 집중하겠지만, Mercurial도 살펴보기를 권합니다.

그럼 이제 CliffNotes로!

git은 흑마법일까요?

꼭 그렇지는 않습니다.. 데이터 모델을 이해해야 합니다. 몇몇 세부 사항은 건너뛰겠지만, 대략적으로 말하면 git의 핵심 “대상”은 커밋입니다.

처음에는 저장소(대략 git이 관리하는 폴더)에 내용도 커밋도 없습니다. 이를 만들어 봅시다.

$ git init hackers
$ cd hackers
$ git status

이 출력은 사실 좋은 출발점이 됩니다. 자세히 살펴보면서 전부 이해했는지 확인해 봅시다.

먼저 “On branch master”입니다.

“No commits yet”은 말 그대로이므로 건너뛰겠습니다.

다음은 “nothing to commit”입니다.

위 내용을 시험해 보면서 git status를 실행해 git이 여러분이 무엇을 하고 있다고 생각하는지 확인해 보세요. 놀랄 만큼 도움이 됩니다!

커밋이라고요…

좋습니다. 커밋이 생겼습니다. 이제 무엇을 할까요?

이름에는 무엇이 담겨 있을까요?

이름은 분명 git에서 중요합니다. 또한 git에서 일어나는 많은 일을 이해하는 열쇠입니다. 지금까지 커밋 해시, master, HEAD를 살펴보았습니다. 하지만 더 있습니다!

어질러 놓은 것 정리하기

커밋 기록은 매우 자주 다음과 같은 모습이 됩니다.

git으로서는 괜찮지만, 미래의 여러분이나 무엇이 바뀌었는지 궁금한 다른 사람에게는 별로 도움이 되지 않습니다. git에서는 이런 것들을 정리할 수 있습니다.

다른 사람들과 함께 사용하기

버전 관리의 흔한 사용 사례는 여러 사람이 서로 방해하지 않고 같은 파일 모음을 변경할 수 있도록 하는 것입니다. 더 정확히는, 혹시 서로 방해하더라도 아무런 말 없이 서로의 변경 사항을 덮어쓰지는 않도록 보장하는 것입니다.

git은 분산형 VCS입니다. 모든 사람이 전체 저장소의 로컬 사본을 가지고 있습니다(정확히는 다른 사람들이 공개하기로 한 모든 것의 사본입니다). 일부 VCS는 중앙집중형입니다(예: subversion). 서버가 모든 커밋을 가지고 있고, 클라이언트에는 “체크아웃”한 파일만 있습니다. 기본적으로 현재 파일만 가지고 있으며, 그 외의 것을 원하면 서버에 요청해야 합니다.

git 저장소의 사본은 각각 “원격 저장소”로 등록할 수 있습니다. git clone ADDRESS로 기존 git 저장소를 복사할 수 있습니다(git init 대신). 그러면 ADDRESS를 가리키는 origin이라는 원격 저장소가 만들어집니다. git fetch REMOTE로 원격 저장소에서 이름과 그 이름이 가리키는 커밋을 가져올 수 있습니다. 원격 저장소의 모든 이름은 REMOTE/NAME으로 사용할 수 있으며, 로컬 이름처럼 사용할 수 있습니다.

원격 저장소에 쓰기 권한이 있다면 git push로 원격 저장소의 이름이 여러분이 만든 커밋을 가리키도록 바꿀 수 있습니다. 예를 들어 원격 저장소 origin의 master라는 이름(브랜치)이 현재 우리 master 브랜치가 가리키는 커밋을 가리키도록 해 봅시다.

원격 저장소로는 GitHub, GitLab, BitBucket 등을 사용하는 경우가 많습니다. git 입장에서 여기에 “특별한” 것은 없습니다. 모두 이름과 커밋일 뿐입니다. 누군가 master를 변경하고 github/master가 자신의 커밋을 가리키도록 업데이트하면(이에 대해서는 잠시 후 다시 살펴보겠습니다), 여러분이 git fetch github를 실행했을 때 git log github/master로 그 변경 사항을 볼 수 있습니다.

다른 사람들과 협업하기

지금까지는 브랜치가 꽤 쓸모없어 보입니다. 만들고 작업할 수는 있지만, 그다음은 무엇일까요? 결국 master가 그 브랜치를 가리키게 할 뿐 아닌가요?

자신이 한 변경이든 다른 사람이 한 변경이든, 한 브랜치의 변경 사항을 다른 브랜치의 변경 사항과 병합해야 하는 순간은 반드시 옵니다. git에서는 예상대로 git merge NAME으로 이를 할 수 있습니다. merge는 다음과 같이 동작합니다.

큰 기능을 완성하면 해당 브랜치를 master에 병합할 수 있으며, git은 어느 브랜치의 변경 사항도 잃지 않도록 보장합니다!

예전에 git을 사용해 보았다면 merge를 다른 이름으로 알고 있을 수 있습니다. 바로 pull입니다. git pull REMOTE BRANCH를 실행하면 다음과 같이 동작합니다.

이 방식은 대체로 아주 잘 동작합니다. 병합하는 브랜치의 변경 사항이 서로 겹치지 않는 한은요. 겹친다면 병합 충돌이 발생합니다. 무섭게 들리네요…

방금 첫 git 병합 충돌을 해결했습니다! \o/ 이제 git push로 완성된 변경 사항을 공개할 수 있습니다.

세계가 충돌할 때

push를 하면 git은 푸시 대상인 원격 이름을 업데이트해도 다른 사람의 작업이 사라지지 않는지 확인합니다. 원격 이름이 현재 가리키는 커밋이 푸시하려는 커밋의 조상인지 확인하는 방식입니다. 조상이라면 git은 안전하게 이름만 업데이트할 수 있습니다. 이를 빨리 감기라고 합니다. 조상이 아니라면 git은 원격 이름의 업데이트를 거부하고 변경 사항이 있다고 알려 줍니다.

푸시가 거부되면 어떻게 해야 할까요?

더 읽을거리

git에 관한 XKCD

연습 문제

  1. 저장소에서 기존 파일을 수정해 보세요. git stash를 하면 어떻게 되나요? git log --all --oneline을 실행하면 무엇이 보이나요? git stash pop을 실행해 git stash로 했던 일을 되돌리세요. 어떤 상황에서 유용할까요?

  2. git을 배울 때 흔히 하는 실수는 git으로 관리해서는 안 되는 대용량 파일을 커밋하거나 민감한 정보를 추가하는 것입니다. 저장소에 파일을 추가하고 커밋을 몇 개 만든 뒤 그 파일을 기록에서 삭제해 보세요(이 문서를 살펴보면 좋습니다). 또 git이 대용량 파일을 관리하게 하고 싶다면 Git-LFS를 알아보세요.

  3. Git은 변경을 되돌릴 때 정말 편리하지만, 좀처럼 일어나지 않을 법한 변경에도 익숙해져야 합니다.
    1. 어떤 커밋에서 파일을 실수로 수정했다면 git revert로 되돌릴 수 있습니다. 하지만 커밋에 여러 변경이 들어 있다면 revert가 최선은 아닐 수 있습니다. git checkout을 사용해 특정 커밋의 파일 버전을 복구하려면 어떻게 할 수 있을까요?
    2. 브랜치를 만들고 그 브랜치에서 커밋을 만든 뒤 브랜치를 삭제하세요. 그래도 해당 커밋을 복구할 수 있을까요? git reflog를 살펴보세요. (참고: 참조되지 않는 것은 빠르게 복구하세요. git은 어디에서도 참조하지 않는 커밋을 주기적으로 자동 정리합니다.)
    3. git reset 대신 git reset --hard를 너무 거리낌 없이 사용하면 변경 사항을 쉽게 잃을 수 있습니다. 하지만 변경 사항이 스테이징되어 있었으므로 복구할 수 있습니다. (git fsck --lost-found와 .git/lost-found를 알아보세요.)
  4. 아무 git 저장소에서나 .git/hooks 폴더를 살펴보면 .sample로 끝나는 스크립트가 많이 보입니다. .sample을 빼고 이름을 바꾸면 이름에 따라 실행됩니다. 예를 들어 pre-commit은 커밋하기 전에 실행됩니다. 이 스크립트들을 시험해 보세요.

  5. 다른 많은 명령줄 도구처럼 git은 ~/.gitconfig라는 설정 파일(또는 닷파일)을 제공합니다. ~/.gitconfig를 사용해 별칭을 만들어, git graph를 실행하면 git log --oneline --decorate --all --graph의 출력이 나오게 하세요(커밋 그래프를 빠르게 시각화하기에 좋은 명령어입니다).

  6. Git에서는 ~/.gitignore_global에 전역 무시 패턴을 정의할 수도 있습니다. RSA 키를 추가하는 것과 같은 흔한 실수를 막는 데 유용합니다. ~/.gitignore_global 파일을 만들고 *rsa 패턴을 추가한 뒤, 저장소에서 제대로 동작하는지 시험하세요.

  7. git에 더 익숙해지면 .gitignore 편집과 같은 작업을 자주 하게 됩니다. git extras는 git과 연동되는 여러 작은 유틸리티를 제공합니다. 예를 들어 git ignore PATTERN은 저장소의 .gitignore 파일에 지정한 패턴을 추가하며, git ignore-io LANGUAGE는 gitignore.io에서 해당 언어의 일반적인 무시 패턴을 가져옵니다. git extras를 설치하고 git alias나 git ignore 같은 도구를 사용해 보세요.

  8. Git GUI 프로그램은 때로 큰 도움이 될 수 있습니다. git 저장소에서 gitk를 실행해 인터페이스의 여러 부분을 탐색해 보세요. 그런 다음 gitk --all을 실행해 보세요. 어떤 차이가 있나요?

  9. 명령줄 애플리케이션에 익숙해지면 GUI 도구가 번거롭거나 비대하게 느껴질 수 있습니다. 둘 사이의 좋은 절충안은 명령줄에서 탐색할 수 있으면서 대화형 인터페이스도 제공하는 ncurses 기반 도구입니다. Git에는 tig가 있습니다. 설치해서 저장소에서 실행해 보세요. 사용 예는 여기에서 볼 수 있습니다.

한국어 각주

1: (한국어 각주) 원문은 “you most likely mean ~ when you use ~”처럼 같은 기호를 반복합니다. 문맥상 영어 원문의 두 번째 ~(한국어 문장의 첫 번째 ~)는 ^의 오기로 보입니다. Git에서 X~3은 첫 번째 부모를 세 번 따라간 조상을, X^3은 세 번째 부모를 뜻합니다. 둘 다 커밋의 부모 관계를 따르며, 커밋 작성 시각을 기준으로 세 번째 이전 커밋을 고르는 표기는 아닙니다. Git의 리비전 표기 설명서를 참고하세요. 기호가 반복된 문장으로 돌아가기 · 조상 표기 예시로 돌아가기.


이 페이지를 수정.

CC BY-NC-SA에 따라 라이센스를 부여합니다.