끌어오기 요청 완료, 중단 또는 되돌리기

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020 | 2019년 Azure DevOps Server | TFS 2018

Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015

모든 필수 검토자가 PR(끌어오기 요청)을 승인하고 PR이 모든 분기 정책 요구 사항을 충족하면 변경 내용을 대상 분기에 병합하고 PR을 완료할 수 있습니다. 또는 PR의 변경 내용을 진행하지 않기로 결정한 경우 PR을 포기할 수 있습니다.

검토자의 변경 내용을 해결하고 검토 주석에 응답하고 해결하려면 주소 주석을 참조하세요.

사전 요구 사항

  • 프로젝트에서 리포지토리를 사용하도록 설정해야 합니다. 리포지토리 허브 및 연결된 페이지가 표시되지 않는 경우 Azure DevOps 서비스를 다시 사용하도록 설정 또는 해제를 참조하세요.

  • PR을 완료하려면 PR이 있는 프로젝트에서 기여자 보안 그룹의 구성원이거나 해당 권한이 있어야 합니다.

  • PR에 기여하려면 읽기 권한자 보안 그룹의 구성원이거나 해당 권한이 있어야 합니다.

  • PR을 보거나 검토하려면 Azure DevOps 프로젝트에 대한 기본 이상의 액세스 권한이 있어야 합니다.

  • 참여하려는 프로젝트의 멤버가 아닌 경우 추가됩니다.

    참고

    퍼블릭 프로젝트의 경우 관련자 액세스 권한이 부여된 사용자는 Azure Repos 대한 모든 권한을 갖습니다.

  • 프로젝트에서 리포지토리를 사용하도록 설정해야 합니다. 리포지토리 허브 및 연결된 페이지가 표시되지 않는 경우 Azure DevOps 서비스를 다시 사용하도록 설정 또는 해제를 참조하세요.
  • PR을 완료하려면 변경하려는 프로젝트에서 기여자 보안 그룹의 구성원이거나 해당 권한이 있어야 합니다.
  • PR에 기여하려면 읽기 권한자 보안 그룹의 구성원이거나 해당 권한이 있어야 합니다.
  • PR을 보거나 검토하려면 기본 액세스 이상의 Azure DevOps 프로젝트의 멤버여야 합니다. 프로젝트 멤버가 아닌 경우 추가됩니다.
  • PR을 완료하려면 Azure DevOps 프로젝트에 대한 기여자 보안 그룹의 구성원이거나 해당 권한이 있어야 합니다.
  • PR을 보거나 검토하려면 기본 액세스 이상의 Azure DevOps 프로젝트의 멤버여야 합니다. 프로젝트 멤버가 아닌 경우 추가됩니다.
  • PR에 기여하려면 Azure DevOps 프로젝트에 대한 읽기 권한자 보안 그룹의 구성원이거나 해당 권한이 있어야 합니다.

병합 변경 내용 확인

PR을 완료하면 Git에서 주 분기의 끝에 새 병합 커밋 을 추가합니다. 이 병합 커밋은 주 분기와 PR 원본 분기의 이전 기록을 연결합니다. 병합 커밋 미리 보기를 보고 병합 충돌을 확인하려면 PR 개요 페이지에서 오른쪽 위에 있는 기타 옵션 메뉴를 선택한 다음 병합 변경 내용 보기를 선택합니다.

PR을 만든 후 대상 분기를 변경한 경우 병합 다시 시작을 선택하여 새 미리 보기 병합 커밋을 만들고 병합 변경 차이 보기를 업데이트합니다.

P R의 기타 옵션 메뉴에서 병합 보기 및 병합 다시 시작 옵션을 보여 주는 스크린샷

분기 정책 검토

Teams는 PR이 병합되기 전에 보호된 분기의 PR이 특정 조건을 충족하도록 요구하는 분기 정책을 설정할 수 있습니다. PR에 적용되는 분기 정책, 병합에 필요한지 여부 및 PR이 통과 또는 실패하는지 여부를 확인할 수 있습니다.

