GitHub Fork로 협업하기

포크(fork)는 다른 사람의 GitHub 저장소를 내 계정으로 통째로 복사해서 독립적으로 작업할 수 있게 만드는 기능이다. 원본 저장소에 쓰기 권한이 없어도 포크한 내 저장소에서 자유롭게 커밋하고, 그 변경을 풀 리퀘스트(Pull Request)로 원본에 제안할 수 있기 때문에 오픈 소스 협업의 표준 방식으로 자리 잡았다. 포크 협업의 핵심은 원본을 가리키는 upstream 원격을 등록하고 주기적으로 동기화하면서, 작업은 항상 별도의 브랜치에서 하는 것이다.

포크 모델은 왜 필요한가

같은 회사 팀원이라면 하나의 저장소를 공유하고 브랜치만 나눠 쓰면 된다. 하지만 오픈 소스 프로젝트는 불특정 다수가 기여하는 구조라서 모든 기여자에게 원본 저장소의 쓰기 권한을 줄 수 없다. 포크 모델은 이 문제를 해결한다. 기여자는 원본을 내 계정으로 복사한 뒤 내 저장소에서 마음껏 실험하고, 완성된 변경만 풀 리퀘스트로 제안한다. 원본 관리자(maintainer)는 제안된 변경을 리뷰하고 받아들일지 결정한다. 쓰기 권한이 관리자에게만 있으므로 원본의 품질과 보안이 지켜지고, 기여의 문턱은 낮아진다.

포크는 단순 복제(clone)와 다르다. 클론은 내 컴퓨터에만 존재하는 로컬 복사본이지만, 포크는 GitHub 서버에 생기는 원격 저장소이고 원본과의 관계가 플랫폼 차원에서 추적되므로 저장소 사이의 풀 리퀘스트가 가능하다.

포크에서 풀 리퀘스트까지 실제 절차

전형적인 기여 흐름은 다음과 같다. 먼저 GitHub 웹에서 원본 저장소의 Fork 버튼을 눌러 내 계정에 복사본을 만들고, 그 복사본을 로컬로 클론한다. 이때 원격 이름은 관례적으로 내 포크가 origin, 원본이 upstream이 된다.

# 1. 내 포크를 클론한다
git clone https://github.com/<내계정>/<저장소>.git
cd <저장소>

# 2. 원본 저장소를 upstream으로 등록한다
git remote add upstream https://github.com/<원본계정>/<저장소>.git
git remote -v

작업은 반드시 main이 아닌 주제 브랜치(topic branch)에서 한다. main을 깨끗하게 유지해야 원본과의 동기화가 쉬워지고, 브랜치 하나가 풀 리퀘스트 하나에 대응해서 리뷰가 깔끔해진다.

# 3. 브랜치를 만들어 작업한다
git switch -c fix/<이슈-요약>
git add .
git commit -m "fix: 널 입력 시 예외 처리 추가"

# 4. 내 포크로 푸시하고 PR을 연다
git push -u origin fix/<이슈-요약>

푸시한 뒤 GitHub에서 내 포크의 브랜치를 원본의 기본 브랜치로 향하는 풀 리퀘스트로 연다. 리뷰에서 수정 요청을 받으면 같은 브랜치에 커밋을 추가해 푸시하기만 하면 PR에 자동 반영된다. 대부분의 프로젝트는 CONTRIBUTING 문서에 커밋 컨벤션과 테스트 요건을 정해 두므로 PR 전에 확인해야 한다. 변경 범위는 작게 유지하는 것이 좋다. 관리자 입장에서 수백 줄짜리 PR보다 목적이 하나인 작은 PR이 리뷰하기 쉽고, 그만큼 병합될 확률도 높아진다. 큰 작업이라면 먼저 이슈로 방향을 논의한 뒤 나눠서 제안하는 것이 예의이자 전략이다.

# 원본의 최신 변경을 가져와 내 main에 반영한다
git fetch upstream
git switch main
git merge --ff-only upstream/main
git push origin main

# 작업 중인 브랜치를 최신 main 위로 옮긴다
git switch fix/<이슈-요약>
git rebase main