Comment on page
Customize 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.
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:
- ci/circleci: pytest
You can use wildcards (*) while specifying required CI checks. Example:
- "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.
- name: conditional_build
With this wildcard, Aviator will validate all checks with names matching this expression. This validation requires at least one matching check to be present.
Here’s an example to do this in the config file:
- '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.