Platforms in the CI
===================


.. https://raw.githubusercontent.com/mozilla/treeherder/HEAD/ui/helpers/constants.js
   awk -e /thPlatformMap = {/,/};/ constants.js |grep ""|cut -d: -f2|sed -e s/^/   /|sed -e "s/$/ ,, /g"
   TODO:
      * Leverage verify_docs - https://bugzilla.mozilla.org/show_bug.cgi?id=1636400
      * Add a new column (when executed ? ie always, rarely, etc)
      * asan reporter isn't listed for mac os x

Build Platforms
---------------

.. csv-table::
   :header: "Platform", "Owner", "Why?"
   :widths: 40, 20, 40

   Linux, ,
   Linux DevEdition, ,
   Linux shippable, ,
   Linux x64, ,
   Linux x64 addon, ,
   Linux x64 DevEdition, ,
   Linux x64 WebRender Shippable, Jeff Muizelaar, Build with WebRender
   Linux x64 WebRender, Jeff Muizelaar, Build with WebRender
   Linux x64 shippable, , "| What we ship to our users.
   | Builds with PGO"
   Linux x64 NoOpt, , "| Developer build - Disable optimizations, enable debug options
   | Only runs on m-c"
   Linux AArch64, ,
   OS X 10.14, ,
   OS X Cross Compiled, ,
   OS X 10.14 shippable, ,
   OS X Cross Compiled shippable, , What we ship to our users
   OS X Cross Compiled NoOpt, , "| Developer build - Disable optimizations, enable debug options
   | Only runs on m-c"
   OS X Cross Compiled addon, ,
   OS X Cross Compiled DevEdition, ,
   OS X 10.14, ,
   OS X 10.14 WebRender, Jeff Muizelaar, Build with WebRender
   OS X 10.14 Shippable, ,
   OS X 10.14 WebRender Shippable, Jeff Muizelaar, Build with WebRender
   OS X 10.14 DevEdition, ,
   Windows 2012, ,
   Windows 2012 shippable, , What we ship to our users
   Windows 2012 addon, ,
   Windows 2012 NoOpt, , "| Developer build - Disable optimizations, enable debug options
   | Only runs on m-c"
   Windows 2012 DevEdition, ,
   Windows 2012 x64, ,
   Windows 2012 x64 shippable, ,
   Windows 2012 AArch64, ,
   Windows 2012 AArch64 Shippable, ,
   Windows 2012 AArch64 DevEdition, ,
   Windows 2012 x64 addon, ,
   Windows 2012 x64 NoOpt, , "| Developer build - Disable optimizations, enable debug options
   | Only runs on m-c"
   Windows 2012 x64 DevEdition, ,
   Windows MinGW, Tom Ritter, "| the Tor project uses MinGW; make sure we test that for them
   | Only runs on autoland, m-c and m-esr"
   Android 4.1 API16+, , "| All Android jobs are for GeckoView. Fenix nightly uses m-c, Fenix beta => m-b, Fenix release => m-r and Focus uses m-r.
   | We run these tests in the CI to make sure that GeckoView tests do not regress."
   Android 4.1 API16+ Beta, Agi Sferro, To ship/test Android 4.1 on arm v7 CPU
   Android 4.1 API16+ Release, , To ship/test Android 4.1 on arm v7 CPU
   Android 4.1 API16+ GeckoView multi-arch fat AAR, ,
   Android 5.0 AArch64, ,
   Android 5.0 AArch64 Beta, ,
   Android 5.0 AArch64 Release, ,
   Android 5.0 x86-64, ,
   Android 5.0 x86-64 Beta, ,
   Android 5.0 x86-64 Release, ,
   Android 7.0 x86, ,
   Android 7.0 x86 Beta, ,
   Android 7.0 x86 Release, ,
   Android 7.0 x86-64, ,
   Android 7.0 x86-64 WebRender, Kris Taeleman, Build and test GeckoView with WebRender
   Android 7.0 x86-64 Beta, ,
   Android 7.0 x86-64 Release, ,
   Android 11.0 Samsung A51 AArch64 WebRender, ,
   Android 13.0 Pixel6 AArch64 WebRender, ,
   Android 13.0 Pixel6 AArch64 WebRender, ,
   Android 13.0 Samsung S21 AArch64 WebRender, ,
   Android, ,

Testing configurations
----------------------

We have some platforms used to run the tests to make sure they run correctly on different versions of the operating systems.

