View, Run, Stop, and Subscribe to Jobs
On the project's Jobs page, you can run and stop jobs, view current job run progress and run results, as well as subscribe to job notifications.
View job run results
Navigate to the project.
On the sidebar menu, choose Jobs.
Make sure the required repository and branch are selected. The page will show you the list of all jobs in the project and their run results. Here you can also apply the Jobs filter, for example, to:
leave Only actual jobs: the runs of jobs from the latest (up-to-date) version of the automation script.
leave Only outdated jobs: the runs of jobs that were changed in the latest (up-to-date) version of the automation script or that do not exist in the latest script version.
To view all runs of a particular job, click the job's name.
Click a specific job run attempt to get more details. Here you can view:
Overview: job run results including job's log.
Steps: logs for each of the job steps.
Tests: test run results (if a job contains steps that report test results). Currently, only Gradle test output is supported.
Changes: the list of VCS commits.
Artifacts: artifacts published by the job to a Packages repository.
Parameters: the list of configured, project, and provided parameters used by the job (secrets are not shown).
Run and stop jobs
By default, a job run is triggered by 'git push'. Optionally, you can specify other job triggers using the startOn
item. One more way to run a job is do it manually from the project's Jobs page.
To manually run or stop a job
Navigate to the project.
On the sidebar menu, choose Jobs.
Find the required job and:
To run the job, click Run in the job header. Note that the job will use the actual project sources (the last repository commit).
To stop the job run, click the Stop icon next to the particular run.
In some cases you might need to re-run a particular job execution using the same commit as in the original run.
To re-run a job using the same commit as in the original run
Navigate to the project.
On the sidebar menu, choose Jobs.
Open the required job and then open the required job run.
Click Re-run in the top right corner.
Run jobs with custom settings
Automation lets you customize a job run:
You can choose a particular commit that must be checked out for the job run.
If a job provides customizable parameters, you can change the default parameter values for the job run.
To make a custom job run
Navigate to the project.
On the sidebar menu, choose Jobs and find the required job.
Expand the Run button and choose Custom run.
In the opened window:
In Commit, choose a particular commit that must be checked out by the job.
Under Parameters, specify the desired parameter values.
Subscribe to job notifications
Each Automation job has a separate chat channel in Space. Automation can use this channel to notify you about job run results. By default, Space doesn't send such notifications. If you want to get results of a particular job, you should explicitly subscribe to its notifications.
Navigate to the project.
On the sidebar menu, choose Jobs.
Open the job's page by clicking its name in the header.
Click the Subscribe button on the top of the page.
To configure notifications, click the Job subscription preferences button and specify the settings:
All finished jobs: Notify about all job run results.
Only failed jobs: Notify only if the job fails.
By my commit: Notify only about jobs triggered by your commits.
Manually run by me: Notify only about jobs that you run manually.
After the job run finishes, you will receive a message on the job's chat channel.