병합 큐와 끌어오기 요청 병합

이 문서의 내용

분기의 분기 보호 설정에 병합 큐가 필요한 경우 병합 큐에 끌어오기 요청을 추가할 수 있습니다. 그러면 모든 필수 검사가 통과된 후 GitHub Enterprise Cloud가 끌어오기 요청을 병합합니다.

Tool navigation

Pull request merge queues are available in any public repository owned by an organization, or in private repositories owned by organizations using GitHub Enterprise Cloud. For more information, see "GitHub’s plans."

병합 큐 정보

병합 큐는 끌어오기 요청 병합을 사용 중인 분기로 자동화하고 호환되지 않는 변경으로 분기가 중단되지 않도록 하여 속도를 높이는 데 도움이 됩니다.

병합 큐는 분기 보호를 병합하기 전에 분기를 최신 상태로 유지하도록 요구하는 것과 동일한 이점을 제공하지만 끌어오기 요청 작성자가 끌어오기 요청 분기를 업데이트하고 병합을 시도하기 전에 상태 검사 완료될 때까지 기다릴 필요는 없습니다.

병합 큐를 사용하는 것은 매일 다양한 사용자로부터 병합되는 끌어오기 요청 수가 비교적 많은 분기에서 특히 유용합니다.

끌어오기 요청이 필요한 모든 분기 보호 검사를 통과한 후 리포지토리에 대한 쓰기 액세스 권한이 있는 사용자가 해당 끌어오기 요청을 큐에 추가할 수 있습니다. 병합 큐는 대상 분기의 최신 버전 및 큐에 이미 있는 끌어오기 요청에 적용할 때 끌어오기 요청의 변경 내용이 필요한 모든 상태 확인을 통과하도록 보장합니다.

병합 큐는 GitHub Actions 또는 사용자 고유의 CI 공급자를 사용하여 병합 큐의 끌어오기 요청에 필요한 검사를 실행할 수 있습니다. 자세한 내용은 "GitHub Actions 설명서"을 참조하세요.

병합 큐에 대한 자세한 내용은 "병합 큐 관리"을 참조하십시오.

병합 큐에 끌어오기 요청 추가

참고: GitHub CLI을(를) 사용하여 병합 큐에 끌어오기 요청을 추가할 수 있습니다. 자세한 내용은 이 문서 위쪽에 있는 GitHub CLI 탭을 클릭합니다.

  1. GitHub.com에서 리포지토리의 기본 페이지로 이동합니다.

  2. 리포지토리 이름에서 끌어오기 요청을 클릭합니다.

    리포지토리의 기본 페이지 스크린샷 가로 탐색 모음에서 "끌어오기 요청"이라는 레이블이 있는 탭이 진한 주황색 윤곽선으로 표시되어 있습니다.

  3. "끌어오기 요청" 목록에서 병합 큐에 추가하려는 끌어오기 요청을 클릭합니다.

  4. 병합 큐에 끌어오기 요청을 추가할 준비가 되면 병합을 클릭합니다. 또는 관리자인 경우 다음을 수행할 수 있습니다.

    • 분기 보호 설정에서 허용되는 경우 요구 사항이 충족될 때까지 기다리지 않고 병합(분기 보호 무시) 을 선택하여 끌어오기 요청을 직접 병합하고 표준 흐름을 따릅니다.

    끌어오기 요청에 대한 병합 큐 옵션의 스크린샷

    참고: 제안된 변경 내용을 병합할 준비가 되면 준비가 되면 병합을 클릭할 수 있습니다. GitHub Enterprise Cloud은 필요한 승인 및 상태 검사 조건이 충족되면 병합 큐에 끌어오기 요청을 자동으로 추가합니다.

  5. 준비되면 병합 확인을 클릭하여 병합 큐에 끌어오기 요청을 추가할 것인지 확인합니다.

GitHub CLI에서는 gh pr merge 명령을 사용하여 병합 큐에 끌어오기 요청을 추가할 수 있습니다. 병합 큐가 필요한 분기를 대상으로 하는 경우 이 명령은 필요한 검사를 통과하면 끌어오기 요청을 큐에 자동으로 추가합니다. 필요한 검사를 통과하지 못한 경우 이 명령은 끌어오기 요청에 대해 자동 병합을 사용하도록 설정합니다. 자세한 내용은 GitHub CLI 매뉴얼의 “gh pr merge”을(를) 참조하세요.

