끌어오기 요청 만들기

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

Visual Studio 2019 | Visual Studio 2022

Git 리포지토리에서 코드를 변경, 검토 및 병합하는 PR(끌어오기 요청)을 만듭니다. 업스트림 리포지토리의 분기 또는 리포지토리의 포크에 있는 분기에서 PR을 만들 수 있습니다. 팀은 PR을 검토하고 변경 내용에 대한 피드백을 제공할 수 있습니다. 검토자는 제안된 변경 내용을 단계별로 실행하고, 의견을 남기며, PR을 승인하거나 거부할 수 있습니다. PR을 완료하고 변경 내용을 대상 분기에 병합하려면 분기 정책 및 기타 요구 사항에 따라 PR 이 다양한 기준을 충족해야 할 수 있습니다.

PR 지침 및 관리 고려 사항은 끌어오기 요청 정보를 참조하세요.

필수 구성 요소

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

  • PR을 보거나 검토하려면 기본 액세스 이상의 Azure DevOps 프로젝트의 멤버여야 합니다.

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

  • PR을 만들고 완료하려면 기여자 보안 그룹의 구성원이거나 해당 권한이 있어야 합니다.

    참고

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

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

끌어오기 요청 만들기

Azure DevOps 프로젝트 웹 사이트, Visual Studio 또는 Azure DevOps CLI에서 새 PR을 만들 수 있습니다.

Azure DevOps 프로젝트 웹 사이트에서 다음에서 새 PR을 만들 수 있습니다.

끌어오기 요청 페이지에서 PR 만들기

웹에 있는 프로젝트의 끌어오기 요청 페이지에서 모든 분기에 대한 PR을 만들 수 있습니다.

  1. Repos>끌어오기 요청 페이지에서 오른쪽 위에서 새 끌어오기 요청을 선택합니다.

    새 끌어오기 요청 단추의 스크린샷

  2. 변경 내용이 있는 분기와 변경 내용을 병합할 분기(예: 기본 분기)를 선택합니다.

    Azure Repos P R의 원본 및 대상 분기 스크린샷

  3. PR 세부 정보를 입력 하고 PR을 만듭니다.

푸시된 분기에서 PR 만들기

기능 분기 푸시하거나 업데이트한 후 Azure Repos PR을 만들라는 프롬프트를 표시합니다.

  • 끌어오기 요청 페이지에서 다음을 수행합니다.

    Azure Repos 끌어오기 요청 탭에서 P R을 만들라는 프롬프트를 보여 주는 스크린샷

  • 파일 페이지에서 다음을 수행 합니다 .

    Azure Repos 파일 탭에서 P R을 만들라는 프롬프트를 보여 주는 스크린샷

끌어오기 요청 만들기를 선택하여 PR 세부 정보를 입력하고 PR을 만들 수 있는 페이지로 이동합니다.

기능 분기 푸시하거나 업데이트한 후 Azure Repos 웹의 코드 보기에서 PR을 만들라는 메시지를 표시합니다. 이 프롬프트는 끌어오기 요청 및파일에 표시됩니다.

Azure Repos 끌어오기 요청 탭에서 P R을 만들라는 프롬프트를 보여 주는 스크린샷

Azure Repos 파일 탭에서 P R을 만들라는 프롬프트를 보여 주는 스크린샷

끌어오기 요청 만들기를 선택하여 PR 세부 정보를 입력하고 PR을 만들 수 있는 페이지로 이동합니다.

연결된 작업 항목에서 PR 만들기

분기에 연결된 Azure Boards 작업 항목에서 직접 PR을 만들 수 있습니다.

  1. Azure Boards 작업 보기의 백로그 또는 쿼리에서 분기에 연결된 작업 항목을 엽니다.

  2. 작업 항목의 개발 영역에서 끌어오기 요청 만들기를 선택합니다.

    연결된 분기가 있는 작업 항목의 개발 영역에서 PR을 만드는 스크린샷

링크는 PR 세부 정보를 입력하고 PR 을 만들 수 있는 페이지로 이동합니다.

cherry-pick을 사용하여 업데이트 추가

cherry-pick을 사용하여 한 분기에서 다른 분기로 커밋을 복사할 수 있습니다. Cherry-Pick은 병합이나 다시 지정과 달리 분기에 있는 모든 변경 내용이 아니라 선택한 커밋의 변경 내용만 가져옵니다.

