병합 요청 검토

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

병합 요청은 GitLab 프로젝트의 파일을 변경하는 주요 방법입니다. 변경 사항을 제안하기 위해 병합 요청을 생성하고 제출하세요. 팀원은 병합 요청에 대해 댓글을 남기고, 사용자 인터페이스에서 수락할 수 있는 제안을 합니다. 팀원이 여러분의 작업을 검토하면, 수락 또는 거부를 선택할 수 있습니다.

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


개요를 보려면 병합 요청 검토를 참조하세요.

병합 요청의 검토 상태 보기

이를 수행하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 코드 > 병합 요청을 선택하고 병합 요청을 찾습니다.
  3. 병합 요청의 제목을 선택하여 봅니다.

  4. 병합 요청 위젯로 스크롤하여 병합 가능성과 승인 상태를 확인합니다. 예를 들어, 이 병합 요청은 필요한 승인을 받지 못했기 때문에 차단되어 있습니다:

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

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

검토 요청

병합 요청에 검토자를 할당하려면, 병합 요청의 텍스트 영역에서 /assign_reviewer @user 빠른 액션을 사용하거나:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 코드 > 병합 요청을 선택하고 병합 요청을 찾습니다.
  3. 병합 요청 제목을 선택하여 봅니다.
  4. 오른쪽 사이드바의 검토자 섹션에서 편집을 선택합니다.
  5. 할당할 사용자를 검색하고 선택합니다.

GitLab은 사용자의 검토 요청에 병합 요청을 추가합니다.

여러 사용자로부터

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

병합 요청에 여러 검토자를 할당하려면, 병합 요청의 텍스트 영역에서 /assign_reviewer @user1 @user2 빠른 액션을 사용하거나:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 코드 > 병합 요청을 선택하고 병합 요청을 찾습니다.
  3. 병합 요청 제목을 선택하여 봅니다.
  4. 오른쪽 사이드바의 검토자 섹션에서 편집을 선택합니다.
  5. 드롭다운 목록에서 병합 요청에 할당할 모든 사용자를 선택합니다.

검토자를 제거하려면 동일한 드롭다운 목록에서 사용자를 지웁니다.

리뷰 재요청

리뷰어가 병합 요청 검토를 완료한 후,

병합 요청의 저자는 리뷰어에게 새로운 리뷰를 요청할 수 있습니다:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 귀하의 프로젝트를 찾습니다.

  2. 코드 > 병합 요청을 선택하고 귀하의 병합 요청을 찾습니다.

  3. 병합 요청 제목을 선택하여 확인합니다.

  4. 병합 요청에서 오른쪽 사이드바를 축소한 경우, 사이드바 확장을 선택하여 확장합니다.

  5. 검토자 섹션에서 리뷰어 이름 옆의 리뷰 재요청 아이콘( )을 선택합니다.

GitLab은 리뷰어를 위한 새로운 할 일 항목을 생성하고,

알림 이메일을 발송합니다.

리뷰 시작하기

사용자가 당신에게 병합 요청을 검토해 달라고 요청한 경우:

  1. 다음 중 하나를 선택합니다:
    • Shift + r를 눌러 검토 요청 페이지로 이동합니다.
    • 왼쪽 사이드바에서 병합 요청( ) > 검토 요청을 선택합니다.

  2. 귀하의 병합 요청을 찾아 병합 요청 제목을 선택하여 확인합니다.

  3. 병합 요청 설명 및 주석을 읽고 병합 요청에 대해 알아봅니다.

  4. 변경 사항을 선택하여 제안된 변경 사항의 차이를 봅니다. 변경 사항 페이지에 대한 더 자세한 내용은 병합 요청의 변경 사항을 참조하십시오.

  5. 필요에 따라 다중 행 또는 단일 행 변경 사항 제안을 합니다. 지금 댓글 추가 대신 리뷰 시작하기를 선택하면,

당신의 리뷰 댓글은 리뷰가 완료될 때까지 비공식 상태로 유지됩니다.

  1. 리뷰 시작하기를 선택한 후 추가적인 댓글을 작성하려면, 다음에서 리뷰에 추가합니다:
    • 차이 뷰가 포함된 변경 사항 탭입니다.
    • 개요 탭에서 리뷰에 추가를 선택합니다:

    새 스레드

  2. 리뷰 제출을 선택하여 리뷰 시작하기 또는 리뷰에 추가로 추가된 모든 리뷰 댓글을 게시합니다.

리뷰 제출 전까지는 이러한 댓글이 비공식 상태로 유지됩니다.

댓글로 스레드 해결 또는 해결 해제

리뷰 댓글은 해결 가능한 스레드를 해결하거나 해결 해제를 할 수도 있습니다.

댓글에 답변할 때 스레드를 해결하거나 해결 해제하려면:

  1. 댓글 텍스트 영역에 댓글을 작성합니다.

  2. 스레드 해결을 선택하거나 해제합니다.

  3. 지금 댓글 추가 또는 리뷰에 추가를 선택합니다.

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

  • 스레드가 해결되었습니다.
  • 스레드는 해결되지 않았습니다.

