깃허브 협업

**Pull Request(Pull Request, PR)**는 협업 프로젝트에서 코드 변경 사항을 리뷰 받고 병합하는 중요한 절차입니다. GitHub을 기준으로 풀 리퀘스트를 만드는 방법을 아래 단계별로 설명할게요.

1. GitHub에서 Fork (선택 사항)

먼저 협업하는 프로젝트를 자신의 계정으로 Fork 해야 할 수 있습니다. 이는 다른 사람의 리포지토리에서 작업할 때 필요합니다.

• Fork: 프로젝트 페이지에서 Fork 버튼을 클릭하여 자신의 GitHub 계정에 리포지토리를 복사합니다.

2. 로컬에서 리포지토리 클론 (Clone)

리포지토리를 로컬 환경에 가져옵니다.

bash

복사

git clone https://github.com/yourusername/repository-name.git cd repository-name

3. 새로운 브랜치 생성

기본 main 또는 master 브랜치에서 작업하지 않고, 새로운 브랜치를 만들어 작업하는 것이 좋습니다. 이렇게 하면 프로젝트의 메인 브랜치가 안전하게 유지될 수 있습니다.

bash

복사

git checkout -b feature/your-branch-name

• feature/your-branch-name: 이 부분은 작업하는 기능에 따라 자유롭게 이름을 정합니다. 예: feature/login-page 또는 bugfix/fix-header.

4. 변경 사항 작업

로컬에서 코드 수정이나 변경 사항을 추가합니다.

• 예: 코드 수정, 새로운 기능 추가 등.

5. 변경 사항 커밋

변경 사항을 커밋하여 로컬 저장소에 반영합니다.

bash

복사

git add . # 변경된 파일 모두 추가 git commit -m "이 작업에 대한 설명" # 커밋 메시지 작성

6. 원격 리포지토리로 푸시 (Push)

로컬 브랜치의 변경 사항을 GitHub 원격 리포지토리로 푸시합니다.

bash

복사

git push origin feature/your-branch-name

7. GitHub에서 Pull Request 만들기

GitHub에서 Pull Request를 생성합니다.

1. GitHub 리포지토리에 접속합니다.
2. "Compare & pull request" 버튼을 클릭합니다. (푸시한 브랜치에 대해 나타나는 버튼입니다)
3. Pull Request 제목과 설명을 작성합니다.
   • 제목에 변경 사항을 간단히 설명하고, 본문에 추가적인 설명을 작성합니다.
4. Base Branch와 Compare Branch를 확인합니다.
   • Base: 변경 사항을 병합할 대상 브랜치 (일반적으로 main 또는 develop).
   • Compare: 변경된 브랜치 (위에서 만든 feature/your-branch-name).
5. Create Pull Request 버튼을 클릭하여 PR을 생성합니다.

8. PR 검토 및 리뷰

• 다른 팀원들이 PR을 리뷰합니다. 리뷰어는 코드에 대한 피드백을 제공하고 수정 요청을 할 수 있습니다.
• 코드 수정: 리뷰어의 피드백을 반영하여 코드를 수정하고, 다시 푸시합니다.
  bash

  복사

  git add . git commit --amend # 이전 커밋 수정 (수정이 필요할 때) git push --force # 강제로 푸시 (PR의 같은 브랜치에 덮어쓰기)

9. PR 병합(Merge)

리뷰가 끝나고 모든 피드백이 반영되면 PR을 병합할 준비가 됩니다.

• Merge: 프로젝트 관리자가 PR을 승인하고 병합합니다.
  • GitHub에서는 Merge pull request 버튼을 클릭하여 병합할 수 있습니다.
  • 병합 후 main 브랜치로 최신 상태가 업데이트됩니다.