병합 요청 검토

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

병합 요청은 GitLab 프로젝트 내에서 파일 변경을 제안하는 주요 방법입니다. 변경 사항을 제안하기 위해 병합 요청을 생성하고 제출합니다. 여러분의 팀은 병합 요청에 의견을 남기고, 사용자 인터페이스에서 제안을 받아들일 수 있습니다. 팀원이 여러분의 작업을 검토할 때, 해당 작업을 수락하거나 거부할 수 있습니다.

병합 요청을 검토하려면 다음을 사용할 수 있습니다:

개요는 병합 요청 검토를 참조하세요.

병합 요청의 검토 상태 보기

다음과 같이 진행할 수 있습니다:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Code > 병합 요청을 선택하고 병합 요청을 찾습니다.
  3. 병합 요청의 제목을 선택하여 보기를 누릅니다.
  4. 병합 요청 위젯으로 스크롤하여, 병합 요청의 병합 가능성 및 승인 상태를 확인할 수 있습니다. 예를 들어, 해당 병합 요청은 승인이 필요한 사항을 받지 못했기 때문에 차단되어 있습니다:

    병합 요청 위젯이 '모든 필요한 승인이 이루어져야 합니다'를 표시합니다.

각 리뷰어의 개별적인 검토 상태를 보려면, 병합 요청의 오른쪽 사이드바를 확인하세요. 각 리뷰어는 사용자 이름 오른쪽에 상태를 보여줍니다:

  • 이 사용자의 리뷰를 기다리는 중.
  • 사용자의 리뷰가 진행 중.
  • 해당 사용자가 승인함.
  • 사용자가 변경을 요청하고 병합 요청을 차단했습니다. (필요한 경우, 이 차단을 우회할 수 있습니다.)

리뷰 요청

병합 요청에 리뷰어를 할당하려면, 병합 요청의 텍스트 영역에서 /assign_reviewer @user 빠른 조치를 사용하거나 다음을 수행하세요:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Code > 병합 요청을 선택하고 병합 요청을 찾습니다.
  3. 병합 요청의 제목을 선택하여 보기를 누릅니다.
  4. 오른쪽 사이드바에서 리뷰어 섹션에서 편집을 선택합니다.
  5. 지정하려는 사용자를 검색하고 해당 사용자를 선택하세요.

GitLab은 해당 병합 요청을 사용자의 리뷰 요청에 추가합니다.

댓글을 통해 스레드를 해결하거나 해제합니다

리뷰 댓글에서도 해결 가능한 스레드를 해결하거나 해제할 수 있습니다. 댓글에 답장할 때 스레드를 해결하거나 해제하려면:

  1. 댓글 텍스트 영역에 댓글을 작성합니다.
  2. 스레드 해결을 선택하거나 선택 해제합니다.
  3. 지금 댓글 추가 또는 리뷰에 추가를 선택합니다.

대기 중인 댓글은 댓글이 게시될 때까지 지연된 작업에 대한 정보를 표시합니다:

  • 스레드가 해결됨.
  • 스레드가 해제됨.

리뷰 제출

완료된 리뷰를 제출하려면 다음을 수행할 수 있습니다:

  • 비-리뷰 댓글의 텍스트에서 /submit_review 빠른 조치를 사용합니다.
  • 리뷰 완료를 선택한 다음 대화 상자 하단의 리뷰 제출을 선택합니다. 대화 상자에서 Summary comment을 제공하고, 병합 요청을 승인 또는 거부하며, 빠른 조치를 포함할 수 있습니다:

    주석과 함께 리뷰 완료

리뷰를 제출하면 GitLab이:

  • 리뷰의 댓글을 게시합니다.
  • 병합 요청의 모든 통지 가능한 사용자에게 단일 이메일을 보내고, 리뷰 댓글을 첨부합니다. 이 이메일에 회신하면 병합 요청에 새 댓글이 생성됩니다.
  • 리뷰 댓글에 추가한 빠른 조치를 수행합니다.
  • 선택사항. 당신이 승인 했거나 변경을 요청했는지 여부를 표시합니다:
    • 주석: 명시적 승인 없이 일반적인 피드백을 남깁니다.
    • 승인: 피드백을 남기고 변경 사항을 승인합니다.
    • 변경 요청: 피드백이 처리되기 전까지 병합 요청의 병합을 막습니다.

변경 요청을 요청한 경우에는 병합할 수 없도록

Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

리뷰어가 변경을 요청하면, 병합 요청의 병합이 막힙니다. 이런 경우에 병합을 해제하려면 변겅을 요청한 리뷰어가 해당 병합 요청을 재검토하고 승인해야합니다.

변경 요청의 우회

