끌어오기 요청 처리

PR(끌어오기 요청)을 연 후 PR은 제안된 변경 내용을 병합할 수 있도록 일련의 검사 및 검토를 거칩니다. PR에 대한 자세한 배경 정보는 Git 및 GitHub 기본 사항을 참조 하세요.

유효성 검사

PR을 대상 분기에 병합하기 전에 하나 이상의 PR 유효성 검사 프로세스를 통과해야 할 수 있습니다. 끌어오기 요청 만들기를 선택한 후 GitHub는 리포지토리에 대해 구성된 유효성 검사를 실행합니다. 유효성 검사 프로세스가 완료되면 결과가 PR에 표시됩니다.

유효성 검사 프로세스는 제안된 변경 범위와 대상 리포지토리의 규칙에 따라 다릅니다. PR을 제출한 후에는 다음 중 하나 이상이 발생할 것으로 예상할 수 있습니다.

• 병합성: 분기의 제안된 변경 내용이 대상 분기와 충돌하는지 여부를 확인하기 위한 기준 GitHub 병합성 테스트가 먼저 수행됩니다. PR에서 이 테스트가 실패했음을 나타내는 경우 처리를 계속하기 전에 병합 충돌 일으키는 콘텐츠를 조정해야 합니다.
• CLA(기여 라이선스 계약) : Microsoft 이외의 기여자 퍼블릭 리포지토리 기여하는 경우 해당 리포지토리에 PR을 처음 제출할 때 짧은 CLA를 완료하라는 메시지가 표시될 수 있습니다. CLA 단계가 지워지면 PR이 처리됩니다.
• 레이블 지정: PR의 유효성이 검사 워크플로를 통과할 때 PR 상태를 나타내기 위해 PR에 레이블이 자동으로 적용됩니다. 예를 들어, 새 PR은 PR의 유효성이 검사, 검토 및 승인 단계를 아직 완료하지 않았음을 나타내는 "병합 안 함" 레이블을 자동으로 받을 수 있습니다.
• 유효성 검사 및 빌드: 자동화된 검사는 변경 내용의 유효성 검사 테스트 통과 여부를 확인합니다. 유효성 검사 테스트는 경고 또는 오류를 생성할 수 있으므로 PR에서 하나 이상의 파일을 편집해야 병합할 수 있습니다. 유효성 검사 테스트 결과는 검토를 위해 PR에 주석으로 추가되며 전자 메일로 전송될 수 있습니다.
• 스테이징: 유효성 검사 및 빌드가 성공하면 변경한 문서가 검토를 위해 스테이징 환경에 자동으로 배포됩니다. PR 주석에 미리 보기 URL이 표시됩니다.
• 자동 병합: PR은 유효성 검사 테스트와 특정 기준을 통과하면 자동으로 병합될 수 있습니다. 이 경우 다른 작업을 수행할 필요가 없습니다.

피드백 검토 및 해결

모든 PR 처리가 완료되면 결과를 검토해야 합니다(예: PR 주석, 빌드 결과). 병합을 위해 로그오프하기 전에 더 많은 변경을 수행해야 하는지 확인합니다. 다음과 같은 이유로 콘텐츠를 변경해야 할 수 있습니다.

• 검토자의 PR 주석입니다. PR 검토자가 PR을 검토한 경우 병합하기 전에 해결해야 할 미해결 문제 또는 질문이 있는 경우 의견을 통해 피드백을 제공할 수 있습니다.
• 피어 검토자의 피드백입니다.
• 렌더링 문제로 인한 서식 수정
• 유효성 검사 오류 또는 경고입니다.
• 병합 충돌이 있습니다.

변경해야 하는 경우 PR에서 직접 콘텐츠를 편집하거나 VS Code로 돌아가서 변경할 수 있습니다. 완료되면 작업 분기에 변경 내용을 커밋합니다. PR은 변경 내용으로 자동으로 업데이트됩니다.

동일한 작업 분기에 커밋을 추가할 때마다 커밋이 PR에 자동으로 추가됩니다. 각 커밋에서 게시 시스템은 유효성 검사를 다시 실행하고 프로세스를 자동으로 검토합니다.

로그오프 및 주석 자동화

모든 피드백 및 유효성 검사 오류를 해결했고 변경 내용을 병합할 준비가 되면 읽는 #sign-off새 주석을 만들어 PR에서 로그오프해야 합니다. 변경 내용을 병합하려면 메모를 입력 #sign-off 해야 합니다. 모든 검토 및 유효성 검사 검사 통과하더라도 이 주석을 사용하여 PR 검토자 및 리포지토리 관리자에게 변경 내용을 병합할 준비가 되었다는 것을 알릴 책임이 있습니다.

검토자가 PR이 발급되지 않으며 로그오프된 것으로 확인되면 변경 내용이 기본 분기 병합되고 PR이 닫힙니다.

주석 자동화를 사용하면 리포지토리에 쓰기 권한이 없는 사용자가 PR에 적절한 레이블을 할당하여 쓰기 수준 작업을 완료할 수 있습니다. 주석 자동화가 구현된 리포지토리에서 작업하는 경우 다음 표에 나열된 해시태그 주석을 사용하여 레이블을 할당하거나 레이블을 변경하거나 PR을 닫습니다. Microsoft 작성자는 문서에 변경 사항이 제안될 때마다 검토 및 로그오프를 위해 전자 메일을 통해 알림을 받습니다.

해시태그 댓글	수행하는 작업
#sign-off	리포지토리의 검토자가 PR이 검토/병합할 준비가 되었음을 알 수 있도록 병합 준비 완료 레이블을 자동으로 할당합니다. 나열된 작성자가 아니고 주석을 사용하여 #sign-off 공개 리포지토리 PR에서 로그오프를 시도하는 경우 PR은 작성자만 레이블을 할당할 수 있음을 나타내도록 업데이트됩니다.
#hold-off	마음이 바뀌거나 실수를 한 경우를 대비해 병합 준비 완료 레이블을 제거합니다. 프라이빗 리포지토리에서 이 해시 태그를 입력하면 병합하지 않음 레이블이 지정됩니다.
#please-close	변경 내용을 병합하지 않기로 결정한 경우 PR을 닫습니다.
#please-open	닫힌 PR 또는 문제를 다시 엽니다.

게시 중

다음 예약된 게시 실행에 변경 내용을 포함하려면 PR 검토자가 PR을 병합해야 합니다. 일반적으로 PR은 제출 순서대로 검토 및 병합됩니다.

참여가 승인되고 병합되면 게시 프로세스에서 선택합니다. 사용자가 기여하고 있는 리포지토리를 관리하는 팀에 따라 게시 시간이 다를 수 있지만 일반적으로 일주일에 한 번 이상 발생합니다. 문서를 게시한 후에 온라인에 표시하는 데 45분이 걸릴 수 있습니다.

변경 내용이 게시되면 다른 사람들이 학습을 시작할 수 있도록 Microsoft Learn에 게시됩니다!

다음 단계

정말 간단하죠. Microsoft Learn 콘텐츠에 기여했습니다!