원격의 브랜치와 로컬 Refs를 간단히 매핑하는 것은 많이 봤다. 이 매핑은 실은 좀 더 복잡하다. 앞서 자주 해왔듯 로컬 Git 저장소를 새로 생성하고 사용을 하다가 origin 이라는 리모트 저장소를 새로 추가 혹은 지정하려면 아래처럼 실행한다.
$ git remote add origin https://github.com/schacon/simplegit-progit
이 명령은 origin
이라는 저장소 이름, URL, Fetch 할 Refspec를 .git/config
파일에 추가한다.
[remote "origin"]
url = https://github.com/schacon/simplegit-progit
fetch = +refs/heads/*:refs/remotes/origin/*
Refspec 형식은 ` 와 `<src>:<dest>` 로 돼 있다. `
는 생략 가능하고, <src>
는 리모트 저장소의 Refs 패턴이고 <dst>
는 매핑되는 로컬 저장소의 Refs 패턴이다.
+
는 Fast-forward가 아닌 업데이트를 허용하는 것이다.
기본적으로 Git은 git remote add
명령으로 생성한 설정을 참고하여 리모트 서버에서 refs/heads/
에 있는 Refs를 가져다 로컬의 refs/remotes/origin/
에 기록한다.
로컬에서 서버에 있는 master
브랜치에 접근할 때는 아래와 같이 한다.
$ git log origin/master
$ git log remotes/origin/master
$ git log refs/remotes/origin/master
이 세 명령의 결과가 모두 같다.
Git은 모두 refs/remotes/origin/master
라고 해석한다.
master
브랜치만 가져올 수 있게 하려면 fetch
부분을 아래와 같이 바꿔준다. 그러면 다른 브랜치는 가져올 수 없다.
fetch = +refs/heads/master:refs/remotes/origin/master
이는 해당 리모트 저장소에서 git fetch
명령을 실행할 때 자동으로 사용되는 Refspec이다.
다른 Refspec을 가져오려면 명령의 아규먼트로 넘긴다.
리모트 브랜치 master
를 로컬 브랜치 origin/mymaster
로 가져오려면 아래와 같이 실행한다.
$ git fetch origin master:refs/remotes/origin/mymaster
Refspec을 여러 개 넘겨도 된다. 한꺼번에 브랜치를 여러 개 가져온다.
$ git fetch origin master:refs/remotes/origin/mymaster \
topic:refs/remotes/origin/topic
From [email protected]:schacon/simplegit
! [rejected] master -> origin/mymaster (non fast forward)
* [new branch] topic -> origin/topic
여기서 master
브랜치는 Fast-forward가 아니라서 거절된다.
하지만, Refspec 앞에 +
를 추가하면 강제로 덮어쓴다.
설정 파일에도 Refspec을 여러 개 적을 수 있다.
master
와 experiment
브랜치를 둘 다 적으면 origin
리모트에서 항상 함께 가져온다.
[remote "origin"]
url = https://github.com/schacon/simplegit-progit
fetch = +refs/heads/master:refs/remotes/origin/master
fetch = +refs/heads/experiment:refs/remotes/origin/experiment
하지만, Glob 패턴은 사용할 수 없다.
fetch = +refs/heads/qa*:refs/remotes/origin/qa*
그 대신 네임스페이스 형식(디렉토리 형식)으로는 사용할 수 있다.
만약 QA 팀이 Push 하는 브랜치가 있고 이 브랜치를 가져오고 싶으면 아래와 같이 설정한다. 다음은 master
브랜치와 QA 팀의 브랜치만 가져오는 설정이다.
[remote "origin"]
url = https://github.com/schacon/simplegit-progit
fetch = +refs/heads/master:refs/remotes/origin/master
fetch = +refs/heads/qa/*:refs/remotes/origin/qa/*
좀 더 복잡한 것도 가능하다. QA 팀뿐만 아니라, 일반 개발자, 통합 팀 등이 사용하는 브랜치를 네임스페이스 별로 구분해 놓으면 좀 더 Git을 편리하게 사용할 수 있다.
위와 같은 방식으로 네임스페이스를 사용하여 리모트 브랜치를 구별하여 사용하는 것은 꽤 괜찮은 방법이다. 만약 QA팀이 네임스페이스를 사용하지 않는 브랜치를 리모트에 네임스페이스를 써서 Push 하려면 어떻게 해야 할까? 이럴 땐 Refspec으로 가능하다.
QA 팀이 master
브랜치를 리모트 저장소에 qa/master
로 Push 하려면 아래와 같이 한다.
$ git push origin master:refs/heads/qa/master
git push origin
을 실행할 때마다 Git이 자동으로 Push 하게 하려면 아래와 같이 설정 파일에 push
항목을 추가한다.
[remote "origin"]
url = https://github.com/schacon/simplegit-progit
fetch = +refs/heads/*:refs/remotes/origin/*
push = refs/heads/master:refs/heads/qa/master
다시 말하자면 위와 같이 설정은 git push origin
을 실행할 때 로컬 브랜치 master
를 리모트 브랜치 qa/master
로 Push 하도록 하는 설정이다.