Customizing required checks
You can configure required checks in a few different ways.
This is the default setting. When this configuration is enabled, Aviator will fetch the required checks from GitHub’s branch protection rules. These are also the default required checks for validating draft PRs in parallel mode.
merge_rules:
labels:
trigger: "mergequeue"
preconditions:
use_github_mergeability: true
You can alternatively specify a set of separate required checks. This may be useful if you want additional validation before merging your PR, or if you have different requirements for various base branches. The custom checks can be specified from the merge rules UI or from the config file.
Aviator already pre-populates all the checks from your repository here and default selects the required GitHub checks.

Customize required checks modal
While specifying in the config file, you should follow the naming convention as specified in your GitHub pull requests. Typically it is the full bolded name in the PR. Example:

status checks from GitHub Pull Request
So in this case, the check for the last CircleCI test will be
ci/circleci: pytest
, but for the case of GitHub actions, only the job name is used (after forward slash). So the above check names would be in-order:merge_rules:
preconditions:
use_github_mergeability: false
required_checks:
- build
- unit-test
- typecheck
- ci/circleci: pytest
You can use wildcards (*) while specifying required CI checks. Example:
required_checks:
- "ci/circleci: check_1"
- "golang-*" # matches golang-test, golang-lint, etc.
You can set custom acceptable statuses in the required check to support additional check statuses other than the default success.
In the below example, Aviator will only consider the check unit-test as passing if we receive a success status. But for the check named conditional_build, Aviator will also consider a skipped status as passing. Likewise, you can specify any acceptable status defined here.
merge_rules:
labels:
trigger: mq
preconditions:
required_checks:
- unit-test
- name: conditional_build
acceptable_statuses:
- success
- skipped
With this wildcard, Aviator will validate all checks with names matching this expression. This validation requires at least one matching check to be present.
You can customize the required checks for parallel mode using the Merge Rules UI or via the config file. You can read more here.
Here’s an example to do this in the config file:
merge_mode:
type: "parallel"
parallel_mode:
override_required_checks:
- build_and_test
- 'ci/circleci: build'
You can also configure Aviator to enforce all checks to pass. If true, any failing test will cause the PR to be dequeued. This may work well if your repo has conditional checks. Requires at least one check to be present. You can set this both for the original PR and the draft PR.
merge_rules:
labels:
trigger: "label_name"
require_all_checks_pass: true
merge_mode:
type: "parallel"
parallel_mode:
require_all_draft_checks_pass: true
Last modified 1mo ago