skia2/infra/bots
Mike Klein bc4a36af7c add --race to FM
Try to uncover races by running parallel replicas.

The default --race 0 should keep FM working as before, but now with
--race ≥2 we'll actively try to race replicas, syncing between tests.
--race 1 is almost pointless, just changing the thread tests run on but
without any interesting concurrency.

Rearrange a bit how fm_driver decides what flags to pass to which
invocations of FM, so individual runs can easily override defaults (e.g.
--nativeFonts overriding the usual --nonativeFonts).  Use that here to
set --race 0 for unit tests; many unit tests are not reentrant.

Change-Id: Ida451626c093793b0805d3036beb185e7d54f27e
Reviewed-on: https://skia-review.googlesource.com/c/skia/+/376761
Reviewed-by: Brian Osman <brianosman@google.com>
Reviewed-by: Eric Boren <borenet@google.com>
Commit-Queue: Mike Klein <mtklein@google.com>
2021-03-02 20:43:05 +00:00
..
assets Update SKP version 2021-02-28 06:33:05 +00:00
buildstats Build code size treemaps for skottie_tool 2019-02-12 13:54:00 +00:00
gen_tasks_logic [infra] Add Config.PathToSkia 2021-03-01 15:55:30 +00:00
recipe_modules remove 'debugging' step 2021-02-24 20:56:21 +00:00
recipes remove 'debugging' step 2021-02-24 20:56:21 +00:00
task_drivers add --race to FM 2021-03-02 20:43:05 +00:00
tools/luci-go [Isolate] Update clients to hit /_ah/api instead of /api 2018-06-04 22:14:49 +00:00
build_task_drivers.sh add Mac/Win FM bots 2021-02-01 17:35:52 +00:00
bundle_recipes.sh Reland "[infra] Run recipes through Kitchen" 2018-04-19 11:27:46 +00:00
cfg.json [infra] Add Config.PathToSkia 2021-03-01 15:55:30 +00:00
check_deps.py [canvaskit] Add support for woff2 fonts 2020-11-10 15:07:26 +00:00
gen_tasks.go Reland "[infra] Make most builds idempotent" 2019-07-19 12:11:27 +00:00
git_utils.py [infra] Change git_utils.NewGitRepo to use the default "git clone" dir 2021-02-24 17:43:04 +00:00
infra_tests.py [infra] Run recipe and python unittests unbuffered 2020-03-18 15:33:38 +00:00
jobs.json Rename Test-Mac10.15.1-Clang-VMware7.1-CPU-AVX-x86_64-Debug-All-NativeFonts 2021-02-25 16:52:14 +00:00
Makefile Add infra/bots/Makefile to simplify test/train 2017-04-13 17:01:17 +00:00
OWNERS [infra] Remove stephana@ from OWNERS 2019-06-21 12:07:54 +00:00
README.md Remove "sanity"/"insane" to comply with Android's inclusive language guidance 2020-07-31 19:21:04 +00:00
README.recipes.md [infra] Fix InfraTests recipe for other repos which use it 2021-02-23 17:42:38 +00:00
recipes.py Roll recipe dependencies (trivial). 2019-05-22 17:57:25 +00:00
run_recipe.py [infra] Use CIPD packages from infra repo 2019-11-20 14:02:48 +00:00
tasks.json Update SKP version 2021-02-28 06:33:05 +00:00
test_utils.py [minor] mark scripts as executable 2019-11-21 17:06:27 +00:00
upload_skps.py [Android compile bots] Add comment to CL when both nopatch and withpatch builds fail 2019-10-28 14:55:01 +00:00
utils.py [minor] mark scripts as executable 2019-11-21 17:06:27 +00:00
zip_utils_test.py remove more blacklists 2020-07-24 18:14:29 +00:00
zip_utils.py remove more blacklists 2020-07-24 18:14:29 +00:00

Skia Infrastructure

This directory contains infrastructure elements.

Tasks and Jobs

Files in this directory define a DAG of tasks which run at every Skia commit. A task is a small, self-contained unit which runs via Swarming on a machine in the pool. Tasks may be chained together, eg. one task to compile test binaries and another to actually run them.

Jobs are collections of related tasks which help define sub-sections of the DAG, for example, to be used as try jobs. Each job is defined as an entry point into the DAG.

The tasks.json file in this directory is the list of tasks and jobs for the repo. Note that tasks.json is NEVER edited by hand but generated via gen_task.go and the input files enumerated below. The Task Scheduler reads the tasks.json file at each commit to determine which jobs to run. For convenience, gen_tasks.go is provided to generate tasks.json and also to test it for correct syntax and detecting cycles and orphaned tasks. Always edit gen_tasks.go or one of the following input JSON files, rather than tasks.json itself:

  • cfg.json - Basic configuration information for gen_tasks.go.
  • jobs.json - The list of all jobs to run. Edit this to add or remove bots.

Whenever gen_tasks.go, any of the above JSON files, or assets are changed, you need to run gen_tasks.go to regenerate tasks.json:

$ go run infra/bots/gen_tasks.go

Or:

$ cd infra/bots; make train

There is also a test mode which performs consistency checks and verifies that tasks.json is unchanged:

$ go run infra/bots/gen_tasks.go --test

Or:

$ cd infra/bots; make test

Recipes

Recipes are the framework used by Skia's infrastructure to perform work inside of Swarming tasks. The main elements are:

  • recipes.py - Used for running and testing recipes.
  • recipes - These are the entry points for each type of task, eg. compiling or running tests.
  • recipe_modules - Shared modules which are used by recipes.
  • .recipe_deps - Recipes and modules may depend on modules from other repos. The recipes.py script automatically syncs those dependencies in this directory.

Isolate Files

These files determine which parts of the repository are transferred to the bot when a Swarming task is triggered. The Isolate tool hashes each file and will upload any new/changed files. Bots maintain a cache so that they can efficiently download only the files they don't have.

Assets

Artifacts used by the infrastructure are versioned here, along with scripts for recreating/uploading/downloading them. See the README in that directory for more information. Any time an asset used by the bots changes, you need to re-run gen_tasks.go.

Tools

Assorted other infrastructure-related tools, eg. isolate and CIPD binaries.

CT

Helpers for running Skia tasks in Cluster Telemetry.