|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | - | - |
| android_compile/ | | 03-May-2024 | - | 171 | 135 |
| assets/ | | 03-May-2024 | - | 4,471 | 2,362 |
| ct/ | | 03-May-2024 | - | 208 | 178 |
| recipe_modules/ | | 03-May-2024 | - | 40,414 | 38,168 |
| recipes/ | | 03-May-2024 | - | 92,133 | 91,237 |
| tools/luci-go/ | | 03-May-2024 | - | 17 | 10 |
| Makefile | D | 03-May-2024 | 68 | 6 | 4 |
| OWNERS | D | 03-May-2024 | 126 | 7 | 6 |
| README.md | D | 03-May-2024 | 3.4 KiB | 103 | 70 |
| android_bin.isolate | D | 03-May-2024 | 166 | 12 | 11 |
| assets.isolate | D | 03-May-2024 | 65 | 8 | 7 |
| bootstrap_win_toolchain_json.py | D | 03-May-2024 | 630 | 27 | 12 |
| bundle_recipes.isolate | D | 03-May-2024 | 267 | 15 | 14 |
| calmbench.isolate | D | 03-May-2024 | 231 | 15 | 14 |
| cfg.json | D | 03-May-2024 | 295 | 17 | 16 |
| compile_skia.isolate | D | 03-May-2024 | 124 | 11 | 10 |
| coverage_skia.isolate | D | 03-May-2024 | 196 | 7 | 6 |
| ct_skps_skia.isolate | D | 03-May-2024 | 78 | 7 | 6 |
| gen_tasks.go | D | 03-May-2024 | 49.8 KiB | 1,436 | 1,201 |
| git_utils.py | D | 03-May-2024 | 5 KiB | 139 | 108 |
| housekeeper_skia.isolate | D | 03-May-2024 | 124 | 11 | 10 |
| infra_skia.isolate | D | 03-May-2024 | 124 | 11 | 10 |
| infra_tests.py | D | 03-May-2024 | 2 KiB | 95 | 67 |
| infrabots.isolate | D | 03-May-2024 | 95 | 9 | 8 |
| ios_bin.isolate | D | 03-May-2024 | 302 | 19 | 18 |
| isolate_android_sdk_linux.isolate | D | 03-May-2024 | 117 | 8 | 7 |
| isolate_ndk_linux.isolate | D | 03-May-2024 | 117 | 8 | 7 |
| isolate_skimage.isolate | D | 03-May-2024 | 107 | 8 | 7 |
| isolate_skp.isolate | D | 03-May-2024 | 103 | 8 | 7 |
| isolate_svg.isolate | D | 03-May-2024 | 103 | 8 | 7 |
| isolate_win_toolchain.isolate | D | 03-May-2024 | 101 | 8 | 7 |
| isolate_win_vulkan_sdk.isolate | D | 03-May-2024 | 114 | 8 | 7 |
| jobs.json | D | 03-May-2024 | 33.2 KiB | 536 | 535 |
| meta_config.isolate | D | 03-May-2024 | 53 | 6 | 5 |
| perf_skia.isolate | D | 03-May-2024 | 199 | 14 | 13 |
| perf_skia_bundled.isolate | D | 03-May-2024 | 228 | 15 | 14 |
| perf_skia_bundled_unix.isolate | D | 03-May-2024 | 99 | 7 | 6 |
| perf_skia_bundled_win.isolate | D | 03-May-2024 | 98 | 7 | 6 |
| presubmit_skia.isolate | D | 03-May-2024 | 124 | 11 | 10 |
| recipes.py | D | 03-May-2024 | 6.9 KiB | 217 | 141 |
| resources.isolate | D | 03-May-2024 | 74 | 8 | 7 |
| skia_repo.isolate | D | 03-May-2024 | 99 | 9 | 8 |
| skpbench_skia.isolate | D | 03-May-2024 | 154 | 11 | 11 |
| skpbench_skia_bundled.isolate | D | 03-May-2024 | 184 | 13 | 12 |
| skpbench_skia_bundled_unix.isolate | D | 03-May-2024 | 103 | 7 | 6 |
| skpbench_skia_bundled_win.isolate | D | 03-May-2024 | 102 | 7 | 6 |
| swarm_recipe.isolate | D | 03-May-2024 | 240 | 14 | 13 |
| swarm_recipe_bundled_unix.isolate | D | 03-May-2024 | 113 | 8 | 7 |
| swarm_recipe_bundled_win.isolate | D | 03-May-2024 | 117 | 8 | 7 |
| tasks.json | D | 03-May-2024 | 1,000.1 KiB | 33,300 | 33,299 |
| test_skia.isolate | D | 03-May-2024 | 199 | 14 | 13 |
| test_skia_bundled.isolate | D | 03-May-2024 | 228 | 15 | 14 |
| test_skia_bundled_unix.isolate | D | 03-May-2024 | 99 | 7 | 6 |
| test_skia_bundled_win.isolate | D | 03-May-2024 | 98 | 7 | 6 |
| test_utils.py | D | 03-May-2024 | 2 KiB | 74 | 50 |
| update_meta_config.py | D | 03-May-2024 | 3.7 KiB | 127 | 98 |
| upload_coverage_results.isolate | D | 03-May-2024 | 124 | 11 | 10 |
| upload_dm_results.isolate | D | 03-May-2024 | 124 | 11 | 10 |
| upload_md.py | D | 03-May-2024 | 2.7 KiB | 84 | 61 |
| upload_nano_results.isolate | D | 03-May-2024 | 124 | 11 | 10 |
| upload_skps.py | D | 03-May-2024 | 2.2 KiB | 67 | 48 |
| utils.py | D | 03-May-2024 | 6.5 KiB | 202 | 143 |
| win_toolchain_utils.py | D | 03-May-2024 | 1.7 KiB | 59 | 34 |
| zip_utils.py | D | 03-May-2024 | 2.3 KiB | 71 | 52 |
| zip_utils_test.py | D | 03-May-2024 | 1.9 KiB | 75 | 45 |
README.md
1Skia Infrastructure
2===================
3
4This directory contains infrastructure elements.
5
6
7Tasks and Jobs
8--------------
9
10Files in this directory define a DAG of tasks which run at every Skia commit. A
11task is a small, self-contained unit which runs via Swarming on a machine in the
12pool. Tasks may be chained together, eg. one task to compile test binaries and
13another to actually run them.
14
15Jobs are collections of related tasks which help define sub-sections of the DAG,
16for example, to be used as try jobs. Each job is defined as an entry point into
17the DAG.
18
19The tasks.json file in this directory is the master list of tasks and jobs for
20the repo. Note that tasks.json is NEVER edited by hand but generated via
21gen_task.go and the input files enumerated below. The
22[Task Scheduler](https://skia.googlesource.com/buildbot/+/master/task_scheduler/README.md)
23reads the tasks.json file at each commit to determine which jobs to run. For
24convenience, gen_tasks.go is provided to generate tasks.json and also to test it
25for correct syntax and detecting cycles and orphaned tasks. Always edit
26gen_tasks.go or one of the following input JSON files, rather than tasks.json
27itself:
28
29 * android_map.json - Maps human-friendly names of Android devices to their
30 device codename and desired OS version. Edit this file when adding a new
31 type of Android device or updating the desired OS version.
32 * cfg.json - Basic configuration information for gen_tasks.go.
33 * gpu_map.json - Maps human-friendly names of GPUs to an appropriate Swarming
34 dimension, typically the PCI ID of the GPU. Edit this file when adding a
35 new GPU.
36 * jobs.json - The master list of all jobs to run. Edit this to add or remove
37 bots.
38
39Whenever gen_tasks.go, any of the above JSON files, or assets are changed, you
40need to run gen_tasks.go to regenerate tasks.json:
41
42 $ go run infra/bots/gen_tasks.go
43
44Or:
45
46 $ cd infra/bots; make train
47
48There is also a test mode which performs sanity-checks and verifies that
49tasks.json is unchanged:
50
51 $ go run infra/bots/gen_tasks.go --test
52
53Or:
54
55 $ cd infra/bots; make test
56
57
58Recipes
59-------
60
61Recipes are the framework used by Skia's infrastructure to perform work inside
62of Swarming tasks. The main elements are:
63
64 * recipes.py - Used for running and testing recipes.
65 * recipes - These are the entry points for each type of task, eg. compiling
66 or running tests.
67 * recipe_modules - Shared modules which are used by recipes.
68 * .recipe_deps - Recipes and modules may depend on modules from other repos.
69 The recipes.py script automatically syncs those dependencies in this
70 directory.
71
72
73Isolate Files
74-------------
75
76These files determine which parts of the repository are transferred to the bot
77when a Swarming task is triggered. The
78[Isolate tool](https://github.com/luci/luci-py/tree/master/appengine/isolate/doc)
79hashes each file and will upload any new/changed files. Bots maintain a cache so
80that they can efficiently download only the files they don't have.
81
82
83Assets
84------
85
86Artifacts used by the infrastructure are versioned here, along with scripts for
87recreating/uploading/downloading them. See the README in that directory for more
88information. Any time an asset used by the bots changes, you need to re-run
89gen_tasks.go.
90
91
92Tools
93-----
94
95Assorted other infrastructure-related tools, eg. isolate and CIPD binaries.
96
97
98CT
99--
100
101Helpers for running Skia tasks in Cluster Telemetry.
102
103