완료된 PR에서 변경 내용을 체리 선택하려면 PR의 개요 페이지에서 Cherry-pick을 선택합니다. 활성 PR에서 변경 내용을 복사하려면 PR의 기타 옵션 메뉴에서 Cherry-pick을 선택합니다. 이 작업은 복사한 변경 내용이 포함된 새 분기를 만듭니다. 그런 다음 새 분기에서 새 PR을 만들 수 있습니다. 자세한 지침은 cherry-pick을 사용하여 변경 내용 복사를 참조하세요.

끌어오기 요청의 원본 및 대상 분기 전환

PR을 처음 저장하기 전에 분기 이름 옆에 있는 원본 및 대상 분기 전환 아이콘을 선택하여 PR의 원본 및 대상 분기 를 전환할 수 있습니다. PR이 활성화되면 이 아이콘이 사라지지만 PR 의 대상 분기는 계속 변경할 수 있습니다.

원본 및 대상 분기 전환 아이콘의 스크린샷

끌어오기 요청 템플릿 사용

끌어오기 요청 템플릿은 PR을 만들 때 PR 설명을 채우는 Markdown 텍스트를 포함하는 파일입니다. 좋은 PR 설명은 PR 검토자에게 무엇을 기대해야 하는지 알려주며 단위 테스트 추가 및 설명서 업데이트와 같은 작업을 추적하는 데 도움이 될 수 있습니다. 팀은 리포지토리의 모든 새 PR 설명에 텍스트를 추가하는 기본 PR 템플릿을 만들 수 있습니다. 또한 분기별 템플릿 또는 팀에서 정의하는 다른 템플릿 중에서 선택할 수 있습니다. PR 템플릿을 만들고 사용하는 방법에 대한 자세한 내용은 템플릿을 사용하여 끌어오기 요청 설명 개선을 참조하세요.

리포지토리에 기본 템플릿이 있는 경우 리포지토리의 모든 PR에는 만들 때 기본 템플릿의 설명 텍스트가 있습니다. 다른 템플릿을 추가하려면 템플릿 추가를 선택한 다음, 드롭다운 목록에서 템플릿을 선택합니다. 설명에서 템플릿 텍스트를 편집하거나 제거하거나 다른 텍스트를 추가할 수 있습니다.

P R을 만들 때 템플릿 추가를 보여 주는 스크린샷

초안 PR 만들기

PR을 검토할 준비가 되지 않은 경우 진행 중인 작업을 나타내는 초안 PR을 만들 수 있습니다. PR을 검토할 준비가 되면 게시하고 전체 검토 프로세스를 시작하거나 다시 시작할 수 있습니다.

초안 PR은 게시된 PR과 다음과 같은 차이점이 있습니다.

  • 빌드 유효성 검사 정책은 자동으로 실행되지 않습니다. PR에서 추가 옵션 메뉴를 선택하여 빌드 유효성 검사를 수동으로 큐에 추가할 수 있습니다.

  • 초안 모드에서 투표는 사용하지 않도록 설정됩니다.

  • 필수 검토자는 자동으로 추가되지 않습니다. 알림은 초안 PR에 명시적으로 추가한 검토자에게만 전송됩니다.

  • 초안 PR은 PR 목록에 초안 배지와 함께 표시됩니다.

    P R 목록의 초안 P R을 보여 주는 스크린샷

참고

초안 PR을 만들려면 Azure DevOps Server 2019.1 업데이트 이상이 필요합니다.

초안 PR을 만들려면 만들기 옆에 있는 화살표를 선택하고 PR을 만들 때 초안으로 만들기 를 선택합니다. WIP 또는 DO NOT MERGE와 같은 제목 접두사를 사용할 필요가 없습니다.

초안 P R로 만들기를 보여 주는 스크린샷

PR을 검토하고 완료할 준비가 되면 PR의 오른쪽 위에 있는 게시 를 선택합니다. PR을 게시하면 필요한 검토자가 할당되고, 정책이 평가되며, 투표가 시작됩니다.

P R에 대한 게시를 보여 주는 스크린샷

게시된 기존 PR을 초안으로 변경하려면 초안으로 표시를 선택합니다. PR을 초안으로 표시하면 기존 투표가 모두 제거됩니다.

초안으로 표시를 보여 주는 스크린샷

참고

이 기능을 사용하려면 Azure DevOps Server 2019.1 업데이트 이상이 필요합니다.

끌어오기 요청 제목 및 설명 추가 또는 편집

새 끌어오기 요청 페이지에서 제목 및 변경 내용에 대한 자세한 설명을 입력하여 다른 사용자가 변경 내용이 해결하는 문제를 확인할 수 있습니다. 기존 PR에서와 같이 새 PR에서 별도의 탭에서 PR의 파일커밋 을 볼 수 있습니다. 검토자를 추가하고, 작업 항목을 연결하고, PR에 태그를 추가할 수 있습니다.

변경 내용을 검토할 준비가 되면 만들기 를 선택하여 PR을 만듭니다.

새 P R 만들기를 보여 주는 스크린샷

새 P R에 세부 정보를 추가합니다.

PR을 만들 때 모든 작업 항목, 검토자 또는 세부 정보가 준비되지 않은 경우 걱정하지 마세요. PR을 만든 후 이러한 항목을 추가하거나 업데이트할 수 있습니다.

PR 제목 및 설명 편집

검토자가 PR의 변경 내용을 이해할 수 있도록 PR 제목 및 설명을 최신 상태로 유지합니다.

현재 제목을 선택하고 텍스트를 업데이트하여 기존 PR의 제목을 업데이트할 수 있습니다. 저장 아이콘을 선택하여 변경 내용을 저장하거나 실행 취소 아이콘을 선택하여 변경 내용을 취소합니다.

설명 섹션에서 편집 아이콘을 선택하여 PR 설명을편집합니다.

P R 제목을 편집하고 설명 편집 단추를 선택하는 것을 보여 주는 스크린샷

끌어오기 요청에 검토자 추가

새 PR 또는 기존 PR의 검토자 섹션에서 검토자를 추가할 수 있습니다. 기존 선택적 검토자를 필수로 만들거나 정책에서 필요하지 않은 경우 필수 검토자를 선택 사항으로 변경하거나 제거할 수도 있습니다.

분기 정책에 는 최소 수의 검토자가 필요하거나 PR에 특정 선택적 검토자 또는 필수 검토자를 자동으로 포함할 수 있습니다. 분기 정책에 필요한 검토자는 제거할 수 없습니다. 필요한 분기 정책 선택적 검토자를 변경하거나 제거할 수 있습니다.

검토자를 자동으로 추가한 분기 정책을 보려면 PR 개요 페이지의 검토자 섹션에서 검토자 옆에 있는 기타 옵션을 마우스 오른쪽 단추로 클릭합니다.

분기 정책에 의해 자동으로 포함되는 검토자의 정책 보기를 보여 주는 스크린샷

PR을 검토하려는 사용자 또는 그룹이 프로젝트의 멤버가 아닌 경우 프로젝트에 추가 해야 검토자로 추가할 수 있습니다.

새 PR에 검토자를 추가하려면 다음을 수행합니다.

  1. 새 끌어오기 요청 페이지의 검토자에서 사용자 및 그룹 검색을 선택하여 검토자로 추가합니다.
  2. 이름 또는 전자 메일 주소를 입력하면 드롭다운 목록에 일치하는 사용자 및 그룹 목록이 표시됩니다. 목록에서 이름을 선택하여 선택적 검토자로 추가합니다.
  3. 필수 검토자를 추가하려면 필수 검토자 추가를 선택한 다음 검색을 선택하여 이름을 검색하고 선택하는 데 필요한 검토자를 추가 합니다.

새 P R에 검토자를 추가하는 스크린샷

기존 PR에 검토자를 추가하려면 다음을 수행합니다.

  1. 개요 페이지의 검토자 섹션에서 추가를 선택한 다음 필수 검토자 또는 선택적 검토자를 선택합니다.

    끌어오기 요청 개요

  2. 이름 또는 전자 메일 주소를 입력하면 일치하는 사용자 또는 그룹 목록이 나타납니다. 검토자로 추가할 이름을 선택합니다.

    P R 검토자를 추가합니다.

검토자를 필수와 선택 사항 간에 변경하거나 검토자를 제거하려면 검토자 이름 오른쪽에 있는 추가 옵션을 선택합니다. 검토자로 지정된 그룹 또는 팀의 멤버 자격을 보려면 그룹의 아이콘을 선택합니다.

PR에 검토자를 추가하려면 다음을 수행합니다.

  1. PR에서 개요 탭을 선택합니다.

    PR 개요

  2. 검토자 영역에서 추가 단추를 선택합니다.

  3. PR의 검토자 목록에 추가할 사용자 또는 그룹의 이름을 입력합니다. 사용자가 프로젝트의 멤버가 아닌 경우 추가해야 합니다.

  4. 이름 또는 전자 메일 주소를 입력하면 일치하는 사용자 또는 그룹 목록이 나타납니다. 목록에서 사용자 또는 그룹을 선택하여 검토자로 추가합니다.

    PR 검토자 추가

작업 항목을 새 PR에 연결하려면 다음을 수행합니다.

  1. 새 끌어오기 요청 페이지의 연결할 작업 항목에서 ID 또는 제목으로 작업 항목 검색을 선택합니다.
  2. 먼저 작업 항목 ID 또는 제목을 입력하고 표시되는 드롭다운 목록에서 연결할 작업 항목을 선택합니다. 제목으로 검색하면 상태별로 필터링된 작업 항목이 반환됩니다. 상태 범주가 완료됨제거됨 상태인 모든 작업 항목은 제외됩니다. 또한 이러한 작업 항목은 날짜 및 사용자별로 필터링되며, 지난 30일 동안 생성되거나 업데이트된 항목만 표시되며, 현재 사용자로 생성, 할당 또는 권한을 부여받아야 합니다.

작업 항목을 기존 PR에 연결하려면 다음을 수행합니다.

  1. PR 개요 탭의 작업 항목 영역에서 를 선택합니다 +.

    개요 탭 및 작업 항목 섹션 선택을 보여 주는 스크린샷

  2. 작업 항목의 ID를 입력하거나 작업 항목 제목을 검색합니다. 표시되는 목록에서 작업 항목을 선택합니다.

작업 항목 옆에 있는 x 아이콘을 선택하여 작업 항목 링크를 제거합니다. 링크를 제거하면 작업 항목과 PR 간의 링크만 제거됩니다. 분기 또는 커밋에서 만든 링크는 작업 항목에 남아 있습니다.

PR에 작업 항목을 연결하려면 다음을 수행합니다.

  1. PR에서 개요 탭을 선택합니다.

    개요 탭 및 링크 항목 단추를 선택하는 것을 보여 주는 스크린샷

  2. 작업 항목 영역에서 추가 단추를 선택합니다. PR에서 아이콘 추가

  3. 작업 항목의 ID를 입력하거나 텍스트와 일치하는 제목이 있는 작업 항목을 검색합니다. 표시되는 목록에서 작업 항목을 선택합니다. 제목으로 검색하면 상태별로 필터링된 작업 항목이 반환됩니다. 상태 범주 가 완료됨제거됨 상태인 모든 작업 항목은 제외됩니다. 또한 이러한 작업 항목은 날짜 및 사용자별로 필터링되며 지난 30일 동안 생성되거나 업데이트된 항목만 표시되며 현재 사용자로 생성, 할당 또는 권한을 부여받아야 합니다.

작업 항목 위로 마우스를 가져가면 나타나는 제거 단추를 선택하여 작업 항목 링크를 제거합니다. 제거 단추 링크를 제거하면 PR에 대한 작업 항목 간의 링크만 제거됩니다. 분기 또는 커밋에서 만든 링크는 작업 항목에 유지됩니다.

PR에 작업 항목을 연결하려면 다음을 수행합니다.

  1. PR에서 개요 를 선택합니다.

    PR에서 개요를 선택합니다.

  2. 작업 항목 영역에서 추가 단추를 선택합니다.

  3. 작업 항목의 ID를 입력하거나 텍스트와 일치하는 제목이 있는 작업 항목을 검색합니다. 표시되는 목록에서 작업 항목을 선택합니다. 제목으로 검색하면 상태별로 필터링된 작업 항목이 반환됩니다. 상태 범주 가 완료됨제거됨 상태인 모든 작업 항목은 제외됩니다. 또한 이러한 작업 항목은 날짜 및 사용자별로 필터링되며 지난 30일 동안 생성되거나 업데이트된 항목만 표시되며 현재 사용자로 생성, 할당 또는 권한을 부여받아야 합니다.