PR 개요 탭에는 PR을 통과하거나 실패하는 분기 정책이 요약되어 있습니다. 개요는 실패한 정책만 나열하지만 보기 n> 검사를 선택하여 <모든 정책 검사를 볼 수 있습니다.

PR 개요 페이지에서 분기 정책 요구 사항에 아이콘이 있습니다 . 요구 사항 옆에 있는 추가 옵션을 선택한 다음 정책 보기를 선택하여 프로젝트 설정에서 분기의 분기 정책 페이지로 이동합니다.

P R의 분기 정책 요구 사항 옆에 있는 정책 보기를 보여 주는 스크린샷

끌어오기 요청 완료

병합 충돌을 해결하고 PR이 모든 분기 정책을 충족하고 필요한 모든 승인을 받은 후에 PR을 완료할 수 있습니다.

  1. 오른쪽 위에서 완료 를 선택하여 PR을 완료합니다. 또는 완료 단추 옆에 있는 드롭다운 화살표를 선택하고 옵션 중 하나를 선택합니다.

    P R에 대한 완료 단추 옵션을 보여 주는 스크린샷

    • 완료: 이제 PR을 완료하고 변경 내용을 대상 분기에 병합합니다.
    • 자동 완성 설정: 필요한 모든 분기 정책을 충족하면 PR을 완료하고 병합하도록 구성합니다.
    • 초안으로 표시: PR을 초안 상태로 반환하고 모든 투표를 제거합니다.
    • 중단: 변경 내용을 병합하지 않고 PR을 닫습니다.
  2. 끌어오기 요청 완료 창의 병합 유형에서 병합 옵션 중 하나를 선택합니다.

    전체 P R 대화 상자를 보여 주는 스크린샷

    • 병합(빠른 전달 없음): 모든 커밋을 유지하는 비선형 기록과 병합합니다.
    • Squash 커밋: 모든 원본 커밋을 대상의 단일 커밋으로 결합하는 선형 기록과 병합하거나, 스쿼시가 PR을 병합합니다 .
    • 다시 기반 및 빠른 전달: 원본 커밋을 대상에 다시 지정하고 빠르게 전달합니다.
    • 반선형 병합: 원본 커밋을 대상에 다시 지정하고 두 부모 병합을 만듭니다.

    참고

    기존 정책이 적용됩니다. 예를 들어 분기에 현재 "스쿼시 병합만" 정책이 있는 경우 다른 병합 형식을 사용하려면 해당 정책을 변경해야 합니다.

  3. 다음 완료 후 옵션을 선택합니다. 일부 병합 형식에는 일부 옵션을 사용할 수 없습니다.

    • 병합 후 연결된 작업 항목 완료: 연결된 작업 항목을 완료합니다.
    • 병합 후 분기 이름> 삭제<: 병합 후 PR의 원본 분기를 삭제합니다.
    • 병합 커밋 메시지 사용자 지정: 사용자 지정 병합 커밋 메시지를 추가합니다. 이 옵션을 선택하면 병합 커밋 메시지를 업데이트합니다.
    • 분기 정책을 재정의하고 병합을 사용하도록 설정합니다. PR이 모든 분기 정책을 충족하지 않더라도 병합을 강제로 적용합니다. 이 옵션은 정책 적용 권한에서 제외 된 경우에만 사용할 수 있습니다.
  4. 병합 완료를 선택합니다.

  1. 오른쪽 위에서 완료 를 선택하여 PR을 완료합니다. 또는 완료 단추 옆에 있는 드롭다운 화살표를 선택하고 다음 옵션 중 하나를 선택합니다.

    PR에 대한 완료 단추 옵션을 보여 주는 스크린샷.

    • 완료: 이제 PR을 완료하고 변경 내용을 대상 분기에 병합합니다.
    • 자동 완성 설정: 분기 정책이 있는 경우 필요한 모든 분기 정책을 충족하면 PR을 완료하고 병합하도록 구성합니다.
    • 중단: 변경 내용을 병합하지 않고 PR을 닫습니다.
  2. 끌어오기 요청 완료 화면에서 병합 커밋에 대한 메시지를 입력하고 PR 설명을 업데이트합니다.

    끌어오기 요청 완료 대화 상자

  3. 다음 옵션 중 하나를 선택합니다.

    • 병합한 후 연결된 작업 항목을 완료 하여 연결된 작업 항목을 완료합니다.

    • 병합한 후 삭제 <branch name> 하여 PR에서 원본 분기를 삭제합니다.

    • 스쿼시 병합 시 스쿼시가 PR을병합 할 때 변경합니다.

    • 분기 정책을 재정의하고 병합을 사용하도록 설정 하여 분기가 모든 분기 정책을 충족하지 않더라도 병합하도록 합니다. 이 옵션은 정책 적용 권한에서 제외 된 경우에만 사용할 수 있습니다.

      참고

      기존 정책은 여전히 적용됩니다. 예를 들어 분기에 현재 "스쿼시 병합 전용" 정책이 있는 경우 다른 병합 형식을 사용하려면 해당 정책을 편집해야 합니다.

  4. 병합 완료를 선택합니다.

