병합 요청 검토
병합 요청은 GitLab 프로젝트 내에서 파일 변경을 제안하는 주요 방법입니다. 변경 사항을 제안하기 위해 병합 요청을 생성하고 제출합니다. 여러분의 팀은 병합 요청에 의견을 남기고, 사용자 인터페이스에서 제안을 받아들일 수 있습니다. 팀원이 여러분의 작업을 검토할 때, 해당 작업을 수락하거나 거부할 수 있습니다.
병합 요청을 검토하려면 다음을 사용할 수 있습니다:
- GitLab 인터페이스.
- Visual Studio Code, Visual Studio Code를 위한 GitLab Workflow 확장을 구성했다면.
- 필요한 경우 GitLab CLI를 구성했다면 터미널 창.
개요는 병합 요청 검토를 참조하세요.
병합 요청의 검토 상태 보기
다음과 같이 진행할 수 있습니다:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- Code > 병합 요청을 선택하고 병합 요청을 찾습니다.
- 병합 요청의 제목을 선택하여 보기를 누릅니다.
-
병합 요청 위젯으로 스크롤하여, 병합 요청의 병합 가능성 및 승인 상태를 확인할 수 있습니다. 예를 들어, 해당 병합 요청은 승인이 필요한 사항을 받지 못했기 때문에 차단되어 있습니다:
각 리뷰어의 개별적인 검토 상태를 보려면, 병합 요청의 오른쪽 사이드바를 확인하세요. 각 리뷰어는 사용자 이름 오른쪽에 상태를 보여줍니다:
- 이 사용자의 리뷰를 기다리는 중.
- 사용자의 리뷰가 진행 중.
- 해당 사용자가 승인함.
- 사용자가 변경을 요청하고 병합 요청을 차단했습니다. (필요한 경우, 이 차단을 우회할 수 있습니다.)
리뷰 요청
병합 요청에 리뷰어를 할당하려면, 병합 요청의 텍스트 영역에서 /assign_reviewer @user
빠른 조치를 사용하거나 다음을 수행하세요:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- Code > 병합 요청을 선택하고 병합 요청을 찾습니다.
- 병합 요청의 제목을 선택하여 보기를 누릅니다.
- 오른쪽 사이드바에서 리뷰어 섹션에서 편집을 선택합니다.
- 지정하려는 사용자를 검색하고 해당 사용자를 선택하세요.
GitLab은 해당 병합 요청을 사용자의 리뷰 요청에 추가합니다.
댓글을 통해 스레드를 해결하거나 해제합니다
리뷰 댓글에서도 해결 가능한 스레드를 해결하거나 해제할 수 있습니다. 댓글에 답장할 때 스레드를 해결하거나 해제하려면:
- 댓글 텍스트 영역에 댓글을 작성합니다.
- 스레드 해결을 선택하거나 선택 해제합니다.
- 지금 댓글 추가 또는 리뷰에 추가를 선택합니다.
대기 중인 댓글은 댓글이 게시될 때까지 지연된 작업에 대한 정보를 표시합니다:
- 스레드가 해결됨.
- 스레드가 해제됨.
리뷰 제출
완료된 리뷰를 제출하려면 다음을 수행할 수 있습니다:
- 비-리뷰 댓글의 텍스트에서
/submit_review
빠른 조치를 사용합니다. -
리뷰 완료를 선택한 다음 대화 상자 하단의 리뷰 제출을 선택합니다. 대화 상자에서 Summary comment을 제공하고, 병합 요청을 승인 또는 거부하며, 빠른 조치를 포함할 수 있습니다:
리뷰를 제출하면 GitLab이:
- 리뷰의 댓글을 게시합니다.
- 병합 요청의 모든 통지 가능한 사용자에게 단일 이메일을 보내고, 리뷰 댓글을 첨부합니다. 이 이메일에 회신하면 병합 요청에 새 댓글이 생성됩니다.
- 리뷰 댓글에 추가한 빠른 조치를 수행합니다.
- 선택사항. 당신이 승인 했거나 변경을 요청했는지 여부를 표시합니다:
- 주석: 명시적 승인 없이 일반적인 피드백을 남깁니다.
- 승인: 피드백을 남기고 변경 사항을 승인합니다.
- 변경 요청: 피드백이 처리되기 전까지 병합 요청의 병합을 막습니다.
변경 요청을 요청한 경우에는 병합할 수 없도록
리뷰어가 변경을 요청하면, 병합 요청의 병합이 막힙니다. 이런 경우에 병합을 해제하려면 변겅을 요청한 리뷰어가 해당 병합 요청을 재검토하고 승인해야합니다.
변경 요청의 우회
변경을 요청한 사용자가 다시 검토하거나 승인을 제공할 수 없는 경우, 병합 요청을 병합할 권한이 있는 다른 사용자는 병합 요청 보고서 영역에서 우회를 선택하여 이 확인을 무시할 수 있습니다:
- 왼쪽 사이드바에서 검색 또는 이동를 선택하고 프로젝트를 찾습니다.
- 코드 > 병합 요청를 선택하고 병합 요청을 찾습니다.
- 병합 요청 제목을 선택하여 병합 요청을 보려합니다.
- 병합 요청 개요에서 병합 요청 보고서 영역으로 스크롤합니다.
-
변경 요청이 완료되거나 해결되어야 함 옆의 우회를 선택합니다.
-
병합 보고서 영역에
병합 주의: 우회 추가됨
이 표시됩니다. 무시된 검사를 확인하려면 병합 확인 확장 ()을 선택하고 경고 () 아이콘을 포함한 확인 항목을 찾으세요. 이 예에서, 작성자는 변경 요청이 완료되거나 해결되어야 함을 우회했습니다:
리뷰어가 승인 규칙에 매핑되는 방법 확인
병합 요청을 만들 때, 당신은 만드는 변경에 대한 전문가의 리뷰를 요청하고 싶어할 것입니다. 당신의 병합 요청에 대한 리뷰 주기를 줄이기 위해, 프로젝트의 승인 규칙에 나열된 사용자들로부터 리뷰를 요청하는 것을 고려해보세요.
새로운 병합 요청이나 기존의 병합 요청의 리뷰어 필드를 편집할 때, GitLab은 각 리뷰어의 이름 아래에 일치하는 승인 규칙을 표시합니다.
Code Owners는 어떤 그룹 정보 없이 Codeowner
로 표시됩니다.
- 새로운 병합 요청을 만들거나 기존 병합 요청을 편집할 때, 리뷰어를 선택합니다.
-
원하는 리뷰어의 이름을 입력하기 시작하세요. 코드 소유자이거나 승인 규칙과 일치하는 사용자에 대한 자세한 정보를 표시합니다:
병합 요청의 변경 사항 다운로드
diff로
병합 요청에 포함된 변경 사항을 diff로 다운로드하려면:
- 왼쪽 사이드바에서 검색 또는 이동를 선택하고 프로젝트를 찾습니다.
- 코드 > 병합 요청를 선택합니다.
- 병합 요청을 선택합니다.
- 오른쪽 상단 모서리에서 코드 > 일반 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 > Merge requests를 선택합니다.
- 병합 요청을 선택합니다.
- 오른쪽 상단 모서리에서 Code > Patches를 선택합니다.
병합 요청의 URL을 알고 있다면 URL에 .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
제안된 리뷰어
GitLab은 기계 학습을 사용하여 귀하의 병합 요청에 대한 리뷰어를 제안합니다.
GitLab은 리뷰어를 제안하기 위해 다음을 활용합니다:
- 병합 요청의 변경 내용
- 프로젝트의 기여도 그래프
제안된 리뷰어는 또한 Code Owners, 프로필 상태, 병합 요청 규칙과 통합됩니다. 리뷰 기준을 충족시킬 수 있는 리뷰어를 선택할 때 더 명확한 결정을 내릴 수 있도록 도와줍니다.
자세한 정보는 제안된 리뷰어의 데이터 사용을 참조하십시오.
제안된 리뷰어 활성화
제안된 리뷰어를 활성화하면 GitLab이 귀하의 프로젝트에 사용되는 기계 학습 모델을 생성합니다. 프로젝트가 클수록 이 프로세스에는 더 많은 시간이 소요될 수 있습니다. 보통 몇 시간 뒤에 모델이 제안을 생성할 준비가 됩니다.
전제 조건:
- 프로젝트에 Owner 또는 Maintainer 역할이 있어야 합니다.
다음을 수행하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- Settings > Merge requests를 선택합니다.
- Suggested reviewers로 스크롤하고 제안된 리뷰어 활성화를 선택합니다.
- 변경 사항 저장을 선택합니다.
기능을 활성화한 후에는 추가 조치가 필요하지 않습니다. 모델이 준비되면 새 커밋이 있는 병합 요청의 오른쪽 사이드바에 있는 리뷰어 드롭다운 목록에 추천이 표시됩니다.
관련 기능
병합 요청은 다음 기능과 관련이 있습니다:
- 변경 사항 차리(Cherry-pick): GitLab UI에서 병합된 병합 요청 또는 커밋에서 Cherry-pick을 선택합니다.
- 빠른 전진 병합 요청: 선형 Git 기록 및 병합 커밋을 생성하지 않고 병합 요청을 수락하는 방법
- 병합 요청에 변경 사항을 도입한 요청 찾기: 커밋 세부 정보 페이지를 볼 때 GitLab은 해당 커밋을 포함하는 병합 요청에 연결합니다.
- 병합 요청 버전: 병합 요청의 다른 버전을 선택하고 비교합니다.
- 충돌 해결: GitLab은 특정 병합 요청 충돌을 해결할 옵션을 제공할 수 있습니다.
- 변경 사항 되돌리기: 병합 요청에서 어떤 커밋의 변경 사항 되돌리기.
- 키보드 단축키: 키보드 명령으로 병합 요청의 특정 부분에 액세스하고 변경합니다.