bots - OpenGrok cross reference for /external/skia/infra/bots/

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](https://skia.googlesource.com/buildbot/+/main/task_scheduler/README.md)
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:

	$ make -C infra/bots 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:

	$ make -C infra/bots 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](https://github.com/luci/luci-py/tree/main/appengine/isolate/doc)
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.
Name		Date	Size	#Lines	LOC
..		-	-
analysis/		03-May-2024	-	114	42
assets/		03-May-2024	-	3,356	1,957
buildstats/		03-May-2024	-	457	301
gen_tasks_logic/		03-May-2024	-	5,530	4,242
recipe_modules/		03-May-2024	-	44,728	43,303
recipes/		03-May-2024	-	25,979	25,328
task_drivers/		03-May-2024	-	6,869	5,592
tools/luci-go/		03-May-2024	-	17	10
BUILD.bazel	D	03-May-2024	2.9 KiB	54	50
Makefile	D	03-May-2024	58	6	4
README.md	D	03-May-2024	3 KiB	97	64
README.recipes.md	D	03-May-2024	43.3 KiB	602	367
build_task_drivers.sh	D	03-May-2024	1.4 KiB	33	9
bundle_recipes.sh	D	03-May-2024	320	16	8
cfg.json	D	03-May-2024	1.1 KiB	27	26
check_deps.py	D	03-May-2024	1.9 KiB	72	48
gen_tasks.go	D	03-May-2024	359	19	7
git_utils.py	D	03-May-2024	5.8 KiB	164	132
infra_tests.py	D	03-May-2024	1.9 KiB	91	63
jobs.json	D	03-May-2024	56.7 KiB	1,043	1,043
recipes.py	D	03-May-2024	8.5 KiB	266	175
run_recipe.py	D	03-May-2024	1.2 KiB	41	29
tasks.json	D	03-May-2024	4.2 MiB	94,365	94,364
test_utils.py	D	03-May-2024	2 KiB	74	50
utils.py	D	03-May-2024	6.6 KiB	204	145
zip_utils.py	D	03-May-2024	2.5 KiB	79	60
zip_utils_test.py	D	03-May-2024	1.9 KiB	75	45