6. Pull Request

1. GitHub Pull Request란?

상대방의 저장소를 Fork한 후 원본 저장소에 올리고 싶을 때, 원본 저장소의 권한을 가진 사람에게 두 브랜치를 합치는 것을 허락해 달라고 요청을 보내야 한다. 이것을 Pull Request 또는 PR이라고 한다. PR은 원본 저장소에 보낼 수 있고 포크한 저장소에도 보낼 수 있다. PR 요청을 사용하면 깃허브의 저장소안에 있는 브랜치에 푸쉬한 변경사항을 다른 사람에게 알릴 수 있다. PR이 열리면 팀원과 변경사항을 논의하고 검토할 수 있으며, 변경 사항이 기본 브랜치에 병합되기 전에 후속 커밋을 추가할 수 있다.

2. GitHub Pull Request의 장점

협업 시에는 최대한 직접 merge하는 것은 피하고 모든 merge를 pull request를 통해서 하는 것이 좋다. 상대방이 PR을 보고 코드 리뷰가 가능하기 때문이다. PR에 수정이 필요하면 댓글을 달아 change request를 보낼 수 있다. 단, 오픈 소스에 PR을 보낼 때에는 기여 안내문서를 참고해야한다.

3. Pull Request 보내는 방법

1) 포크한 저장소에 Contribute를 클릭하고 Open pull request 버튼을 클릭한다.

2) 원본 저장소로 이동하게 되는데, 어떤 브랜치에 어디로 브랜치 할 것인지 선택한다.

3) 초록색 문구가 나타나면 정상적으로 PR을 할 수 있고 빨간색 문구가 뜬다면 충돌을 해결하고 PR을 한다.

4) Create pull request를 클릭하면 제목과 글을 작성할 수 있다.

5) 작성이 완료되면 Create pull request 버튼이 활성화 된다.

상단 Pull requests를 클릭하면 상대방이 PR을 보낸 것을 확인할 수 있다.

PR은 내가 merge할 수 없고 권한이 있는 사람이 리뷰를 달거나, Merge pull request 버튼을 클릭하여 merge할 수 있다.

4. Pull Request 취소하기

Pull Request를 보내고 취소하고 싶을 때도 있을 것이다. Pull Request를 요청한 레포지토리로 간 이후, 자신이 보낸 PR을 선택한다. 하단에 “Close pull request” 버튼을 클릭하면 자신이 요청한 PR이 취소된다.

깃허브 정책에 의해 PR 내역은 삭제가 되지 않는다. 하지만 원하신다면 깃허브에 연락을 해 삭제를 요청해야 한다.