taskcluster/docs/index.rst
author Brian Hackett <bhackett1024@gmail.com>
Wed, 14 Nov 2018 16:09:58 -1000
changeset 446931 1c7fc8389e012c987347efefca6b35f3948b742a
parent 423285 927bbe6abacff9b55d54c9c52d6a656f0a46112b
permissions -rw-r--r--
Bug 1507359 Part 2 - Bindings and internal changes to allow ReplayDebugger to control child pausing/resuming, r=mccr8.

.. taskcluster_index:

TaskCluster Task-Graph Generation
=================================

The ``taskcluster`` directory contains support for defining the graph of tasks
that must be executed to build and test the Gecko tree.  This is more complex
than you might suppose!  This implementation supports:

 * A huge array of tasks
 * Different behavior for different repositories
 * "Try" pushes, with special means to select a subset of the graph for execution
 * Optimization -- skipping tasks that have already been performed
 * Extremely flexible generation of a variety of tasks using an approach of
   incrementally transforming job descriptions into task definitions.

This section of the documentation describes the process in some detail,
referring to the source where necessary.  If you are reading this with a
particular goal in mind and would rather avoid becoming a task-graph expert,
check out the :doc:`how-to section <how-tos>`.

.. toctree::

    taskgraph
    mach
    loading
    transforms
    optimization
    docker-images
    cron
    try
    actions
    release-promotion
    versioncontrol
    taskcluster-config
    how-tos
    reference