1. GitLab 터미널에서 Merge Request(PR) 올리는 법
STEP 1. 브랜치 생성 → 작업 → 커밋 → 푸시
git checkout main
git pull origin main
git checkout -b feature/새기능
# 작업...
git add .
git commit -m "새기능 추가"
git push origin feature/새기능STEP 2. glab CLI 설치 (최초 1회만)
Window
winget install glab.glabLinux(Homebrew)
brew install glabLinux(직접설치)
wget https://git.io/glab-linux-amd64 -O glab
sudo install glab /usr/local/bin/설치가 잘 안 되면 공식 문서 참고:
https://github.com/profclems/glab#installation
STEP 3. GitLab 인증 (최초 1회만)
glab auth login- 안내에 따라 Personal Access Token 입력
STEP 4. Merge Request(MR) 생성
glab mr create --source feature/새기능 --target main --title "새기능 추가" --description "설명"- 작업 브랜치에서 main으로 MR 생성
- 또는 git push 후 안내되는 웹 MR 링크로 직접 생성도 가능
TIP
- glab 명령이 안 먹거나 에러가 날 때는 설치·인증 단계부터 점검
- MR 옵션, 제목/설명 템플릿 등 필요하면 추가 요청
2. PR 반영: Merge Request(MR) 머지/반영하는 법
STEP 1. Merge Request 목록 확인**
- 웹에서 프로젝트 > Merge Requests 메뉴 진입
STEP 2. MR(풀리퀘) 클릭해서 상세화면 진입**
- 변경된 코드(Changes 탭)와 설명을 검토
STEP 3. (필요시) Approve(승인) 또는 Comment(코멘트)**
- 리뷰 후 승인 버튼 클릭 가능
STEP 4. Merge 버튼 클릭**
- 상세화면 우측(또는 하단)의 “Merge” 버튼 클릭
- “Delete source branch after merging” 체크하면 머지 후 브랜치 자동 삭제
STEP 5. Merge 완료!**
- main에 변경사항 반영됨
- CI/CD 설정 시 자동 배포 또는 추가 빌드 진행 가능
TIP
- Maintainer 권한 이상이면 머지 가능 (권한 없으면 머지 버튼이 안 보임)
- “Pipelines must succeed” 등 CI 성공이 필수인 경우, 파이프라인 통과 후에만 머지 버튼 활성화
3. GitLab Merge Request(MR) 다중 승인(Approvals) 설정 방법
여러 명이 머지 리퀘스트(MR, PR)를 승인(Approve)해야만 머지할 수 있도록 정책을 설정하는 방법입니다.
⚠️ 사내에서는 GitLab 무료 플랜을 사용 중이라, 무료 플랜 기준으로 정리했습니다.
중요: 무료 플랜에서는 “다중 승인(Approvals required)” 정책을 직접 설정할 수 없습니다.
대신 아래와 같은 방식으로 리뷰 문화를 유지할 수 있습니다.
STEP 1. Protected Branch(보호 브랜치)로 직접 푸시 차단
- main/master 브랜치를 “Protected Branch”로 설정
- “Allowed to push: No one”, “Allowed to merge: Maintainers” 등으로 제한
- 모든 변경사항은 반드시 MR(Merge Request)로만 머지하도록!
STEP 2. 팀 내 리뷰 체크리스트/합의 프로세스 운영
- MR 설명란에 리뷰 체크리스트를 직접 삽입
예시:- 기능 요구사항 확인
- 테스트 코드 작성/수행 결과 첨부
- 코드 스타일, 네이밍 컨벤션 준수
- 팀 약속으로 1인 이상 리뷰/승인 후 머지하도록 합의
STEP 3. Merge checks 옵션 활용
- “All discussions must be resolved” 체크
→ 모든 코멘트(resolve) 후에만 머지 허용
STEP 4. 리뷰 및 머지 과정
- MR 올린 사람이 팀원에게 리뷰 요청(멘션)
- 리뷰/승인 후에만 머지
- 필요 시 슬랙/메신저 등으로 알림 활용
TIP
- 무료 플랜에서도 위와 같은 방법으로 충분히 리뷰 문화를 만들 예정입니다.
- 임시로 운영 후, 실제 부하와 팀 상황을 보고 정책을 더 보강하는 것도 추천!
- 자세한 Approvals 정책은 공식 문서 참고
