diff mbox series

[2/2] reproducible-builds.rst: document OEQA_REPRODUCIBLE_TEST_TARGET and OEQA_REPRODUCIBLE_TEST_SSTATE_TARGETS

Message ID 20230615112633.3702207-2-mikko.rapeli@linaro.org
State New
Headers show
Series [1/2] variables.rst: document OEQA_REPRODUCIBLE_TEST_TARGET and OEQA_REPRODUCIBLE_TEST_SSTATE_TARGETS | expand

Commit Message

Mikko Rapeli June 15, 2023, 11:26 a.m. UTC
From: Mikko Rapeli <mikko.rapeli@linaro.org>

They are used to fine tune build reproducibility test for
different build targets than "bitbake world" and to define
which recipes can be rebuild using sstate cache.

These are useful when ramping up build reproducibility in complex
build configurations where "bitbake world" has too many failures.

Signed-off-by: Mikko Rapeli <mikko.rapeli@linaro.org>
---
 documentation/test-manual/reproducible-builds.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

Comments

Michael Opdenacker June 15, 2023, 5:44 p.m. UTC | #1
Hi again Mikko

On 15.06.23 at 13:26, Mikko Rapeli wrote:
> From: Mikko Rapeli <mikko.rapeli@linaro.org>
>
> They are used to fine tune build reproducibility test for
> different build targets than "bitbake world" and to define
> which recipes can be rebuild using sstate cache.
>
> These are useful when ramping up build reproducibility in complex
> build configurations where "bitbake world" has too many failures.
>
> Signed-off-by: Mikko Rapeli <mikko.rapeli@linaro.org>
> ---
>   documentation/test-manual/reproducible-builds.rst | 8 +++++---
>   1 file changed, 5 insertions(+), 3 deletions(-)
>
> diff --git a/documentation/test-manual/reproducible-builds.rst b/documentation/test-manual/reproducible-builds.rst
> index 50256fb197..28feb78391 100644
> --- a/documentation/test-manual/reproducible-builds.rst
> +++ b/documentation/test-manual/reproducible-builds.rst
> @@ -103,10 +103,12 @@ run::
>      oe-selftest -r reproducible.ReproducibleTests.test_reproducible_builds
>   
>   This defaults to including a ``world`` build so, if other layers are added, it would
> -also run the tests for recipes in the additional layers. The first build will be
> -run using :ref:`Shared State <overview-manual/concepts:Shared State>` if
> +also run the tests for recipes in the additional layers. Different build targets
> +can be defined using ``OEQA_REPRODUCIBLE_TEST_TARGET`` variable in ``local.conf``.
/s/using ``OEQA_REPRODUCIBLE_TEST_TARGET``/using the 
:term:`OEQA_REPRODUCIBLE_TEST_TARGET`/
> +The first build will be run using :ref:`Shared State <overview-manual/concepts:Shared State>` if
>   available, the second build explicitly disables
> -:ref:`Shared State <overview-manual/concepts:Shared State>` and builds on the
> +:ref:`Shared State <overview-manual/concepts:Shared State>` except for recipes defined in
> +``OEQA_REPRODUCIBLE_TEST_SSTATE_TARGETS`` variable, and builds on the

Same comment. I will fix both.

Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Merged both commits into master-next.

Thanks again!
Cheers
Michael.
diff mbox series

Patch

diff --git a/documentation/test-manual/reproducible-builds.rst b/documentation/test-manual/reproducible-builds.rst
index 50256fb197..28feb78391 100644
--- a/documentation/test-manual/reproducible-builds.rst
+++ b/documentation/test-manual/reproducible-builds.rst
@@ -103,10 +103,12 @@  run::
    oe-selftest -r reproducible.ReproducibleTests.test_reproducible_builds
 
 This defaults to including a ``world`` build so, if other layers are added, it would
-also run the tests for recipes in the additional layers. The first build will be
-run using :ref:`Shared State <overview-manual/concepts:Shared State>` if
+also run the tests for recipes in the additional layers. Different build targets
+can be defined using ``OEQA_REPRODUCIBLE_TEST_TARGET`` variable in ``local.conf``.
+The first build will be run using :ref:`Shared State <overview-manual/concepts:Shared State>` if
 available, the second build explicitly disables
-:ref:`Shared State <overview-manual/concepts:Shared State>` and builds on the
+:ref:`Shared State <overview-manual/concepts:Shared State>` except for recipes defined in
+``OEQA_REPRODUCIBLE_TEST_SSTATE_TARGETS`` variable, and builds on the
 specific host the build is running on. This means we can test reproducibility
 builds between different host distributions over time on the Autobuilder.