.. csv-table::
   :header: "Platform", "Owner", "Why?"
   :widths: 40, 20, 40

   Linux 18.04 shippable, ,
   Linux 18.04 x64, ,
   Linux 18.04 x64 DevEdition, ,
   Linux 18.04 x64 WebRender Shippable, Jeff Muizelaar, Build with WebRender for testing
   Linux 18.04 x64 WebRender, Jeff Muizelaar, Build with WebRender for testing
   Linux 18.04 x64 shippable, ,
   Linux 18.04 x64 Stylo-Seq, ,
   Windows 7, ,
   Windows 7 DevEdition, ,
   Windows 7 Shippable, ,
   Windows 7 MinGW, Tom Ritter, "| the Tor project uses MinGW; make sure we test that for them
   | Only runs on autoland, m-c and m-esr"
   Windows 10 x64, ,
   Windows 10 x64 DevEdition, ,
   Windows 10 x64 Shippable, ,
   Windows 10 x64 WebRender Shippable, Jeff Muizelaar, Build with WebRender for testing
   Windows 10 x64 WebRender, Jeff Muizelaar, Build with WebRender for testing
   Windows 10 x64 2017 Ref HW, ,
   Windows 10 x64 MinGW, Tom Ritter, "| the Tor project uses MinGW; make sure we test that for them
   | Only runs on autoland, m-c and m-esr"
   Windows 10 AArch64, ,


Quality platforms
-----------------

We have many platforms used to run various quality tools. They aren't directly focussing on user quality but on code quality,
or prevening some classes of errors (memory, threading, etc).

.. csv-table::
   :header: "Platform", "Owner", "Why?"
   :widths: 40, 20, 40

   Linux 18.04 x64 tsan, Christian Holler, Identify threading issues with :ref:`ThreadSanitizer <Thread Sanitizer>`
   Linux x64 asan, "| Christian Holler
   | Tyson Smith (ubsan)", "| Identify memory issues with :ref:`Address Sanitizer`.
   | Also includes the UndefinedBehaviorSanitizer"
   Linux x64 WebRender asan, "| Christian Holler
   | Tyson Smith (ubsan)", "| Identify memory issues with :ref:`Address Sanitizer`.
   | Also includes the UndefinedBehaviorSanitizer"
   Linux x64 asan reporter, Christian Holler, Generate :ref:`ASan Nightly Project <ASan Nightly>` builds
   Linux x64 CCov, Marco Castelluccio , Collect :ref:`Code coverage` information to identify what is tested (or not)
   Linux 18.04 x64 asan, "| Christian Holler
   | Tyson Smith (ubsan)", "| Identify memory issues with :ref:`Address Sanitizer`.
   | Also includes the UndefinedBehaviorSanitizer"
   Linux 18.04 x64 WebRender asan, "| Christian Holler
   | Tyson Smith (ubsan)", "| Identify memory issues with :ref:`Address Sanitizer`.
   | Also includes the UndefinedBehaviorSanitizer"
   Linux 18.04 x64 CCov, Marco Castelluccio , Collect :ref:`Code coverage` information to identify what is tested (or not)
   OS X Cross Compiled CCov, Marco Castelluccio , Collect :ref:`Code coverage` information to identify what is tested (or not)
   OS X 10.14 Cross Compiled CCov, Marco Castelluccio , Collect :ref:`Code coverage` information to identify what is tested (or not)
   Windows 2012 x64 asan reporter, Christian Holler, Generate :ref:`ASan Nightly Project <ASan Nightly>` builds
   Windows 10 x64 CCov, Marco Castelluccio , Collect :ref:`Code coverage` information to identify what is tested (or not)
   Android 4.0 API16+ CCov, Marco Castelluccio , Collect :ref:`Code coverage` information to identify what is tested (or not)
   Android 4.3 API16+ CCov, Marco Castelluccio , Collect :ref:`Code coverage` information to identify what is tested (or not)
   Diffoscope, Mike Hommey, Make sure the build remains reproducible
   Linting, "| Sylvestre Ledru
   | Andrew Halberstadt", "| Identify :ref:`code quality` earlier
   | Also contains some Bugzilla
   | Run on all branches (except the Bugzilla task)"
   Documentation, "| Sylvestre Ledru
   | Andrew Halberstadt", "| :ref:`Documentation jobs <Managing Documentation>`
   | integration repository plus mozilla-central"



Infrastructure tasks
--------------------

The decision tasks responsible for creating the task graph.

.. csv-table::
   :header: "Task", "Owner", "Why?"
   :widths: 40, 20, 40

   Gecko Decision Task, , Define the tasks to run and their order
   Firefox Release Tasks, ,
   Devedition Release Tasks, ,
   Fennec Beta Tasks, ,
   Fennec Release Tasks, ,
   Thunderbird Release Tasks, ,


Others
------

.. csv-table::
   :header: "Platform", "Owner", "Why?"
   :widths: 40, 20, 40

   Docker Images, ,
   Fetch, ,
   Packages, ,
   Toolchains, ,
   Other, ,