병합을 완료하면 연결된 모든 작업 항목 이 PR 완료를 표시하도록 자동으로 업데이트됩니다.

완료된 P R을 보여 주는 연결된 작업 항목의 스크린샷

  1. PR 보기의 오른쪽 위에서 완료 를 선택하여 검토자가 변경 내용을 승인한 후 PR을 완료합니다.

    드롭다운 옵션을 사용하여 PR에 대한 전체 단추

    • 완료: 이제 PR을 완료하고 변경 내용을 대상 분기에 병합합니다.
    • 자동 완성 설정: 분기 정책이 있는 경우 자동 완성 설정을 선택하여 PR이 모든 분기 정책을 충족하면 닫도록 구성할 수 있습니다.
    • 중단: 변경 내용을 병합하지 않고 PR을 닫습니다.
  2. 끌어오기 요청 완료에서 병합 커밋에 대한 메시지를 입력하고 PR 설명을 업데이트합니다.

    전체 PR 대화 상자

  3. 다음 완료 후 옵션 중에서 선택합니다.

    • 병합한 후 연결된 작업 항목을 완료 하여 연결된 작업 항목을 완료합니다.
    • 병합한 후 삭제 <branch name> 하여 PR에서 원본 분기를 삭제합니다.
    • 스쿼시 병합 시 스쿼시가 PR을병합 할 때 변경합니다.
    • 분기 정책을 재정의하고 병합을 사용하도록 설정 하여 분기가 모든 분기 정책을 충족하지 않더라도 병합하도록 합니다. 이 옵션은 정책 적용 권한에서 제외 된 경우에만 사용할 수 있습니다.
  4. 병합 완료를 선택합니다.

연결된 작업 항목도 PR 완료를 보여 주는 업데이트됩니다.

완료된 PR을 보여 주는 연결된 작업 항목

PR 완료 중 다시베이스

PR 완료 중에는 재지정이 불가능한 몇 가지 상황이 있습니다.

  • 대상 분기의 정책에서 재베이스 전략을 사용하지 못하도록 하는 경우 다시 기반이 되도록 분기 정책 재정의 권한이 필요합니다.
  • PR 원본 분기에 정책이 있는 경우 다시 지정할 수 없습니다. 재배정은 정책 승인 프로세스를 거치지 않고 원본 분기를 수정합니다.
  • 병합 충돌 확장을 사용하여 병합 충돌을 해결한 경우 다시 지정할 수 없습니다. 모든 PR 커밋을 개별적으로 다시 적용할 때 3방향 병합에 적용되는 충돌 해결은 거의 성공하지 않거나 유효하지 않습니다.

이러한 모든 경우에서 여전히 로컬로 분기를 다시 지정한 다음 업스트림을 푸시하거나 PR을 완료할 때 변경 내용을 스쿼시 병합할 수 있습니다.

여러 병합 기본 문제

경우에 따라 PR에 두 개 이상의 실제 병합 기반이 있으며 이 경우 보안 문제가 발생할 수 있습니다. PR의 파일에 병합 베이스 간에 다른 버전이 있는 경우 여러 병합 기본 경고가 발생합니다. 자세한 내용 및 수정은 여러 병합 기반을 참조하세요.

