Priority
Control the order pull requests are tested and merged in the Merge Queue
Last updated
Control the order pull requests are tested and merged in the Merge Queue
Last updated
When a high-priority change must be merged quickly but still validated by the Merge queue, you can use PR Prioritization to create a PR that goes through the queue faster than others.
You specify a custom priority for a pull request at the time of insertion into the queue:
or
Valid values for the priority level:
urgent
0
urgent items will interrupt running jobs and begin testing immediately
high
10
medium
100
default priority
low
200
255
lowest possible priority
PRs with a higher priority will always begin testing before any other PR that isn't currently being tested, ensuring that prioritized PRs move into the queue as soon as they can. A PR without a priority will use the default medium (100) priority. If there is already a PR in the queue with the same priority, then the new one will be behind it.
When prioritizing a PR, Merge will explicitly not interrupt any currently testing PR, as restarting testing on PRs is usually costly, even if you want another PR to be sooner. Because of this, if a PR is submitted with a priority and there is still room in the queue to begin testing PRs, it will begin testing as normal without interrupting other PRs.
There is an exception to this rule. Sometimes, when there is a PR urgent enough to get in that it is worth the cost of restarting a currently testing PR, you can move the new PR to the front using the "urgent" priority. This is the only time Merge will reschedule a PR that is already in testing.
Say you have a queue that is configured to test two PRs at once. The queue currently looks like this:
If you submit a PR D with a "high" priority it will be put in front of C (since it is a higher priority than C and C is not testing). D will begin as soon as either A or B finishes, like this:
Instead, if you submit PR D with an "urgent" priority, then D would be tested immediately, A would be restarted, and B would be bumped back to pending, like this:
