Bug 1534283 - add a 'tasks_for' property; r=tomprince

Differential Revision: https://phabricator.services.mozilla.com/D23569

--HG--
extra : moz-landing-system : lando

.taskcluster.yml

@@ -241,6 +241,7 @@ tasks:
                   --project='${repository.project}'
                   --owner='${ownerEmail}'
                   --level='${repository.level}'
+                  --tasks-for='${tasks_for}'
                   --base-repository="$GECKO_BASE_REPOSITORY"
                   --head-repository="$GECKO_HEAD_REPOSITORY"
                   --head-ref="$GECKO_HEAD_REF"

taskcluster/docs/parameters.rst

@@ -45,7 +45,7 @@ Push Information
    value may be forged and *must not* be relied on for authentication.
 
 ``message``
-   The commit message
+   The try syntax in the commit message, if any.
 
 ``pushlog_id``
    The ID from the ``hg.mozilla.org`` pushlog
@@ -65,6 +65,9 @@ Push Information
    A formatted timestamp of ``build_date``. Expressed as a string with the following
    format: %Y%m%d%H%M%S
 
+``tasks_for``
+   The ``tasks_for`` value used to generate the decision task.
+
 Tree Information
 ----------------
 

taskcluster/mach_commands.py

@@ -177,6 +177,8 @@ class MachCommands(MachCommandBase):
                           'the default for the project is used.')
     @CommandArgument('--try-task-config-file',
                      help='path to try task configuration file')
+    @CommandArgument('--tasks-for',
+                     help='the tasks_for value used to generate this task')
     def taskgraph_decision(self, **options):
         """Run the decision task: generate a task graph and submit to
         TaskCluster.  This is only meant to be called within decision tasks,

taskcluster/taskgraph/decision.py

@@ -210,6 +210,7 @@ def get_decision_parameters(config, options):
         'owner',
         'level',
         'target_tasks_method',
+        'tasks_for',
     ] if n in options}
 
     for n in (

taskcluster/taskgraph/parameters.py

@@ -81,6 +81,7 @@ PARAMETERS = {
     'required_signoffs': [],
     'signoff_urls': {},
     'target_tasks_method': 'default',
+    'tasks_for': 'hg-push',
     'try_mode': None,
     'try_options': None,
     'try_task_config': None,

taskcluster/taskgraph/test/test_decision.py

@@ -62,6 +62,7 @@ class TestGetDecisionParameters(unittest.TestCase):
             'pushlog_id': 143,
             'pushdate': 1503691511,
             'owner': 'nobody@mozilla.com',
+            'tasks_for': 'hg-push',
             'level': 3,
         }