병합 충돌 해결

분기의 파일 변경 내용이 다른 분기의 변경 내용과 충돌할 수 있습니다. 변경 내용을 병합하는 방법이 명확하지 않은 경우 Git은 PR의 개요 페이지에 충돌하는 파일을 표시합니다. PR을 병합하거나 PR을 자동 완성으로 설정하려면 PR 분기와 대상 분기 간의 병합 충돌을 해결해야 합니다. 병합 충돌 해결에 대한 지침은 병합 충돌 해결을 참조하세요.

P R의 개요 탭에서 병합 충돌을 보여 주는 스크린샷

끌어오기 요청을 자동 완성하도록 설정

전체 드롭다운 목록에서 자동 완성 설정을 선택하여 조건이 모든 분기 정책을 충족하는 즉시 PR 변경 내용을 완료하고 병합합니다. PR이 완료되면 이메일 알림을 받게 됩니다. 충돌 또는 오류로 인해 PR이 완료되지 않으면 전자 메일에서 문제를 알 수 있습니다.

참고

자동 완성 설정 옵션은 분기 정책이 있는 경우 Azure Repos 및 TFS 2017 이상에서 사용할 수 있습니다. 자동 완성 설정이 표시되지 않으면 분기 정책이 없습니다. 자세한 내용은 분기 정책을 참조하세요.

기본적으로 자동 완성으로 설정된 PR은 필요한 정책에서만 대기합니다. 자동 완성 사용 패널에서 선택적 정책도 대기하도록 선택할 수 있습니다.

자동 완성 사용 패널에서 필요에 따라 선택적 정책을 변경하는 것을 보여 주는 스크린샷.

TFS 2018 업데이트 2부터 PR 개요 페이지에 PR이 기다리고 있는 미해결 정책 기준 목록이 표시됩니다. 자동 완성 사용 패널에서 정책이 필요하도록 설정한 경우 개요 페이지에서 정책을 선택 사항으로 다시 설정할 수 있습니다.

자동 완성 취소를 선택하여 자동 완성을 해제합니다.

자동 완성 상태의 PR 스크린샷

자동 완성 상태의 PR 스크린샷

자동 완성으로 설정된 PR은 끌어오기 요청 페이지에 자동 완성 배지를 표시합니다.

PR 목록의 자동 완성 PR을 보여 주는 스크린샷

끌어오기 요청 중단 또는 다시 활성화

병합하지 않고 변경 내용 및 PR을 중단하려면 완료 단추의 드롭다운 목록에서 중단을 선택합니다. 중단된 PR은 계속 볼 수 있으며 작업 항목에 연결된 상태로 유지됩니다.

언제든지 중단된 PR을 다시 활성화하려면 끌어오기 요청 보기의 중단된 탭에서 PR을 열고 오른쪽 위에서 다시 활성화를 선택합니다.

완료된 끌어오기 요청 되돌리기

PR에서 변경 내용을 실행 취소하려면 다음 단계를 수행합니다. 자세한 내용은 변경 내용 실행 취소를 참조하세요.

  1. 완료된 PR을 열고 되돌리기를 선택합니다. 이 작업은 리포지토리의 기존 대상 분기에서 PR을 실행 취소하는 변경 내용이 있는 새 분기를 만듭니다.

  2. 끌어오기 요청 되돌리기 창에서 다음을 수행합니다.

    1. 대상 분기에서 PR 변경 내용을 실행 취소할 분기를 선택합니다.
    2. 필요한 토픽 분기 이름 아래에서 원하는 경우 되돌리기 PR 분기 이름을 변경합니다.
    3. 되돌리기 선택
  3. 새 끌어오기 요청 화면에서 만들기를 선택합니다.

  4. 새 PR을 병합하여 되돌리기를 완료합니다.

참고

이 되돌리기 중에 만든 분기에는 원래 PR에서 모든 파일 변경 내용을 되돌리는 단일 커밋이 있습니다. 분기는 원래 PR의 각 커밋에 대해 되돌려진 커밋을 포함하지 않습니다.

다음 단계