병합 큐 관리

참고: 끌어오기 요청 병합 큐 기능은 현재 퍼블릭 베타 버전이며 변경될 수 있습니다.

병합 큐 정보

병합 큐는 모든 필수 분기 보호 검사에 통과하도록 하면서 끌어오기 요청이 사용 중인 대상 분기에 병합되는 속도를 높일 수 있습니다.

끌어오기 요청이 필요한 모든 분기 보호 검사를 통과한 후 리포지토리에 대한 쓰기 액세스 권한이 있는 사용자가 해당 끌어오기 요청을 병합 큐에 추가할 수 있습니다.

병합 큐는 GitHub Actions를 사용할 수 있습니다. 자세한 내용은 "GitHub Actions 설명서"을 참조하세요.

병합 큐는 특수 접두사가 있는 임시 분기를 만들어 끌어오기 요청 변경 내용의 유효성을 검사합니다. 그런 다음 끌어오기 요청의 변경 내용이 최신 버전의 base_branch 및 큐에서 앞에 있는 변경 내용과 함께 merge_group으로 그룹화됩니다. GitHub Enterprise Cloud는 base_branch의 분기 보호에 필요한 검사에 통과한 후 모든 변경 내용을 base_branch에 병합합니다.

병합 메서드에 대한 자세한 내용은 "끌어오기 요청 병합 정보.

참고:

분기 이름 패턴에 와일드카드 문자(*)를 사용하는 분기 보호 규칙으로 병합 큐를 사용하도록 설정할 수는 없습니다.
병합 큐는 병합을 진행하기 전에 필요한 검사가 보고될 때까지 기다립니다. 병합 큐가 필요한 경우 병합 그룹 이벤트를 트리거하고 보고하도록 CI 구성을 업데이트해야 합니다.

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

GitHub Actions으로 병합 그룹 검사 트리거

끌어오기 요청이 병합 그룹에 추가되면 merge_group 이벤트를 사용하여 GitHub Actions 워크플로를 트리거할 수 있습니다. 이 이벤트는 pull_request 및 push 이벤트와는 다른 이벤트입니다.

참고: 리포지토리에서 GitHub Actions을(를) 사용하여 리포지토리의 끌어오기 요청에 대해 필요한 검사를 수행하는 경우 이벤트를 추가 트리거로 포함 merge_group 하도록 워크플로를 업데이트해야 합니다. 그렇지 않으면 병합 큐에 끌어오기 요청을 추가할 때 상태 확인 트리거되지 않습니다. 상태 확인 필요 보고되지 않으므로 병합이 실패합니다.

대상 분기의 보호에 필요한 검사를 보고하는 워크플로는 다음과 같습니다.

on:
  pull_request:
  merge_group:

자세한 내용은 "워크플로를 트리거하는 이벤트"을 참조하세요.

다른 CI 공급자를 사용하여 병합 그룹 검사 트리거

다른 CI 공급자를 사용하면 특수 접두사 gh-readonly-queue/{base_branch}로 시작하는 분기가 만들어질 때 실행되도록 CI 구성을 업데이트해야 할 수 있습니다.