Skia uses Swarming to do the heavy lifting for our automated testing. It farms out tasks, which may consist of compiling code, running tests, or any number of other things, to our bots, which are virtual or real machines living in our local lab, Chrome Infra's lab, or in GCE.
The Skia Task Scheduler determines what tasks should run on what bots at what time. See the link for a detailed explanation of how relative task priorities are derived. A task corresponds to a single Swarming task. A job is composed of a directed acyclic graph of one or more tasks. The job is complete when all of its component tasks have succeeded or is considered a failure when any of its component tasks fails. The scheduler may automatically retry tasks within its set limits. Jobs are not retried. Multiple jobs may share the same task, for example, tests on two different Android devices which use the same compiled code.
Each Skia repository has an
infra/bots/tasks.json file which defines the jobs and tasks for the repo. Most jobs will run at every commit, but it is possible to specify nightly and weekly jobs as well. For convenience, most repos also have a
gen_tasks.go which will generate
tasks.json. You will need to install Go. From the repository root:
$ go run infra/bots/gen_tasks.go
It is necessary to run
gen_tasks.go every time it is changed or every time an asset has changed. There is also a test mode which simply verifies that the
tasks.json file is up to date:
$ go run infra/bots/gen_tasks.go --test
Skia's trybots allow testing and verification of changes before they land in the repo. You need to have permission to trigger try jobs; if you need permission, ask a committer. After uploading your CL to Gerrit, you may trigger a try job for any job listed in
tasks.json, either via the Gerrit UI, using
git cl try, eg.
git cl try -B skia.primary -b Some-Tryjob-Name
bin/try, a small wrapper for
git cl try which helps to choose try jobs. From a Skia checkout:
You can also search using regular expressions:
The status view shows a table with tasks, grouped by test type and platform, on the X-axis and commits on the Y-axis. The cells are colored according to the status of the task for each commit:
Commits are listed by author, and the branch on which the commit was made is shown on the very left. A purple result will override an orange result.
For more detail, you can click on an individual cell to get a summary of the task. You can also click one of the white bars at the top of each column to see a summary of recent tasks with the same name.
The status page has several filters which can be used to show only a subset of task specs:
If you would like to add jobs to build or test new configurations, please file a New Bot Request.
If you know that the new jobs will need new hardware or you aren't sure which existing bots should run the new jobs, assign to jcgregorio. Once the Infra team has allocated the hardware, we will assign back to you to complete the process.
Generally it's possible to copy an existing job and make changes to accomplish what you want. You will need to add the new job to infra/bots/jobs.json. In some cases, you will need to make changes to recipes:
After modifying any of the above files, run
make train in the infra/bots directory to update generated files. Upload the CL, then run
git cl try -B skia.primary -b <job name> to run the new job. (After commit, the new job will appear in the PolyGerrit UI after the next successful run of the Housekeeper-Nightly-UpdateMetaConfig task.)
infra/bots/gen_tasks.go reads config files:
Based on each job name in jobs.json, gen_tasks decides which tasks to generate (process function). Various helper functions return task name of the direct dependencies of the job.
In gen_tasks, tasks are specified with a TaskSpec. A TaskSpec specifies how to generate and trigger a Swarming task.
Most Skia tasks run a recipe with Kitchen. The arguments to the kitchenTask function specify the most common parameters for a TaskSpec that will run a recipe. More info on recipes at infra/bots/recipes/README.md and infra/bots/recipe_modules/README.md.
The Swarming task is generated based on several parameters of the TaskSpec:
If you need to do something more complicated, or if you are not sure how to add and configure the new jobs, please ask for help from borenet, benjaminwagner, or mtklein.