GitHub Check report

GitHub Checks API allows third-party applications to attach contextual information(status, conclusion, details, annotations) to a GitHub commit. After a successful job, RelativeCI GitHub application adds a Check with status, conclusion and details to the corresponding GitHub commit.

RelativeCI GitHub Check information

When the commit is the last in a pull request, the Check information is also available on the pull request checks section or under the Checks tab:

RelativeCI Pull Request GitHub Check information

Click on Details link to navigate to the GitHub Check details report. The report shows the current, the baseline, and the delta values for all generic and file type metrics. Click on the metric label link to navigate to the specific section of the RelativeCI report.

Rule-based GitHub Check conclusion

GitHub Checks conclusion allows third-party applications to set the result of the check for the current changes. Depending on the conclusion value, GitHub will show a different icon to inform the user about the result of the check:

RelativeCI GitHub Checks conclusions

By default, the GitHub Check conclusion is set to neutral. You can add rules to customize when to set the conclusion to success, action_required or failure.

Manage GitHub Checks rules

Managing project settings functionality is available for users with the admin role for the project or organization.

To manage the integration rules, navigate to Project -> Settings -> Integrations and go to GitHub Check section. You can add conditions based on any generic metric value or change(value or procentual):

RelativeCI GitHub Check settings rules

RelativeCI evaluates the conditions for all active rules and sets the GitHub Check conclusion based on the matched rule with the highest severity level.

RelativeCI Pull Request GitHub Check information with rules result

Examples

Set check conclusion to Success on Bundle Size decrease:

RelativeCI GitHub Check rules example - success on bundle size decrease

Set check conclusion to Action required on Bundle Size increase with more than 5KB:

RelativeCI GitHub Check rules example - action_required on bundle size increase

Set check conclusion to Failure on Duplicate packages increase:

RelativeCI GitHub Check rules example - failure on duplicate packages increase

Set check conclusion to Action required on Bundle size increase with more than 5KB, or Initial JS increase, or Packages count increase:

RelativeCI GitHub Check rules example - action_required on bundle size increase or package count increase or initial javascript increase

Need help?Contact us via email, Twitter, or GitHub!