GitLab 브랜치 생성 및 머지 단계별 가이드

GitLab 브랜치 생성 및 머지 단계별 가이드

작성자:

이 가이드는 GitLab 웹 콘솔과 로컬 Git 환경에서 브랜치를 생성하고, 커밋 후 병합(Merge)하는 전 과정을 단계별로 설명합니다.

1. 브랜치의 기본 개념

브랜치(Branch) 는 독립된 작업 공간입니다. 각 브랜치에서의 변경은 다른 브랜치에 영향을 주지 않아 여러 개발자가 동시에 다른 기능 개발을 수행할 수 있습니다.

일반적인 브랜치 전략 구조는 다음과 같습니다:

  • main (또는 master): 최종 배포용 안정 버전.

  • dev (또는 develop): 여러 기능(feature branch)을 통합하고 테스트하는 개발 버전.

  • feature/이슈 브랜치: 각 기능 개발 또는 버그 수정용 임시 브랜치.

2. GitLab에서 브랜치 생성하기

(1) GitLab UI를 통한 생성

  1. 프로젝트 홈에서 좌측 메뉴 Code → Branches 클릭.

  2. 우측 상단의 New Branch 버튼 클릭.

  3. Branch name 입력 (예: feature/login-page).

  4. Create from 드롭다운에서 기준 브랜치를 선택 (일반적으로 dev).

  5. Create branch 버튼 클릭.

👉 새 브랜치가 dev 브랜치를 기반으로 생성됩니다.

📌 팁: 이슈를 기반으로 생성하려면 Issue 상세 페이지에서 Create branch 버튼을 사용할 수도 있습니다.

3. 로컬에서 브랜치 가져오기 및 작업하기

새 브랜치를 로컬로 가져와서 작업하려면:

bash
git fetch origin # 원격 저장소의 내용 갱신
git checkout -b feature/login-page origin/feature/login-page # 원격 브랜치 기반 새 브랜치 생성

변경사항을 추가하고 커밋합니다:

bash
git add .
git commit -m "Add login page layout"
git push origin feature/login-page # 작업한 브랜치를 원격에 푸시

4. Merge Request (MR) 생성하기

브랜치를 머지하기 위해 GitLab에서 Merge Request (병합 요청)를 생성합니다.

  1. GitLab의 좌측 메뉴에서 Merge requests 클릭.

  2. New merge request 클릭.

  3. Source branch (예: feature/login-page)와 Target branch (예: dev) 선택.

  4. Compare branches and continue 클릭.

  5. 제목, 설명 작성 후 Create merge request 클릭.

  6. Assignee, Reviewer 선택.

  7. 코드리뷰 승인 후 Merge 버튼을 눌러 병합 완료.

📌 권한이 있는 계정만 Merge 가능하며, 병합 시 자동으로 feature 브랜치를 삭제되게 설정할 수도 있습니다.

5. 브랜치 병합 후 정리하기

브랜치가 dev에 병합되었다면, 해당 feature 브랜치는 더 이상 필요하지 않습니다.

  • 원격 브랜치 삭제:

    bash
    git push origin --delete feature/login-page

  • 로컬 브랜치 삭제:

    bash
    git branch -d feature/login-page

이 과정을 통해 리포지토리를 깔끔하게 유지합니다.

6. 명령어 요약표

작업 단계 명령어 설명
브랜치 생성 git branch feature/001 로컬에서 새 브랜치 생성
브랜치 전환 git checkout feature/001 생성된 브랜치로 이동
브랜치 푸시 git push origin feature/001 원격 저장소에 브랜치 등록
병합 준비 git checkout dev dev로 전환 후 머지 준비
브랜치 병합 git merge feature/001 feature 브랜치를 dev에 병합
병합 브랜치 삭제 git branch -d feature/001 로컬 브랜치 삭제

7. 요약 & 권장 워크플로우

GitLab 브랜치 생성 및 머지 단계별 가이드

  1. GitLab에서 이슈를 생성한다.

  2. 이슈 → Create branch로 새 브랜치 생성.

  3. 로컬에서 브랜치를 pull → commit → push.

  4. 작업 완료 후 MR 생성 및 코드 리뷰.

  5. 승인 후 Merge → 브랜치 삭제.

이 과정을 따르면, 팀 내 협업이 명확해지고 코드 품질 관리가 쉬워집니다.