리뷰 제출

완료된 리뷰를 제출하려면 다음과 같이 할 수 있습니다:

  • 비리뷰 댓글 텍스트에서 /submit_review 빠른 작업을 사용합니다.

  • 리뷰 완료를 선택한 후 대화 상자 하단에서 리뷰 제출을 선택합니다.

대화 상자에서 요약 댓글을 입력하고 병합 요청을 승인(또는 거부)하며,

빠른 작업을 포함할 수 있습니다:

댓글과 함께 리뷰 완료

리뷰를 제출하면 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은 각 검토자 이름 아래에 일치하는 승인 규칙을 보여줍니다.
코드 소유자는 그룹 세부 정보 없이 Codeowner로 표시됩니다.

병합 요청 생성 또는 편집
  1. 새 병합 요청을 생성하거나 기존의 병합 요청을 편집할 때 검토자를 선택합니다.

  2. 원하는 검토자의 이름을 입력하기 시작합니다. 코드 소유자이거나 승인 규칙과 일치하는 사용자는 사용자 이름 아래에 더 많은 정보를 표시합니다:

    새/편집 양식에서의 검토자 승인 규칙

병합 요청 검토
  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 코드 > 병합 요청을 선택합니다.
  3. 병합 요청을 선택합니다.
  4. 오른쪽 사이드바에서 검토자 옆에 있는 편집을 선택합니다.

  5. 원하는 검토자의 이름을 입력하기 시작합니다. 코드 소유자이거나 승인 규칙과 일치하는 사용자는 사용자 이름 아래에 더 많은 정보를 표시합니다:

    사이드바에서의 검토자 승인 규칙

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

차이로서

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

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

병합 요청의 URL을 알고 있다면, URL 끝에 .diff를 추가하여 명령줄에서 차이를 다운로드할 수 있습니다. 이 예시는 병합 요청 000000의 차이를 다운로드합니다:

https://gitlab.com/gitlab-org/gitlab/-/merge_requests/000000.diff

한 줄 CLI 명령으로 차이를 다운로드하고 적용하려면:

curl "https://gitlab.com/gitlab-org/gitlab/-/merge_requests/000000.diff" | git apply

패치 파일로서

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

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 코드 > 병합 요청을 선택합니다.
  3. 병합 요청을 선택합니다.
  4. 오른쪽 상단에서 코드 > 패치를 선택합니다.

병합 요청의 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은:

  • 병합 요청의 변경 사항
  • 프로젝트의 기여 그래프

제안된 검토자는 코드 소유자, 프로필 상태 및 병합 요청 규칙과 통합됩니다.

검토자 선택 시 보다 정보에 기반한 결정을 내리는 데 도움을 줍니다.

검토자 목록.

자세한 내용은 제안된 검토자에서 데이터 사용을 참조하세요.

제안된 검토자 활성화

제안된 검토자 활성화는 GitLab이 프로젝트가 검토자를 생성하는 데 사용하는 기계 학습 모델을 생성하도록 트리거합니다.

프로젝트가 클수록 이 프로세스에 소요되는 시간은 길어질 수 있습니다. 일반적으로 모델은 몇 시간 후에 제안 생성을 준비합니다.

전제 조건:

  • 프로젝트에 대한 소유자 또는 유지 관리자의 역할을 가지고 있어야 합니다.

이렇게 하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 병합 요청을 선택합니다.
  3. 제안된 검토자로 스크롤하고 제안된 검토자 활성화를 선택합니다.
  4. 변경 사항 저장을 선택합니다.

기능을 활성화한 후에는 추가 조치가 필요하지 않습니다. 모델이 준비되면 새로운 커밋이 있는 병합 요청의 오른쪽 사이드바에 있는 검토자 드롭다운 목록에 추천이 채워집니다.

관련 기능

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

  • 체리 픽 변경 사항: GitLab UI에서 병합된 병합 요청 또는 커밋에서 체리 픽을 선택하여 이를 체리 픽하세요.

  • 패스트 포워드 병합 요청: 선형 Git 이력을 위한 방법과 병합 커밋을 생성하지 않고 병합 요청을 수락하는 방법

  • 변화를 도입한 병합 요청 찾기: 커밋 세부정보 페이지를 볼 때, GitLab은 해당 커밋을 포함하는 병합 요청에 링크합니다.

  • 병합 요청 버전: 병합 요청 차이의 다양한 버전을 선택하고 비교하세요.

  • 충돌 해결: GitLab은 GitLab UI에서 특정 병합 요청 충돌을 해결할 수 있는 옵션을 제공할 수 있습니다.

  • 변경 사항 되돌리기: 병합 요청의 모든 커밋에서 변경 사항을 되돌리세요.

  • 키보드 단축키: 키보드 명령으로 병합 요청의 특정 부분에 액세스하고 변경하세요.

관련 주제