병합 큐에서 끌어오기 요청 제거

병합 큐에서 끌어오기 요청을 제거하려면 GitHub.com의 리포지토리 페이지로 이동해야 합니다. GitHub CLI을(를) 사용하여 병합 큐에서 끌어오기 요청을 제거할 수 없습니다.

  1. GitHub.com에서 리포지토리의 기본 페이지로 이동합니다.

  2. 리포지토리 이름에서 끌어오기 요청을 클릭합니다.

    리포지토리의 기본 페이지 스크린샷 가로 탐색 모음에서 "끌어오기 요청"이라는 레이블이 있는 탭이 진한 주황색 윤곽선으로 표시되어 있습니다.

  3. "끌어오기 요청" 목록에서 병합 큐에서 제거하려는 끌어오기 요청을 클릭합니다.

  4. 큐에서 끌어오기 요청을 제거하려면 큐에서 제거를 클릭합니다.

    끌어오기 요청 아래쪽에 있는 병합 큐 메시지의 스크린샷. "큐에서 제거" 단추가 진한 주황색 윤곽선으로 표시되어 있습니다.

또는 기본 분기의 병합 큐 페이지로 이동하여 제거할 끌어오기 요청 옆의 ... 를 클릭하고 큐에서 제거를 선택할 수 있습니다. 기본 분기의 병합 큐 페이지로 이동하는 방법에 대한 자세한 내용은 아래 섹션을 참조하세요.

병합 큐 보기

GitHub Enterprise Cloud의 다양한 위치에서 기본 분기에 대한 병합 큐를 볼 수 있습니다. GitHub CLI을(를) 사용하여 병합 큐를 볼 수 없습니다.

GitHub Enterprise Cloud의 다양한 위치에서 기본 분기에 대한 병합 큐를 볼 수 있습니다.

  • 리포지토리의 분기 페이지에서 큐에 이미 있는 끌어오기 요청이 없거나 모르는 경우와 해당 큐에 있는 항목을 확인하려는 경우 이 경로를 사용하는 것이 좋습니다. 자세한 내용은 "리포지토리에서 분기 보기"을 참조하세요.

    리포지토리의 "분기" 페이지 스크린샷. "병합 대기 중인 끌어오기 요청 33개"라는 레이블이 표시된 링크가 진한 주황색 윤곽선으로 표시되어 있습니다.

  • 병합 큐를 병합하는 데 필요한 경우 끌어오기 요청 페이지에서 타임라인의 아래쪽으로 스크롤하여 병합 큐 링크를 클릭합니다.

    끌어오기 요청 아래쪽에 있는 병합 큐 메시지의 스크린샷. "병합 큐" 링크가 진한 주황색 윤곽선으로 표시되어 있습니다.

  • 병합 큐 보기에는 현재 큐에 있는 끌어오기 요청이 표시되고 끌어오기 요청이 명확하게 표시됩니다.

    병합 큐의 스크린샷.

끌어오기 요청이 병합 큐에서 제거된 이유 이해

대상 분기의 최신 버전 및 그 전에 발생한 변경으로 끌어오기 요청을 그룹화하고 큐에서 변경한 후 필수 상태 검사에 실패하거나 기본 분기와 충돌하는 경우 끌어오기 요청이 큐에서 제거됩니다. 끌어오기 요청 타임라인은 끌어오기 요청이 큐에서 제거된 이유를 표시합니다.

병합 큐에서 끌어오기 요청을 제거할 수 있는 여러 가지 이유가 있습니다.

  • 구성된 CI 서비스가 병합 그룹에 대한 테스트 실패 보고
  • 구성된 시간 제한 설정을 기반으로 성공적인 CI 결과를 기다리는 동안 시간 초과
  • API 또는 병합 큐 인터페이스를 통해 제거를 요청하는 사용자
  • 자동으로 해결할 수 없는 분기 보호 오류