Files
sousa-gecko/taskcluster/docs/transforms/job.md
T
Sylvestre Ledru b59392716e Bug 2038819 - Convert taskcluster/docs RST to Markdown r=taskgraph-reviewers,releng-reviewers,bhearsum
Convert taskcluster/docs/*.rst (including transforms, kinds, optimization,
howto subdirectories) and gecko_taskgraph test docs to MyST-flavored
Markdown.

Refresh allowed-warnings glob for release-promotion-action from .rst
to .md.

Differential Revision: https://phabricator.services.mozilla.com/D304225
2026-07-04 10:18:25 +00:00

1.6 KiB

Job Transforms

:::{note} These transforms are currently duplicated by standalone Taskgraph and will likely be refactored / removed at a later date. :::

A job description says what to run in the task. It is a combination of a run section and all of the fields from a task description. The run section has a using property that defines how this task should be run; for example, mozharness to run a mozharness script, or mach to run a mach command. The remainder of the run section is specific to the run-using implementation.

The effect of a job description is to say "run this thing on this worker". The job description must contain enough information about the worker to identify the workerType and the implementation (docker-worker, generic-worker, etc.). Alternatively, job descriptions can specify the platforms field in conjunction with the by-platform key to specify multiple workerTypes and implementations. Any other task-description information is passed along verbatim, although it is augmented by the run-using implementation.

The run-using implementations are all located in taskcluster/gecko_taskgraph/transforms/job, along with the schemas for their implementations. Those well-commented source files are the canonical documentation for what constitutes a job description, and should be considered part of the documentation.

following run-using are available

  • hazard
  • mach
  • mozharness
  • mozharness-test
  • run-task
  • spidermonkey or spidermonkey-package
  • debian-package
  • ubuntu-package
  • toolchain-script
  • always-optimized
  • fetch-url
  • python-test
  • gradlew
  • mach-gradle
  • run-commands