Groups CI checks based on the sub-projects for monorepo projects.
For example, a monorepo project can define that changes checked into documentation (e.g. files in
docs/**.md) should pass a set of checks (e.g.
markdown lint and
github_pages_build), and changes checked into mobile app source code (e.g. files in
clients/app/**.dart) should pass another set of checks (e.g.
app_integration_test) before being merged. It's also possible that there is a set of checks to make sure related sub-projects are compatible (e.g.
For the situation above, there is no easy way to guard the main branch with protected branch schema. The project has to either only define a subset of full CI checks as requirement leaving the main branch less secure or define and run a full list of CI checks for every pull request slowing down merging process.
With Check Group, we can add one more CI check that is a combination of CI checks based on sub-projects of interests. The protected branch rule can depend only on the combined check.
To fit the example above into the usecase, we can use the following configuration to tell Check Group how to collect required checks:
subprojects: - id: documentation paths: - "docs/**.md" checks: - "markdown_lint" - "github_pages_build" - id: mobile_app paths: - "clients/app/**" checks: - "app_static_analysis" - "app_unit_tests" - "compatibility_check" - id: cli_app paths: - "clients/cli/**" checks: - "cli_unit_tests" - "compatibility_check"
With the configuration above, Check Group collects the requirements that will secure the main branch and only LGTM if they all pass.
Here is an example of how it works in the pull request:
A list of requirements and current fulfillment status is available in the "Details":
Note: since Check Group converts all required checks into a single check to make protected branch happy, the repository only needs to run the affected checks for pull requests. There are many ways to do on every CI/CD platform. Here's an example with GitHub Actions for the usecase above (for more details, check out the example project):
name: app checks on: pull_request: branches: - "master" paths: - "clients/app/**" jobs: app_static_analysis: ... app_unit_tests: ...