no bug - taskcluster doc: Refresh the section about 'run_on_projects' r=marco
authorSylvestre Ledru <sledru@mozilla.com>
Fri, 15 May 2020 08:13:01 +0000
changeset 531213 d6646e3a3564f3c42c861d84fc2f7841ae218ec0
parent 531212 bee9ce859d09e30c77c00d4482e46a5edc42b4ea
child 531214 f81d65748d1f3c14a87c266fab7eb3b0cb69addb
push id37435
push userapavel@mozilla.com
push dateWed, 20 May 2020 15:28:23 +0000
treeherdermozilla-central@5415da14ec9a [default view] [failures only]
perfherder[talos] [build metrics] [platform microbench] (compared to previous push)
reviewersmarco
milestone78.0a1
first release with
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
last release without
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
no bug - taskcluster doc: Refresh the section about 'run_on_projects' r=marco Differential Revision: https://phabricator.services.mozilla.com/D75260
taskcluster/docs/attributes.rst
--- a/taskcluster/docs/attributes.rst
+++ b/taskcluster/docs/attributes.rst
@@ -18,30 +18,54 @@ kind
 
 A task's ``kind`` attribute gives the name of the kind that generated it, e.g.,
 ``build`` or ``spidermonkey``.
 
 run_on_projects
 ===============
 
 The projects where this task should be in the target task set.  This is how
-requirements like "only run this on inbound" get implemented.  These are
-either project names or the aliases
+requirements like "only run this on autoland" get implemented.
+
+.. note::
+
+    Please use this configuration. Running a job for all projects can quickly add up
+    in term of cost while not providing any value for some projects.
+
+`run-on-projects` can use either aliases or project names.
+
+These are the aliases:
 
- * `integration` -- integration repositories (autoland, inbound, etc)
- * `trunk` -- integration repositories plus mozilla-central
- * `release` -- release repositories including mozilla-central
+ * `integration` -- integration repository (autoland)
+ * `trunk` -- integration repository plus mozilla-central
+ * `release` -- release repositories (beta, release, esr) including mozilla-central
  * `all` -- everywhere (the default)
 
+Project names are the repositories.  They can be:
+
+* `autoland`
+* `mozilla-central`
+* `mozilla-beta`
+* `mozilla-release`
+* `mozilla-esr68`
+* ... A partial list can be found in taskcluster/taskgraph/util/attributes.py
+
 For try, this attribute applies only if ``-p all`` is specified.  All jobs can
 be specified by name regardless of ``run_on_projects``.
 
 If ``run_on_projects`` is set to an empty list, then the task will not run
 anywhere, unless its build platform is specified explicitly in try syntax.
 
+
+.. note::
+
+    As `try` pushes don't use filter_for_projects by design, there isn't a way
+    to define that a task will run on `try`.
+
+
 run_on_hg_branches
 ==================
 
 On a given project, the mercurial branch where this task should be in the target
 task set.  This is how requirements like "only run this RELBRANCH" get implemented.
 These are either the regular expression of a branch (e.g.: ``GECKOVIEW_\d+_RELBRANCH``)
 or the following alias: