다음을 통해 공유

끌어오기 요청 만들기

  • 아티클

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

Visual Studio 2019 | Visual Studio 2022

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

PR 지침 및 관리 고려 사항은 끌어오기 요청 정보입니다.

필수 조건

  • 액세스:
    • 기본 액세스: PR을 보거나 검토하려면 최소한 기본 액세스 권한이 있는 Azure DevOps 프로젝트의 구성원이어야 합니다.
    • 관련자 액세스: 퍼블릭 프로젝트의 경우 이해 관계자 액세스 권한이 부여된 사용자는 Azure Repos에 대한 모든 권한을 갖습니다.
  • 사용 권한:
    • 리포지토리 사용: 프로젝트에서 리포지토리를 사용하도록 설정해야 합니다. 리포지토리 허브 및 연결된 페이지가 표시되지 않는 경우 Azure DevOps 서비스를 다시 사용하도록 설정 또는 해제 를 참조하세요.
    • 프로젝트 멤버 자격:
    • 읽기 권한자 보안 그룹: PR에 기여하려면 읽기 권한자 보안 그룹의 구성원이거나 해당 권한이 있어야 합니다.
    • 참가자 보안 그룹: PR을 만들고 완료하려면 참가자 보안 그룹의 구성원이거나 해당 권한이 있어야 합니다.
  • 도구
    • Azure DevOps CLI: 확장을 사용하여 Azure CLI(명령줄 인터페이스)에서 PR을 azure-devops 만들고 관리할 수 있습니다. 자세한 내용은 Azure DevOps CLI 시작을 참조하세요.
      • PR용 Azure Repos CLI 명령은 .를 사용합니다 az repos pr.
  • 액세스:
    • 기본 액세스: PR을 보거나 검토하려면 최소한 기본 액세스 권한이 있는 Azure DevOps 프로젝트의 구성원이어야 합니다. 프로젝트 멤버 가 아닌 경우 추가됩니다.
  • 사용 권한:
    • 리포지토리 사용: 프로젝트에서 리포지토리를 사용하도록 설정해야 합니다. 리포지토리 허브 및 연결된 페이지가 표시되지 않는 경우 Azure DevOps 서비스를 다시 사용하도록 설정 또는 해제 를 참조하세요.
    • 읽기 권한자 보안 그룹: PR에 기여하려면 읽기 권한자 보안 그룹의 구성원이거나 해당 권한이 있어야 합니다.
    • 참가자 보안 그룹: PR을 만들고 완료하려면 참가자 보안 그룹의 구성원이거나 해당 권한이 있어야 합니다.

권한 및 액세스에 대한 자세한 내용은 기본 Git 리포지토리 및 분기 권한 및 액세스 수준 정보를 참조하세요.

끌어오기 요청 만들기

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을 만들 수 있는 페이지로 이동합니다.

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

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

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

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

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

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

체리 픽으로 업데이트 추가

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

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

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

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을 초안으로 표시하면 기존 투표가 모두 제거됩니다.

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

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

새 끌어오기 요청 페이지에서 제목과 변경 내용에 대한 자세한 설명을 입력하여 다른 사용자가 변경 내용이 해결하는 문제를 확인할 수 있습니다. 기존 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. 새 끌어오기 요청 페이지의 연결할 작업 항목 아래에서 ID 또는 제목별로 작업 항목 검색을 선택합니다.
  2. 먼저 작업 항목 ID 또는 제목을 입력하고 표시되는 드롭다운 목록에서 연결할 작업 항목을 선택합니다. 제목으로 검색하면 상태별로 필터링된 작업 항목이 반환됩니다. 상태 범주가 완료되고 제거된 상태의 모든 작업 항목은 제외됩니다. 또한 이러한 작업 항목은 날짜 및 사용자별로 필터링되며, 지난 30일 동안 생성되거나 업데이트된 항목만 표시되며, 현재 사용자로 생성, 할당 또는 권한을 부여받아야 합니다.

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

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

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

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

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

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

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

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

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

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

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

끌어오기 요청에 태그 추가

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

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

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

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

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

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

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

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

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

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

관련자에게 이메일 끌어오기 요청 알림

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

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

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

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

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

참고 항목

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

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

다음 단계

끌어오기 요청 검토