About merge queues
A merge queue helps merge pull requests into a busy protected branch after required checks pass. See Verwalten einer Zusammenführungswarteschlange.
Adding a pull request to a merge queue
Hinweis
You can use GitHub CLI to add a pull request to a merge queue. For more information, click the "GitHub CLI" tab at the top of this article.
-
Navigieren Sie auf GitHub zur Hauptseite des Repositorys.
-
Klicke unter dem Namen deines Repositorys auf Pull requests.
-
In the "Pull Requests" list, click the pull request you want to add to a merge queue.
-
Click Merge when ready to add the pull request to the merge queue. Alternatively, if you are an administrator, you can:
- Directly merge the pull request by checking Merge without waiting for requirements to be met (bypass branch protections), if allowed by branch protection settings, and follow the standard flow.
Hinweis
You can click Merge when ready before all requirements pass. GitHub adds the pull request to the queue when requirements are met.
-
Confirm you want to add the pull request to the merge queue by clicking Confirm merge when ready.
With GitHub CLI, use the gh pr merge command to add a pull request to a merge queue. If you are targeting a branch that requires a merge queue, this command automatically adds the pull request to the queue if required checks have passed. If required checks have not passed, this command enables auto-merge for the pull request. See gh pr merge in the GitHub CLI manual.
Removing a pull request from a merge queue
To remove a pull request from a merge queue, you must navigate to the repository's page on Ihre GitHub Enterprise Server-Instance. You cannot use GitHub CLI to remove a pull request from a merge queue.
-
Navigieren Sie auf GitHub zur Hauptseite des Repositorys.
-
Klicke unter dem Namen deines Repositorys auf Pull requests.
-
In the "Pull Requests" list, click the pull request you want to remove from a merge queue.
-
To remove the pull request from the queue, click Remove from queue.
Alternatively, you can navigate to the merge queue page for the base branch, click ... next to the pull request you want to remove, and select Remove from queue. For information about getting to the merge queue page for the base branch, see the section below.
Viewing merge queues
You can view the merge queue for a base branch in various places on GitHub. You cannot use GitHub CLI to view a merge queue.
You can view the merge queue for a base branch in various places on GitHub.
-
On the Branches page for the repository. We recommend this route if you don't have or don't know about a pull request already in a queue, and if you want to see what's in that queue. See Branches in Deinem Repository anzeigen.
-
On the pull request page, when a merge queue is required for merging, scroll to the bottom of the timeline and click the merge queue link.
-
The merge queue view shows the pull requests that are currently in the queue, with your pull requests clearly marked.
Understanding why your pull request was removed from the merge queue
A pull request can be removed from the merge queue if it no longer meets merge requirements or if a queue check fails.
Es gibt eine Reihe von Gründen, warum ein Pull Request aus einer Mergewarteschlange entfernt wird:
- Der konfigurierte CI-Dienst meldet Testfehler für eine Mergegruppe.
- Beim Warten auf ein erfolgreiches CI-Ergebnis ist basierend auf der konfigurierten Timeouteinstellung ein Timeout aufgetreten.
- Eine Benutzerin fordert eine Entfernung über die API oder die Schnittstelle der Mergewarteschlange an.
- Fehler beim Branchschutz, der nicht automatisch behoben werden konnte