Git

GitHub Desktop에서 팀 협업을 위한 브랜치 사용 방법

초코너무조코 2025. 1. 22. 14:32
728x90

1. GitHub Desktop 설치 및 초기 설정

  • 먼저, GitHub Desktop이 설치되어 있어야 합니다. GitHub Desktop 공식 사이트에서 다운로드하여 설치하세요.
  • GitHub 계정을 GitHub Desktop에 연결해야 하며, 연결 후 해당 저장소를 클론(clone)하거나 새로 만들기 할 수 있습니다.

2. 새 브랜치 생성

팀에서 작업을 나누고 각자의 작업을 독립적으로 관리하려면, 브랜치를 사용하여 각각의 작업을 분리할 수 있습니다. 각 팀원이 브랜치를 생성하여 자신이 맡은 작업을 진행하는 방식입니다.

 

브랜치 생성 방법

  1. GitHub Desktop을 열고, 로컬 저장소를 선택합니다.
  2. 왼쪽 상단에서 "Branch" 버튼을 클릭합니다.
  3. "New Branch"를 선택합니다.
  4. 새 브랜치 이름을 입력합니다. 예를 들어, feature/add-login-page, bugfix/fix-header, hotfix/fix-crash와 같이 작업 내용을 반영한 브랜치명을 설정합니다.
  5. 브랜치 생성 버튼을 클릭하여 새 브랜치를 만듭니다.

3. 브랜치에서 작업하기

각 팀원이 만든 브랜치에서 독립적으로 작업을 진행합니다. GitHub Desktop에서는 작업한 내용을 쉽게 커밋하고 푸시할 수 있습니다.

작업 방법

  1. 브랜치를 생성하고 브랜치에 체크아웃(checkout) 하면, 해당 브랜치에서 작업을 시작할 수 있습니다.
  2. 작업한 내용을 저장하고, 커밋(commit)하려면, Changes 탭에서 변경된 파일을 확인합니다.
  3. 커밋 메시지를 입력하고 Commit to [브랜치명]을 클릭하여 커밋합니다.
  4. 작업한 내용을 GitHub 서버에 반영하려면 Push 버튼을 클릭하여 원격 저장소로 푸시합니다.

4. 브랜치 푸시 및 팀원과의 협업

팀원들이 자신의 브랜치를 푸시한 후, 서로 다른 브랜치에서 작업한 내용을 Pull Request (PR)로 병합할 수 있습니다.

PR(풀 리퀘스트) 생성 방법

  1. 작업한 브랜치를 GitHub Desktop에서 푸시(push)한 후, GitHub 웹사이트에서 해당 저장소로 가면, 자동으로 PR 생성 제안이 나타납니다.
  2. "Compare & Pull Request" 버튼을 클릭합니다.
  3. PR 제목과 설명을 추가하고, 병합할 대상 브랜치를 main 또는 develop 브랜치로 설정합니다.
  4. Create Pull Request를 클릭하여 풀 리퀘스트를 생성합니다.

5. PR 리뷰 및 병합(Merge)

PR을 팀원에게 리뷰를 요청하고, 코드가 리뷰를 통과하면 병합(Merge)을 진행합니다.

PR 리뷰 및 병합 방법

  1. PR을 생성하면 팀원들이 Review하고 Approve할 수 있습니다.
  2. 리뷰가 끝나면, PR 페이지에서 Merge 버튼을 클릭하여 브랜치를 병합합니다.
  3. 병합 후, GitHub Desktop에서 Pull을 통해 최신 브랜치 변경 사항을 받아옵니다.

6. 다른 팀원 브랜치 작업을 반영(Pull)

팀원들이 변경한 사항을 최신 상태로 반영하려면, Pull을 사용하여 원격 저장소의 변경 사항을 로컬 저장소로 가져옵니다.

Pull 방법

  1. GitHub Desktop에서 Current Branch를 클릭하고, "main" 또는 "develop" 브랜치로 체크아웃합니다.
  2. 왼쪽 상단에서 "Fetch Origin" 버튼을 클릭하여 최신 커밋을 가져옵니다.
  3. Pull을 클릭하여 최신 변경 사항을 로컬 저장소로 적용합니다.

7. 브랜치 삭제

작업이 끝나면 사용하지 않는 브랜치는 삭제하는 것이 좋습니다. 이 과정은 로컬과 원격 브랜치 모두에서 삭제할 수 있습니다.

브랜치 삭제 방법

  1. GitHub Desktop에서 브랜치 목록을 확인하려면, Current Branch 버튼을 클릭합니다.
  2. 삭제할 브랜치를 선택하고 "Delete" 버튼을 클릭합니다.
  3. GitHub 웹사이트에서 원격 브랜치도 삭제하려면, 해당 PR을 머지한 후 "Delete Branch" 버튼을 클릭합니다.

팀 Git 협업 시 주의사항

  1. 커밋 메시지 규칙 설정
    • 팀 내에서 일관된 커밋 메시지 규칙을 설정합니다. 예를 들어, 기능을 추가할 때는 feat, 버그 수정을 할 때는 fix로 시작하는 규칙을 따릅니다.
  2. 정기적인 Pull
    • 팀원들이 계속해서 작업하는 동안 충돌을 피하기 위해 정기적으로 Pull을 하여 다른 팀원의 변경 사항을 최신 상태로 유지합니다.
    • 충돌을 방지하는 slash 방법은 https://qowjdduswkd.tistory.com/62 여기 있어용 
  3. 브랜치 이름 규칙
    • 브랜치 이름에 대한 규칙을 설정하여 관리합니다. 예를 들어, feature/, bugfix/, hotfix/와 같은 접두사를 사용하여 브랜치의 목적을 명확하게 합니다.

요약

  • 브랜치 생성: 팀마다 독립적인 작업을 진행하려면 각자 새로운 브랜치를 생성합니다.
  • 변경 사항 커밋: GitHub Desktop에서 변경 사항을 커밋하고 푸시합니다.
  • Pull Request(PR): 팀원들과 협업하면서 PR을 생성하여 코드를 병합합니다.
  • PR 리뷰 및 병합: 리뷰 후 승인을 받아 병합합니다.
  • Pull: 다른 팀원의 작업을 최신 상태로 반영하려면 Pull을 사용합니다.
  • 브랜치 삭제: 작업이 끝난 후 불필요한 브랜치는 삭제하여 관리합니다.

이러한 방법으로 GitHub Desktop과 Git을 사용하여 팀원들과 효율적으로 협업할 수 있습니다.