History

Mike Klein 4442bfa50b Revert "remove -Fast bots" This reverts commit `ad9ac9ae51`. Reason for revert: we _do_ build with -march=skylake. Original change's description: > remove -Fast bots > > I tried to think of how to structure things so the normal bots > and the -Fast bots would all get fast, small builds. There're > a couple ways to do it, but they're all kind of fragile. > > Then I remembered no one we know of ships Skia like the -Fast bots; > I just put them up out of curiosity, and as a performance baseline. > > So, simplest thing to do is just toss them. > > Change-Id: Id93994695c7612f41c9259aa328f6cf4cfe0f2a8 > Reviewed-on: https://skia-review.googlesource.com/c/skia/+/295311 > Reviewed-by: Ben Wagner <bungeman@google.com> > Commit-Queue: Mike Klein <mtklein@google.com> TBR=mtklein@google.com,bungeman@google.com Change-Id: Ibaddb616152a9cb03e7a28978478770888d2726a No-Presubmit: true No-Tree-Checks: true No-Try: true Reviewed-on: https://skia-review.googlesource.com/c/skia/+/295500 Reviewed-by: Mike Klein <mtklein@google.com> Commit-Queue: Mike Klein <mtklein@google.com>		2020-06-10 12:41:27 +00:00
..
build	Revert "remove -Fast bots"	2020-06-10 12:41:27 +00:00
builder_name_schema	add fm driver	2020-04-30 14:02:00 +00:00
checkout	Changing ~everything (mostly recipe related stuff) to reference Debian10 jobs	2020-04-07 12:18:06 +00:00
docker	Run docker as current user and add option to copy directory structure to docker.run.	2020-04-16 15:55:10 +00:00
doxygen	[recipes] Minor import cleanup	2020-03-06 19:06:10 +00:00
env	Roll recipe dependencies (nontrivial).	2019-06-03 11:25:16 +00:00
flavor	not all bots have `env`	2020-05-14 02:02:18 +00:00
git	Roll recipe dependencies (nontrivial).	2019-06-03 11:25:16 +00:00
gsutil	Roll recipe dependencies (nontrivial).	2019-06-03 11:25:16 +00:00
infra	[recipes] Minor import cleanup	2020-03-06 19:06:10 +00:00
run	[recipes] Minor import cleanup	2020-03-06 19:06:10 +00:00
vars	Changing ~everything (mostly recipe related stuff) to reference Debian10 jobs	2020-04-07 12:18:06 +00:00
README.md	Use new recipes.py test command	2017-04-18 13:57:56 +00:00

README.md

Skia Recipe Modules

This directory contains recipe modules designed to be used by recipes (see infra/bots/recipes). They are all Skia-specific and some are interrelated:

builder_name_schema - Helps to derive expected behavior from task (formerly builder) names.
core - Use as a starting point for most recipes: runs setup and sync steps.
ct - Shared Cluster Telemetry utilities.
flavor - Allows the caller to specify a high-level command to run, leaving the platform-specific details to be handled by the specific flavor module.
infra - Shared infrastructure-related utilities.
run - Utilities for running commands.
swarming - Utilities for running Swarming tasks.
vars - Common global variables used by Skia recipes/modules.

When you change a recipe module, you generally need to re-train the simulation test:

$ python infra/bots/recipes.py test run --train

Or:

$ cd infra/bots; make train

Each recipe module contains a few files:

api.py - This is the meat of the module.
__init__.py - Contains a single DEPS variable, indicating the other recipe modules on which this module depends.
example.py - Optional, this file contains examples which demonstrate how to use the module and should contain enough tests to achieve 100% coverage for the module. The tests are run using the recipes test command above.