HOWTO · Git
Git에서 원격 분기 가져오기
이 튜토리얼은 다른 명령을 사용하여 Git에서 원격 분기를 가져오는 방법을 보여줍니다.
이 페이지의 내용
원격 브랜치를 가져오면 로컬 저장소의 원격 추적 참조가 업데이트됩니다. 현재 브랜치에 변경 사항이 병합되거나 작업 트리의 파일이 바뀌지는 않습니다. 다른 브랜치를 확인한 뒤 작업할지 또는 통합할지 결정하려면 git fetch를 사용하세요.
아래 명령에서 origin은 원격 저장소 이름으로, topic은 브랜치 이름으로 바꾸세요. origin/topic은 해당 브랜치를 마지막으로 가져왔을 때의 상태를 기록하는 원격 추적 참조입니다. 커밋을 만드는 데 사용하는 로컬 브랜치 자체는 아닙니다.
git fetch는 원격 추적 참조를 어떻게 업데이트하나요?
원격 저장소(remote)는 다른 저장소를 가리키는 이름 있는 연결입니다. 저장소를 복제하면 보통 origin과 가져오기 refspec이 설정되어, 원격 브랜치를 refs/remotes/origin/main 같은 참조에 연결합니다. 가져오기가 성공하면 Git는 요청 범위에 해당하는 참조를 업데이트하고 가져온 커밋을 FETCH_HEAD에 기록합니다. 체크아웃된 브랜치와 작업 트리는 그대로 유지됩니다.
가져오기는 동료의 작업을 검토하거나 커밋을 비교하거나 병합 또는 리베이스 여부를 결정하기 전에 유용합니다. 로컬에서 수정 중인 파일이 있어도 안전하게 가져올 수 있습니다. 가져오기는 작업 트리의 파일을 덮어쓰지 않습니다.
원격 브랜치 하나를 가져오기
원격 저장소에서 이름이 지정된 브랜치 하나를 가져오려면 git fetch origin topic을 실행하세요. 이 명령은 Git에 origin에서 topic을 가져오도록 요청합니다. 로컬에서 사용할 수 있는 원격 추적 브랜치를 보려면 git branch -r을 실행하세요.
목록에서 origin/topic을 찾으세요. 목록에는 이 저장소로 이미 가져온 참조가 표시되며, 서버에 현재 있는 모든 브랜치가 실시간으로 나열되는 것은 아닙니다. 가져온 브랜치의 커밋을 확인하려면 git log --oneline HEAD..origin/topic으로 현재 브랜치와 비교하세요. 표시되는 커밋은 origin/topic에서는 도달할 수 있지만 HEAD에서는 도달할 수 없습니다.
브랜치 이름이 보이지 않으면 git remote -v로 이름과 원격 저장소를 확인한 다음 다시 가져오세요. 원격 저장소의 가져오기 refspec은 어떤 원격 추적 참조가 업데이트되는지 결정합니다. 사용자 지정 refspec 때문에 예상한 origin/topic 참조가 만들어지지 않더라도, 가져오기 요청으로 받은 커밋은 FETCH_HEAD에 기록될 수 있습니다.
원격 브랜치를 추적하는 로컬 브랜치 만들기
가져온 브랜치에서 작업할 준비가 되면 원격 추적 참조를 추적하는 로컬 브랜치를 만드세요. 로컬 브랜치와 원격 브랜치의 이름을 모두 topic으로 하려면 git switch --track origin/topic을 사용하세요. Git는 origin/topic을 추적하도록 설정된 로컬 topic 브랜치를 만들고 그 브랜치로 전환합니다. 로컬 이름을 다르게 하려면 git switch --track -c my-topic origin/topic처럼 이름을 명시하세요.
이 추적 관계를 설정하면 git status 같은 명령으로 로컬 브랜치가 업스트림보다 앞서 있는지 뒤처져 있는지 확인할 수 있습니다. 이후 git pull과 git push 명령에서 기본 업스트림도 사용할 수 있습니다. 로컬 브랜치 이름이 이미 사용 중이면 다시 만들지 말고 해당 브랜치로 전환하세요.
다음의 독립 실행형 예제는 로컬 원격 저장소를 만들고 그 저장소의 topic 브랜치를 가져옵니다.
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
set -eu
work=$(mktemp -d)
trap 'rm -rf "$work"' EXIT
git init -q "$work/source"
git -C "$work/source" config user.name Example
git -C "$work/source" config user.email example@example.com
git -C "$work/source" checkout -q -b topic
printf 'hello
' > "$work/source/README.md"
git -C "$work/source" add README.md
git -C "$work/source" commit -q -m initial
git init -q --bare "$work/remote.git"
git -C "$work/source" remote add origin "$work/remote.git"
git -C "$work/source" push -q -u origin topic
git init -q "$work/consumer"
git -C "$work/consumer" remote add origin "$work/remote.git"
git -C "$work/consumer" fetch -q origin topic
git -C "$work/consumer" branch -r
origin/topic
모든 원격 저장소 또는 브랜치 가져오기
브랜치 인수를 생략하면 git fetch는 선택한 원격 저장소(대개 origin)에 설정된 refspec에 따라 가져옵니다. 이 refspec은 보통 해당 원격 저장소의 모든 브랜치를 포함하지만, 설정에 따라 범위가 좁아지거나 달라질 수 있습니다. 설정된 모든 원격 저장소에서 가져오려면 git fetch --all을 사용하세요.
--all은 모든 원격 저장소를 뜻합니다. 각 원격 저장소의 refspec을 무시하고 가능한 모든 브랜치를 가져오는 옵션은 아닙니다. 가져온 브랜치에서 도달할 수 없는 태그도 필요하다면 git fetch --all --tags를 고려하세요. 업데이트된 참조는 git branch -r로 확인할 수 있습니다. 두 명령 모두 브랜치를 체크아웃하거나 가져온 파일을 작업 트리에 기록하지 않습니다.
git fetch와 git pull 중 선택하기
변경 사항을 통합하기 전에 원격 추적 참조를 업데이트하고 들어오는 커밋을 살펴보려면 git fetch를 사용하세요. 현재 브랜치에 변경 사항을 가져와 통합하려는 경우에는 git pull을 사용하세요. git pull은 보통 현재 브랜치에 설정된 업스트림을 사용하며, 통합 방식은 설정에 따릅니다. 일반적으로 병합 또는 리베이스가 사용됩니다.
예를 들어 git pull origin topic은 origin에서 가져온 topic을 현재 체크아웃된 브랜치에 통합합니다. 로컬 topic 브랜치로 전환하지는 않습니다. 변경 사항이 로컬 작업과 겹치면 통합 과정에서 충돌이 발생할 수 있습니다. 먼저 검토하고 싶다면 origin/topic을 가져와 확인한 뒤 준비가 되었을 때 명시적으로 병합하거나 리베이스하세요.