diff options
| -rw-r--r-- | documentation/test-manual/reproducible-builds.rst | 22 |
1 files changed, 15 insertions, 7 deletions
diff --git a/documentation/test-manual/reproducible-builds.rst b/documentation/test-manual/reproducible-builds.rst index 91f94a5c74..d581155eb2 100644 --- a/documentation/test-manual/reproducible-builds.rst +++ b/documentation/test-manual/reproducible-builds.rst | |||
| @@ -91,13 +91,21 @@ run:: | |||
| 91 | 91 | ||
| 92 | oe-selftest -r reproducible.ReproducibleTests.test_reproducible_builds | 92 | oe-selftest -r reproducible.ReproducibleTests.test_reproducible_builds |
| 93 | 93 | ||
| 94 | This defaults to including a ``world`` build so, if other layers are added, it would | 94 | This defaults to including a ``world`` build so, if other layers are added, it |
| 95 | also run the tests for recipes in the additional layers. Different build targets | 95 | would also run the tests for recipes in the additional layers. Different build |
| 96 | can be defined using the :term:`OEQA_REPRODUCIBLE_TEST_TARGET` variable in ``local.conf``. | 96 | targets can be defined using the :term:`OEQA_REPRODUCIBLE_TEST_TARGET` variable |
| 97 | The first build will be run using :ref:`Shared State <overview-manual/concepts:Shared State>` if | 97 | in ``local.conf``. For example, running reproducibility tests for only the |
| 98 | available, the second build explicitly disables | 98 | ``python3-numpy`` recipe can be done by setting:: |
| 99 | :ref:`Shared State <overview-manual/concepts:Shared State>` except for recipes defined in | 99 | |
| 100 | the :term:`OEQA_REPRODUCIBLE_TEST_SSTATE_TARGETS` variable, and builds on the | 100 | OEQA_REPRODUCIBLE_TEST_TARGET = "python3-numpy" |
| 101 | |||
| 102 | in local.conf before running the ``oe-selftest`` command shown above. | ||
| 103 | |||
| 104 | Reproducibility builds the target list twice. The first build will be run using | ||
| 105 | :ref:`Shared State <overview-manual/concepts:Shared State>` if available, the | ||
| 106 | second build explicitly disables :ref:`Shared State | ||
| 107 | <overview-manual/concepts:Shared State>` except for recipes defined in the | ||
| 108 | :term:`OEQA_REPRODUCIBLE_TEST_SSTATE_TARGETS` variable, and builds on the | ||
| 101 | specific host the build is running on. This means we can test reproducibility | 109 | specific host the build is running on. This means we can test reproducibility |
| 102 | builds between different host distributions over time on the Autobuilder. | 110 | builds between different host distributions over time on the Autobuilder. |
| 103 | 111 | ||
