Start by configuring Cirrus CI application from GitHub Marketplace.
And install Cirrus CI for your personal account or for an organization you have admin writes for.
Github Apps can be installed on all repositories or on repository-by-repository basis for granular access control. For example, Cirrus CI can be installed only on public repositories and will only have access to these public repositories. In contrast, classic OAuth Apps doesn't have such restrictions.
Once Cirrus CI is installed for a particular repository
.cirrus.yml configuration file should be added to the root of the repository.
.cirrus.yml defines tasks that will be executed for every build for the repository.
For a simple Java project
.cirrus.yml can look like:
container: image: gradle:jdk8 cpu: 4 memory: 10G check_task: script: gradle check
That's all! After pushing
.cirrus.yml a build with all the tasks defined in
.cirrus.yml file will be created.
GitHub status checks for each task will appear momentarily.
Newly create PRs will also get Cirrus CI's status checks.
Don't forget to check examples page for ready-to-copy examples of
.cirrus.yml configuration files
for different languages and build systems.
Life of a build
Please check a high level overview of what's happening under the hood when a changed is pushed and this guide to learn more about how to write tasks.