Global CI Validation
Along with the CI on each individual change, you may have CI tests you would like to run on the ChangeSet as a whole before the PRs are merged. These tests can target integration-level functionality to test that all these PRs work together. Aviator offers this using a global CI framework. When you enable this setting, Aviator issues webhooks that you can use to trigger CI tests for these pre-merge checks on a ChangeSet.
Once all the PRs are added to the ChangeSet, you can trigger a Global CI by clicking the "Start CI" button on the ChangeSet page. This will send a webhook to the configured Webhook endpoint. The webhook will provide information about the related repos, branch names, and SHAs to be used for the CI. The payload will be in json format with the following parameters:
Parameters
Example
Parameter | Description |
---|---|
change_set_id | Integer. Identifier for ChangeSet. |
status_run_id | Integer. Represents a unique ID for the status run. Each time the webhook is triggered, a new Status Run ID is issued. This will be used to track the status of the CI. |
pull_requests | A list of objects representing each PullRequest in the ChangeSet. Each object has the following parameters below: |
>number | Integer. PR Number associated with the action. |
>base_branch | String. Name of the base branch associated with the PR. |
>head_branch | String. Name of the head branch associated with the PR. |
>commit_sha | String. The SHA of the latest commit on the branch. |
>author | String. The GitHub username of the PR author. |
>repo | String. The GitHub repo name represented as org_name/repo_name. |
owner | The owner of the ChangeSet. This typically represents the user who created the ChangeSet. Contains the following parameter: |
>email | String. The email address of the owner. |
custom_attributes | Object. A Dictionary of key-values as specified in the global and local parameters. |
{
"action": "changeset_start_ci",
"change_set_id": 100,
"status_run_id": 150,
"pull_requests": [
{
"number": 1196,
"head_branch": "mq-25108-1",
"base_branch": "master",
"commit_sha": "6705fd2483b1ceaaaa10bb4c34517c38d9fb6a02",
"author": "mq-demo",
"repo": "aviator/mergequeue-demo"
},
{
"number": 4114,
"head_branch": "mq-89706-1",
"base_branch": "master",
"commit_sha": "abf02ccc860eecf2d90adf7ca39d72f25479228f",
"author": "mq-demo",
"repo": "aviator/mergequeue-changeset"
}
],
"owner": {
"email": "[email protected]"
},
"custom_attributes": {
"hello": "world",
"trunk": "master"
}
}
Note: This webhook should return a valid HTTP 200 response. If an invalid status code is returned, Aviator will consider the CI as "failed".
Note: The webhook payload only includes PRs that have been added to the ChangeSet. There will be no associated entry in the webhook payload for PRs that are not included in the ChangeSet.
Once the global CI is triggered, your service should report the status check back using the
status_run
POST endpoint:post
https://api.aviator.co/api
/v1/status_run
Report CI global status check
You can run multiple global status checks and report them separately for the same status_run_id using unique name properties. Each of these unique checks are reported back as status checks on every PR in the ChangeSet.
Last modified 1yr ago