참고
This feature is in public preview and subject to change.
How the code coverage rule works
The Restrict code coverage rule evaluates uploaded line coverage data against the configured thresholds. It does not wait for coverage uploads to complete.
To prevent a pull request from being merged before all expected coverage results are available, make each status check associated with an expected coverage upload a required status check. This includes coverage uploaded from separate jobs or workflows.
For more information about line coverage, see Code coverage reference.
Prerequisites
- GitHub Code Quality is enabled on the repository.
- Code coverage data is uploaded to GitHub for the pull request branch. See Setting up code coverage for your repository.
Creating a coverage threshold rule
-
On GitHub, navigate to the main page of the repository.
-
Under your repository name, click Settings. If you cannot see the "Settings" tab, select the dropdown menu, then click Settings.
-
In the left sidebar, under "Code, planning, and automation", click Rulesets, then click Rulesets.
-
Create a new branch ruleset or click an existing one to edit it.
-
Under "Branch rules", select Restrict code coverage.
-
Expand Additional settings to configure thresholds. A value of 0 means that the threshold is disabled.
- Minimum line coverage percentage: enter a value to block pull requests where aggregated line coverage falls below this percentage.
- Maximum line coverage drop: enter a value to block pull requests where line coverage drops by more than this many percentage points relative to the default branch.
-
Click Create or Save changes.
