diff options
Diffstat (limited to 'documentation')
-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 | ||