템플릿을 사용하여 끌어오기 요청 설명 개선
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
적절한 끌어오기 요청 설명을 작성하면 검토자가 코드를 검토할 때 예상되는 사항을 알 수 있습니다. 또한 테스트, 단위 테스트 추가 및 설명서 업데이트와 같이 모든 변경에 대해 수행해야 하는 작업을 추적하는 데 유용한 방법입니다. 끌어오기 요청 템플릿은 개발자가 조직의 표준을 충족하는 훌륭한 끌어오기 요청 설명을 만드는 데 도움이 될 수 있습니다.
이 문서에서는 끌어오기 요청 템플릿을 시작하는 방법을 보여 줍니다.
비고
끌어오기 요청 템플릿은 지침을 제공할 수 있지만 권고에만 해당합니다. 분기 정책을 사용하여 기본과 같은 주요 분기에 대한 끌어오기 요청 요구, 성공적인 빌드 요구 및 필요한 검토자 적용과 같은 모범 사례를 적용합니다. 자세한 내용은 분기 정책을 참조하세요.
필수 조건
| 카테고리 | 요구 사항 |
|---|---|
| 프로젝트 액세스 | 프로젝트멤버입니다. |
| 권한 | - 프라이빗 프로젝트에서 코드 보기: 최소 기본 액세스. - 프라이빗 프로젝트의 코드 복제 또는 기여: 기여자 보안 그룹 또는 프로젝트의 해당 사용 권한의 구성원입니다. - 분기 또는 리포지토리 사용 권한 설정: 분기 또는 리포지토리에 대한 사용 권한 사용 권한 관리 - 기본 분기 변경: 리포지토리에 대한 정책 편집 권한 설정. - 리포지토리 가져오기: 프로젝트 관리자 보안 그룹의 구성원이거나 Git 프로젝트 수준에서 리포지토리 생성 권한이 허용으로 설정된 경우입니다. 자세한 내용은 Git 리포지토리 권한 설정을 참조 하세요. |
| 서비스 | 리포지토리가 활성화되었습니다. |
| 도구 | 선택 사항. az repos 명령어를 사용하세요: Azure DevOps CLI. |
비고
퍼블릭 프로젝트에서 이해 관계자 액세스 권한이 있는 사용자는 코드 보기, 복제 및 기여를 포함하여 Azure Repos에 대한 모든 권한을 갖습니다.
| 카테고리 | 요구 사항 |
|---|---|
| 프로젝트 액세스 | 프로젝트멤버입니다. |
| 권한 | - 코드 보기: 최소 베이직 접근 권한. - 코드 복제 또는 기여: 기여자 보안 그룹의 구성원이거나 프로젝트에서 해당 권한을 가진 경우. |
| 서비스 | 리포지토리가 활성화되었습니다. |
끌어오기 요청 템플릿이란?
끌어오기 요청 템플릿은 끌어오기 요청을 만들 때 끌어오기 요청 설명에 추가되는 Markdown 텍스트를 포함하는 파일입니다.
Thank you for your contribution to the Fabrikam Fiber repo.
Before submitting this PR, please make sure:
- [ ] Your code builds clean without any errors or warnings
- [ ] You are using approved terminology
- [ ] You have added unit tests
Azure Repos를 사용하면 다음과 같은 유형의 끌어오기 요청 템플릿을 만들 수 있습니다.
- 리포지토리의 모든 새 끌어오기 요청에 대해 자동으로 적용되는 기본 끌어오기 요청 템플릿은 분기별 끌어오기 요청 템플릿으로 재정의되지 않는 한 사용됩니다.
- 특정 브랜치를 대상으로 하는 끌어오기 요청에 자동으로 적용되는 브랜치별 끌어오기 요청 템플릿
- 끌어오기 요청 작성자가 선택적으로 추가할 수 있는 추가 끌어오기 요청 템플릿
끌어오기 요청 템플릿의 형식은 다음 섹션에서 설명한 대로 파일 이름 및 폴더 위치에 따라 결정됩니다. 파일 이름 및 폴더 위치는 대/소문자를 구분하지 않지만 리포지토리의 기본 분기에 있어야 합니다.
비고
모든 끌어오기 요청 템플릿 파일은 리포지토리의 기본 분기(일반적으로 기본)에 있어야 합니다. 기본 분기에서 끌어오기 요청 템플릿 파일만 사용됩니다.
기본 끌어오기 요청 템플릿
새 끌어오기 요청이 만들어지면 기본 끌어오기 요청 템플릿이 설명 필드에 자동으로 적용됩니다. 기본 끌어오기 요청 템플릿을 사용하여 리포지토리를 구성하려면 pull_request_template.md 또는 pull_request_template.txt 파일을 만들고 다음 폴더 중 하나에 있는 리포지토리의 기본 분기에 저장합니다.
- 리포지토리의 루트 폴더에 포함된
.azuredevops폴더 - 리포지토리의 루트 폴더에 포함된
.vsts폴더 - 리포지토리의 루트 폴더에 포함된
docs폴더 - 리포지토리의 루트 폴더
끌어오기 요청 템플릿을 저장하는 위치에 유연성을 제공하기 위해 여러 위치가 제공됩니다. 끌어오기 요청이 만들어지면 Azure Repos는 지정된 순서대로 지정된 폴더를 검색하고 찾은 첫 번째 기본 끌어오기 요청 템플릿을 사용합니다.
리포지토리에서 새 끌어오기 요청이 만들어지면 분기별 끌어오기 요청 템플릿 적용되지 않는 한 기본 끌어오기 요청 템플릿의 내용은 끌어오기 요청의 설명 필드를 미리 채우는 데 사용됩니다.
원하는 경우 이 설명을 편집하거나 추가하고, 템플릿 추가 드롭다운에서 선택하여 추가 끌어오기 요청 템플릿을 추가할 수 있습니다.
비고
기본 또는 분기별 끌어오기 요청 템플릿이 자동으로 적용되는 경우 일반적으로 기본 설명에 사용되는 표준 커밋 메시지를 대체합니다. 커밋 메시지 추가을 선택하여 다시 추가할 수 있습니다.
브랜치별 끌어오기 요청 템플릿
특정 분기를 대상으로 하는 끌어오기 요청에 대해 분기별 끌어오기 요청 템플릿을 구성할 수 있습니다. 분기별 끌어오기 요청 템플릿을 사용하여 리포지토리를 구성하려면 분기의 이름을 따서 명명된 .txt 또는 .md 파일을 만듭니다. 이름은 main, dev, release또는 feature같은 분기 이름의 첫 번째 수준과 일치해야 합니다. 각 분기 특정 끌어오기 요청 템플릿은 끌어오기 요청이 해당 분기 또는 그 아래에 포함된 분기를 대상으로 할 때마다 적용됩니다. 예를 들어 끌어오기 요청이 feature 분기 또는 feature/* 분기를 대상으로 하는 경우 feature.md이라는 끌어오기 요청 템플릿이 적용됩니다.
분기별 끌어오기 요청 템플릿은 폴더 계층 구조를 사용하여 리포지토리의 기본 분기에 저장되어야 합니다. pull_request_template/branches/. 이러한 폴더는 리포지토리의 다음 폴더 중 하나를 기반으로 해야 합니다.
- 리포지토리의 루트 폴더에 포함된
.azuredevops폴더 - 리포지토리의 루트 폴더에 포함된
.vsts폴더 - 리포지토리의 루트 폴더에 포함된
docs폴더 - 리포지토리의 루트 폴더
예를 들어 dev 분기에 대한 모든 끌어오기 요청에 적용해야 하는 분기별 끌어오기 요청 템플릿은 dev.md 또는 dev.txt 이름이 지정되고 다음 위치 중 하나에 배치됩니다.
<repository root>/.azuredevops/pull_request_template/branches/<repository root>/.vsts/pull_request_template/branches/<repository root>/docs/pull_request_template/branches/<repository root>/pull_request_template/branches/
기본 끌어오기 요청 템플릿과 마찬가지로 분기별 끌어오기 요청 템플릿을 저장하는 위치에 유연성을 제공하기 위해 여러 위치가 제공됩니다. 끌어오기 요청을 만들 때 Azure Repos는 지정된 폴더를 지정된 순서대로 검색하여 분기 특정 끌어오기 요청 템플릿을 검색하고 분기 이름과 일치하는 첫 번째 폴더를 사용합니다. 분기별 끌어오기 요청 템플릿이 없는 경우 Azure Repos는 이전 기본 끌어오기 요청 템플릿 섹션에 설명된 대로 기본 끌어오기 요청 템플릿을 검색합니다.
추가 끌어오기 요청 템플릿
기본 및 분기별 끌어오기 요청 템플릿 외에도 추가 끌어오기 요청 템플릿을 구성할 수 있습니다. 이러한 파일은 기본 분기의 다음 폴더 중 하나에 있는 .md 또는 .txt 파일일 수 있습니다.
<repository root>/.azuredevops/pull_request_template/<repository root>/.vsts/pull_request_template/<repository root>/docs/pull_request_template/<repository root>/pull_request_template/
끌어오기 요청을 만들 때 템플릿 추가 드롭다운에서 선택하여 사용 가능한 끌어오기 요청 템플릿을 추가할 수 있습니다. 드롭다운의 이름은 템플릿의 파일 이름을 기반으로 합니다.
다음 예제에서는 세 개의 템플릿이 나열됩니다.
-
dev.md- 파일 이름 뒤에 나열된 기본 메시지에 표시된 것처럼 이 끌어오기 요청에 기본적으로 적용된 브랜치 전용 템플릿입니다. -
additional.md- 추가 템플릿입니다. -
pull_request_template.md- 보통 기본 템플릿이지만, 이 끌어오기 요청에서는 특정dev.md분기 템플릿에 의해 재정의되었습니다. 기본적으로 추가되지는 않았지만 목록에서 선택하여 적용할 수 있습니다.
원하는 추가 템플릿의 이름을 선택하여 현재 끌어오기 요청 설명에 콘텐츠를 추가합니다.
비고
쿼리 문자열에 ?template=name.md 추가하여 일치하는 기본 또는 분기별 끌어오기 요청을 재정의하도록 끌어오기 요청 템플릿을 지정할 수 있습니다.