병합 요청 리뷰
병합 요청은 GitLab 프로젝트의 파일을 변경하는 주요 방법입니다. 병합 요청을 생성하고 제출하여 변경 사항을 제안하세요. 팀원들은 여러분의 병합 요청에 의견을 남기고, 사용자 인터페이스에서 수락할 수 있는 코드 제안을 합니다. 여러분의 작업이 검토되면, 팀원들은 수락하거나 거부할 수 있습니다.
여러분은 GitLab 인터페이스에서 병합 요청을 검토할 수 있습니다. GitLab Workflow VS Code 확장 프로그램을 설치하면 Visual Studio Code에서도 병합 요청을 검토할 수 있습니다.
개요는 병합 요청 리뷰를 확인하세요.
GitLab Duo 제안된 리뷰어
- GitLab 15.4에 도입, 기본적으로 꺼져 있는 Beta 기능으로 suggested_reviewers_control이라는 플래그로 제공됩니다.
- GitLab 15.6에서 GitLab.com에서 활성화됨.
- Beta 표시가 UI에서 제거됨 GitLab 15.10.
- 피쳐 플래그가 제거됨 GitLab 16.6.
GitLab은 머신러닝을 사용하여 병합 요청에 대한 리뷰어를 제안합니다.
개요는 GitLab Duo 제안된 리뷰어를 확인하세요.
리뷰어를 제안하기 위해 GitLab은 다음을 사용합니다:
- 병합 요청의 변경 내용
- 프로젝트의 기여 그래프
GitLab Duo 제안된 리뷰어는 코드 소유자, 프로필 상태 및 병합 요청 규칙과 통합되어 검토 기준을 충족하는 리뷰어를 선택할 때 보다 신중한 결정을 내릴 수 있도록 도와줍니다.
더 많은 정보는 GitLab Duo 제안된 리뷰어에서 데이터 사용를 참조하세요.
제안된 리뷰어 활성화
제안된 리뷰어를 활성화하면 GitLab이 프로젝트에 대한 ML 모델을 생성하여 리뷰어를 생성합니다. 프로젝트가 클수록 이 프로세스에는 더 많은 시간이 소요될 수 있습니다. 일반적으로 이 모델은 몇 시간 이내에 제안을 생성할 준비가 됩니다.
필수 조건:
- 프로젝트에서 소유자 또는 관리자 역할을 가지고 있어야 합니다.
다음을 수행합니다:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 설정 > 병합 요청을 선택합니다.
- 제안된 리뷰어로 스크롤하고 제안된 리뷰어 활성화를 선택합니다.
- 변경 사항 저장을 선택합니다.
기능을 활성화한 후에는 추가 조치가 필요하지 않습니다. 모델이 준비되면 새 커밋이 있는 병합 요청의 오른쪽 사이드바의 리뷰어 드롭다운 목록에 제안이 표시됩니다.
병합 요청 검토
병합 요청을 검토하면 여러분만 볼 수 있는 의견을 작성할 수 있습니다. 준비가 되면 이를 한 번에 게시할 수 있습니다. 검토를 시작하려면:
- 검토하려는 병합 요청으로 이동하여 변경 내용 탭을 선택합니다. 이 탭에 표시된 차이를 탐색하는 데 대한 자세한 내용은 병합 요청의 변경 사항를 참조하세요.
- 그터()에서 이 줄에 의견 추가를 선택하여 차이점 행을 확장하고 의견 상자를 표시합니다. GitLab 버전 13.2 이상에서는 여러 줄 선택이 가능합니다.
- 텍스트 영역에 첫 번째 의견을 작성한 후, 의견 아래에서 검토 시작을 선택합니다.
- 코드의 행에 의견을 계속 추가합니다. 각 의견 후에 검토에 추가를 선택합니다. 검토로 작성된 의견은 제출할 때까지 여러분만 볼 수 있습니다.
- 옵션입니다. 리뷰 의견 내에서 빠른 조작을 사용할 수 있습니다. 의견에 포함된 조작은 게시 후에 수행됩니다.
- 검토를 완료하면 검토 제출을 할 수 있습니다. 여러분의 의견은 이제 볼 수 있으며, 의견에 포함된 빠른 조작도 실행됩니다.
만약 병합 요청을 승인하고 리뷰어 목록에 표시되면, 여러분의 이름 옆에 녹색 확인 표시 가 표시됩니다.
리뷰 요청
병합 요청에 리뷰어를 할당하려면, 병합 요청의 텍스트 영역에서 /assign_reviewer @user 빠른 동작을 사용하십시오. 또는:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- Code > 병합 요청를 선택하여 병합 요청을 찾습니다.
- 오른쪽 사이드바에서 리뷰어 섹션에서 편집을 선택합니다.
- 할당하려는 사용자를 검색하여 사용자를 선택합니다.
병합 요청은 사용자의 리뷰 요청에 추가됩니다.
여러 사용자로부터
세부 정보: Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
병합 요청에 여러 리뷰어를 지정하려면, 병합 요청의 텍스트 영역에서 /assign_reviewer @user 빠른 동작을 사용하십시오. 또는:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- Code > 병합 요청를 선택하여 병합 요청을 찾습니다.
- 오른쪽 사이드바에서 리뷰어 섹션에서 편집을 선택합니다.
- 드롭다운 목록에서 병합 요청에 할당하려는 모든 사용자를 선택합니다.
리뷰어를 제거하려면, 동일한 드롭다운 목록에서 사용자를 지웁니다.
병합 요청 변경 사항을 diff로 다운로드
병합 요청에 포함된 변경 사항을 diff로 다운로드하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- Code > 병합 요청를 선택합니다.
- 병합 요청을 선택합니다.
- 오른쪽 상단 모퉁이에서 Code > 일반 diff를 선택합니다.
병합 요청의 URL을 알고 있다면, 명령줄에서 URL에 .diff를 추가하여 diff를 다운로드할 수도 있습니다. 다음 예제는 병합 요청 000000에 대한 diff를 다운로드합니다:
https://gitlab.com/gitlab-org/gitlab/-/merge_requests/000000.diff
diff를 다운로드하고 한 줄의 CLI 명령을 사용하여 diff를 적용합니다:
curl "https://gitlab.com/gitlab-org/gitlab/-/merge_requests/000000.diff" | git apply
병합 요청 변경 사항을 패치 파일로 다운로드
병합 요청에 포함된 변경 사항을 패치 파일로 다운로드하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- Code > 병합 요청를 선택합니다.
- 병합 요청을 선택합니다.
- 오른쪽 상단 모퉁이에서 Code > Patches를 선택합니다.
병합 요청의 URL을 알고 있다면, 명령줄에서 URL에 .patch를 추가하여 patch를 다운로드할 수도 있습니다. 다음 예제는 병합 요청 000000에 대한 패치 파일을 다운로드합니다:
https://gitlab.com/gitlab-org/gitlab/-/merge_requests/000000.patch
다운로드하고 git am을 사용하여 한 줄의 CLI 명령을 사용하여 패치를 적용합니다:
curl "https://gitlab.com/gitlab-org/gitlab/-/merge_requests/000000.patch" | git am
리뷰 제출
완료된 리뷰를 여러 가지 방법으로 제출할 수 있습니다:
- 비리뷰 코멘트의 텍스트에서
/submit_review빠른 동작을 사용합니다. -
리뷰 마침을 선택한 후 모달 창 하단의 리뷰 제출을 선택합니다. 모달 창에서 요약 코멘트를 제공하고, 병합 요청을 승인하고 빠른 동작을 포함할 수 있습니다.
리뷰를 제출하면 GitLab이:
- 리뷰의 코멘트를 게시합니다.
- 병합 요청의 알림 가능한 사용자에게 단일 이메일을 보내고 리뷰 코멘트를 첨부합니다. 이 이메일에 회신하면 병합 요청에 새 코멘트가 생성됩니다.
- 리뷰 코멘트에 추가한 빠른 동작을 수행합니다.
- 선택 사항. 승인 또는 변경 요청여부를 표시합니다:
- 코멘트: 명시적인 승인 없이 일반 피드백을 남깁니다.
- 승인: 피드백을 남기고 변경을 승인합니다.
- 변경 요청: 병합하기 전에 처리해야 할 피드백을 남깁니다.
코멘트로 쓰레드 해결 또는 미해결
리뷰 코멘트로 해결 가능한 쓰레드를 해결 또는 미해결로 설정할 수도 있습니다.
코멘트에 대한 쓰레드를 해결 또는 미해결로 설정하려면:
- 코멘트 텍스트 영역에 코멘트를 작성합니다.
- 쓰레드 해결 또는 쓰레드 해결 해제를 선택합니다.
- 지금 코멘트 추가 또는 리뷰에 추가를 선택합니다.
게시되면 쓰레드가 해결할 작업에 대한 정보가 표시됩니다:
- 쓰레드가 해결됨.
- 쓰레드가 해결되지 않음.
새로운 댓글 추가
진행 중인 검토가 있는 경우 개요 탭에서 리뷰에 추가를 선택하여 댓글을 추가할 수 있습니다:
리뷰어를 위한 승인 규칙 정보
새로운 병합 요청 또는 기존의 병합 요청에서 리뷰어 필드를 편집할 때 GitLab은 코멘트 작성자의 이름 아래 해당하는 승인 규칙 이름을 표시합니다. Code Owners는 그룹 세부 정보 없이 Codeowner로 표시됩니다.
다음 예시는 새로운 병합 요청을 생성할 때 리뷰어와 승인 규칙을 보여줍니다:
다음 예시는 병합 요청 사이드바에서 리뷰어 및 승인 규칙을 보여줍니다:
새로운 리뷰 요청
리뷰어가 병합 요청 검토를 완료한 후, 병합 요청 작성자는 리뷰어에게 새로운 리뷰를 요청할 수 있습니다:
- 병합 요청의 오른쪽 사이드바가 축소된 경우, 사이드바 확장 아이콘을 선택합니다.
- 리뷰어 섹션에서 리뷰어의 이름 옆에 있는 리뷰 요청 반복 아이콘 ()을 선택합니다.
GitLab은 리뷰어에 대한 새로운 할 일 항목을 생성하고 알림 이메일을 보냅니다.
여러 줄에 댓글 작성
코드 차이에 대해 댓글을 작성할 때, 다음 중 하나로 댓글이 참조할 코드 줄을 선택할 수 있습니다:
- 코드 차이에서 이 줄에 댓글 추가 ()을 드래그하여 코드 차이의 줄을 강조합니다. GitLab은 코드 차이 줄을 확장하고 댓글 상자를 표시합니다.
- 거터에서 이 줄에 댓글 추가 ()을 선택하여 댓글을 시작한 후, 코드 라인에 댓글 달기 선택 상자에서 댓글이 참조하는 첫 줄 번호를 선택합니다. 새 댓글은 다른 시작 줄을 선택하지 않는 이상 기본적으로 단일 줄 주석으로 설정됩니다.
여러 줄 주석은 댓글 본문 위에 댓글의 줄 번호를 표시합니다:
프로젝트 수준에서 병합 요청 일괄 편집
적어도 개발자 역할을 하는 사용자는 병합 요청을 관리할 수 있습니다.
프로젝트에서 병합 요청을 일괄 편집할 때, 다음과 같은 속성을 편집할 수 있습니다:
- 상태 (열림/닫힘)
- 담당자
- 마일스톤
- 레이블
- 구독
한꺼번에 여러 프로젝트 병합 요청을 업데이트하려면:
- 프로젝트에서 코드 > 병합 요청으로 이동합니다.
- 일괄 편집을 선택합니다. 화면 오른쪽에 사이드바가 편집 가능한 필드와 함께 나타납니다.
- 편집하려는 각 병합 요청 옆의 체크박스를 선택합니다.
- 사이드바에서 적절한 필드와 값을 선택합니다.
- 모두 업데이트를 선택합니다.
그룹 수준에서 병합 요청 일괄 편집
적어도 개발자 역할을 하는 사용자는 병합 요청을 관리할 수 있습니다.
그룹에서 병합 요청을 일괄 편집할 때, 다음과 같은 속성을 편집할 수 있습니다:
- 마일스톤
- 레이블
한꺼번에 여러 그룹 병합 요청을 업데이트하려면:
- 그룹에서 코드 > 병합 요청으로 이동합니다.
- 일괄 편집을 선택합니다. 화면 오른쪽에 사이드바가 편집 가능한 필드와 함께 나타납니다.
- 편집하려는 각 병합 요청 옆의 체크박스를 선택합니다.
- 사이드바에서 적절한 필드와 값을 선택합니다.
- 모두 업데이트를 선택합니다.
관련 기능
다음 기능들은 병합 요청과 관련이 있습니다:
- Cherry-pick changes: 병합된 병합 요청 또는 커밋에서 Cherry-pick 버튼을 선택하여 UI에서 어떤 커밋이든 cherry-pick.
- Fast-forward merge requests: 선형 Git 히스토리 및 병합 커밋을 만들지 않고 병합 요청을 수락하는 방법
- 변경 사항을 소개한 병합 요청 찾기: 커밋 세부 정보 페이지를 볼 때, 해당 커밋을 포함하는 병합 요청에 연결됩니다.
- 병합 요청 버전: 병합 요청의 다른 버전을 선택하고 비교할 수 있습니다
- 충돌 해결: GitLab은 GitLab UI에서 특정 병합 요청 충돌을 해결할 수 있는 옵션을 제공할 수 있습니다.
- 변경되돌리기: 병합 요청에서 어떤 커밋의 변경 사항을 되돌릴 수 있습니다.
- 키보드 단축키: 키보드 명령으로 병합 요청의 특정 부분에 액세스하고 수정할 수 있습니다.
도움말