작업 항목 위로 마우스를 가져가면 나타나는 제거 단추를 선택하여 작업 항목 링크를 제거합니다. 제거 아이콘 링크를 제거하면 작업 항목과 PR 간의 링크만 제거됩니다. 분기 또는 커밋에서 만든 링크는 작업 항목에 유지됩니다.

끌어오기 요청에 태그 추가

태그를 사용하여 중요한 세부 정보를 표시하고 PR을 구성하는 데 도움이 됩니다. 태그는 PR이 아직 진행 중인 작업이거나 향후 릴리스의 핫픽스인 등 검토자에게 추가 정보를 전달할 수 있습니다.

태그가 있는 P R을 보여 주는 스크린샷

PR을 만들 때 태그를 추가하려면 태그 섹션에 태그 이름을 입력 합니다 . PR을 만든 후 태그 섹션에서 태그를 관리할 수 있습니다.

강조 표시된 P R 태그 섹션을 보여 주는 스크린샷

끌어오기 요청에 레이블 추가

레이블을 사용하여 검토자에게 PR에 대한 추가 정보를 전달할 수 있습니다. PR은 여전히 진행 중인 작업이거나 향후 릴리스의 핫픽스일 수 있습니다. 레이블을 사용하여 중요한 세부 정보를 전달하고 PR을 구성하는 데 도움이 됩니다.

참고

PR 레이블을 사용하려면 TFS 2018.2 이상 버전이 필요합니다.

레이블이 있는 P R을 보여 주는 스크린샷

PR을 만들 때 레이블을 추가하려면 레이블 추가를 선택합니다. PR을 만든 후 레이블 섹션에서 레이블을 관리할 수 있습니다 .

P R 레이블 추가

끌어오기 요청에 첨부 파일 추가

이미지를 포함한 파일을 만드는 동안 또는 만든 후에 PR에 첨부할 수 있습니다. 설명 필드 아래의 용지 클립 아이콘을 선택하거나 PR의 설명 필드에 파일을 직접 끌어서 놓습니다.

만드는 동안 P R 설명에 파일 첨부를 보여 주는 스크린샷

활성 끌어오기 요청의 대상 분기 변경

대부분의 팀에서 거의 모든 PR은 또는 develop와 같은 main 기본 분기 대상으로 합니다. 경우에 따라 다른 분기를 대상으로 지정해야 하는 경우 PR을 만들 때 대상 분기를 변경하는 것을 잊기 쉽습니다. 이 경우 활성 PR의 대상 분기를 변경할 수 있습니다.

  1. PR 개요 페이지에서 오른쪽 위에 있는 추가 작업을 선택한 다음 드롭다운 메뉴에서 대상 분기 변경을 선택합니다.
  2. 대상 분기 변경 창에서 대상 분기 선택을 선택하고 새 분기를 선택한 다음 변경을 선택합니다.

관련자에게 끌어오기 요청 알림 Email

검토자에게 알리고 팀 구성원과 통신하기 위해 메일로 끌어오기 요청을 공유할 수 있습니다. PR을 공유하려면 다음을 수행합니다.

  1. PR 개요 페이지에서 추가 옵션을 선택한 다음 끌어오기 요청 공유를 선택합니다.

    P R의 개요 페이지에서 끌어오기 요청 공유 선택을 보여 주는 스크린샷

  2. 끌어오기 요청 공유 화면에서 받는 사람: 필드에 이름을 입력하고 표시되는 사용자 이름 중에서 선택하여 받는 사람을 추가합니다. 받는 사람을 제거할 수도 있습니다.

  3. 메모(선택 사항) 필드에 선택적 메시지를 추가한 다음 보내기를 선택합니다. 받는 사람은 관심을 요청하고 PR에 연결하는 이메일을 받습니다.

참고

기본 제공 전자 메일 기능을 사용하는 경우 프로젝트 멤버의 개별 주소로만 전자 메일을 보낼 수 있습니다. 팀 그룹 또는 보안 그룹을 To: 줄에 추가하는 것은 지원되지 않습니다. 시스템에서 인식하지 못하는 전자 메일 계정을 추가하면 전자 메일의 받는 사람 중 한 명 이상이 메일로 보낸 끌어오기 요청을 읽을 수 있는 권한이 없다는 메시지가 표시됩니다.

전자 메일 기능이 작동하려면 Azure DevOps Server 관리자가 SMTP 서버를 구성해야 합니다.

다음 단계