[Git] git 초보자를 위한 Pull Request 사용 방법

📔 소개

아직 Git 을 사용함에 있어 Pull Request 에 어색한 분들을 위한 글이다.

Pull Request란 무엇일까?

Repository(프로젝트)의 Maker(생성자), Collaborators(협력자) 가 아니기에 Push 권한이 없지만, 해당 구성원들에게 Contribute 를 하기 위한 요청이다.

조금 더 풀어 말하자면,

내가 작업해야하는(혹은 마음에 드는) Repository가 있는데 코드에 기여하고 싶을 때(더 발전된 코드거나 Maker와 Collaborators에 도움되는 코드) 내가 수정한 코드가 있으니 검토 후, 코드 병합 요청을 하는 것이다.

OO님~~ A 프로젝트 이슈 #12451번 처리 부탁드려요~!

📝초보자는 이 말을 듣고 얼마나 긴장될까? 말로만 듣던 이슈처리라니..

이슈 처리를 하는 방법은 다양하다.

1. 권한이 있을 경우, Repository 에서 바로 clone을 떠서 issue branch 로 작업을 진행해도 되고,

2. 내 Repository 로 Fork 를 떠서 내가 자유롭게 수정해도 원본 Repository 에 지장을 주지 않게 작업을 진행해도 된다.

이 포스팅에서는 PR을 주제로 다루고 있기 때문에 2번 기준으로 설명하겠다.

대상 Repository 를 내 원격 Repository 에 Fork
Local 환경에 clone
작업 구분 branch (유용한 글: Git branch & naming) 생성
코드 수정(add, commit, push) - 코드를 수정하던 도중 기존 Repository 에서 Fetch를 통해 프로젝트를 가져온다
Pull Request 생성
Merge Pull Request
Merge 이후 동기화 및 branch 삭제

Repository 에서 Fork 버튼 선택

자신의 Repository 로 가져오는 과정

자신의 Repository 에 Fork 가 완료된 모습

코드를 수정하고 Push 를 완료하면, Fork 를 진행한 Repository 에 Compare & pull request 버튼이 활성화 된다.

해당 버튼을 선택하여 메시지를 작성하고 PR 을 생성한다.

Pull Request를 수신받은 Maker 는 변경된 코드 내용을 확인하는 리뷰 과정을 거친 후, Merge 여부를 결정한다.

요약하자면

프로젝트의 Repository 를 찾아 'Fork' 를 떠서 내 프로젝트로 가져온 후, 'Local' 환경에 'clone' 해서 branch 생성 후, 코드를 수정한다.

* 코드를 수정하는 도중에 기존 Repository 에 변화가 있는지 확인하고, Fetch 기능을 통해 최신 Repository 정보를 가져와 충돌을 방지하며 작업할 수 있도록 유의해야 한다.

수정이 완료되면 Fork된 Repository 에서 Push 를 진행하여 Pull Request 과정을 요청한다.