변경을 요청한 사용자가 다시 검토하거나 승인을 제공할 수 없는 경우, 병합 요청을 병합할 권한이 있는 다른 사용자는 병합 요청 보고서 영역에서 우회를 선택하여 이 확인을 무시할 수 있습니다:

  1. 왼쪽 사이드바에서 검색 또는 이동를 선택하고 프로젝트를 찾습니다.
  2. 코드 > 병합 요청를 선택하고 병합 요청을 찾습니다.
  3. 병합 요청 제목을 선택하여 병합 요청을 보려합니다.
  4. 병합 요청 개요에서 병합 요청 보고서 영역으로 스크롤합니다.
  5. 변경 요청이 완료되거나 해결되어야 함 옆의 우회를 선택합니다.

    사용자가 변경을 요청하여 막힌 병합 요청

  6. 병합 보고서 영역에 병합 주의: 우회 추가됨이 표시됩니다. 무시된 검사를 확인하려면 병합 확인 확장 ()을 선택하고 경고 () 아이콘을 포함한 확인 항목을 찾으세요. 이 예에서, 작성자는 변경 요청이 완료되거나 해결되어야 함을 우회했습니다:

    병합 요청에 무시된 확인이 포함되어 있으며 주의하여 병합되어야 합니다.

리뷰어가 승인 규칙에 매핑되는 방법 확인

Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

병합 요청을 만들 때, 당신은 만드는 변경에 대한 전문가의 리뷰를 요청하고 싶어할 것입니다. 당신의 병합 요청에 대한 리뷰 주기를 줄이기 위해, 프로젝트의 승인 규칙에 나열된 사용자들로부터 리뷰를 요청하는 것을 고려해보세요.

새로운 병합 요청이나 기존의 병합 요청의 리뷰어 필드를 편집할 때, GitLab은 각 리뷰어의 이름 아래에 일치하는 승인 규칙을 표시합니다. Code Owners는 어떤 그룹 정보 없이 Codeowner로 표시됩니다.

병합 요청 만들거나 편집하기
  1. 새로운 병합 요청을 만들거나 기존 병합 요청을 편집할 때, 리뷰어를 선택합니다.
  2. 원하는 리뷰어의 이름을 입력하기 시작하세요. 코드 소유자이거나 승인 규칙과 일치하는 사용자에 대한 자세한 정보를 표시합니다:

    새로운/편집 폼에서 리뷰어 승인 규칙

병합 요청 리뷰하기
  1. 왼쪽 사이드바에서 검색 또는 이동를 선택하고 프로젝트를 찾습니다.
  2. 코드 > 병합 요청를 선택합니다.
  3. 병합 요청을 선택합니다.
  4. 오른쪽 사이드바에서 리뷰어 옆의 편집을 선택합니다.
  5. 원하는 리뷰어의 이름을 입력하기 시작하세요. 코드 소유자이거나 승인 규칙과 일치하는 사용자에 대한 자세한 정보를 표시합니다:

    측면에서의 리뷰어 승인 규칙

병합 요청의 변경 사항 다운로드

diff로

병합 요청에 포함된 변경 사항을 diff로 다운로드하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동를 선택하고 프로젝트를 찾습니다.
  2. 코드 > 병합 요청를 선택합니다.
  3. 병합 요청을 선택합니다.
  4. 오른쪽 상단 모서리에서 코드 > 일반 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

패치 파일로

병합 요청에 포함된 변경 사항을 패치 파일로 다운로드하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Code > Merge requests를 선택합니다.
  3. 병합 요청을 선택합니다.
  4. 오른쪽 상단 모서리에서 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

제안된 리뷰어

Tier: Ultimate Offering: GitLab.com

GitLab은 기계 학습을 사용하여 귀하의 병합 요청에 대한 리뷰어를 제안합니다.

GitLab은 리뷰어를 제안하기 위해 다음을 활용합니다:

  • 병합 요청의 변경 내용
  • 프로젝트의 기여도 그래프

제안된 리뷰어는 또한 Code Owners, 프로필 상태, 병합 요청 규칙과 통합됩니다. 리뷰 기준을 충족시킬 수 있는 리뷰어를 선택할 때 더 명확한 결정을 내릴 수 있도록 도와줍니다.

리뷰어 목록

자세한 정보는 제안된 리뷰어의 데이터 사용을 참조하십시오.

제안된 리뷰어 활성화

제안된 리뷰어를 활성화하면 GitLab이 귀하의 프로젝트에 사용되는 기계 학습 모델을 생성합니다. 프로젝트가 클수록 이 프로세스에는 더 많은 시간이 소요될 수 있습니다. 보통 몇 시간 뒤에 모델이 제안을 생성할 준비가 됩니다.

전제 조건:

  • 프로젝트에 Owner 또는 Maintainer 역할이 있어야 합니다.

다음을 수행하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Settings > Merge requests를 선택합니다.
  3. Suggested reviewers로 스크롤하고 제안된 리뷰어 활성화를 선택합니다.
  4. 변경 사항 저장을 선택합니다.

기능을 활성화한 후에는 추가 조치가 필요하지 않습니다. 모델이 준비되면 새 커밋이 있는 병합 요청의 오른쪽 사이드바에 있는 리뷰어 드롭다운 목록에 추천이 표시됩니다.

관련 기능

병합 요청은 다음 기능과 관련이 있습니다:

관련 주제