| Message ID | 20250211234738.2633971-3-yoann.congal@smile.fr |
|---|---|
| State | Superseded |
| Headers | show |
| Series | [v5,1/4] ref-manual/variables: document OEQA_REPRODUCIBLE_TEST_LEAF_TARGETS | expand |
Hi Yoann, On 2/12/25 12:47 AM, Yoann Congal via lists.yoctoproject.org wrote: > From: Yoann Congal <yoann.congal@smile.fr> > > Shows an example of the new variable OEQA_REPRODUCIBLE_TEST_LEAF_TARGETS > and still mention OEQA_REPRODUCIBLE_TEST_TARGET/SSTATE_TARGETS that were > shown earlier. > > Signed-off-by: Yoann Congal <yoann.congal@smile.fr> > Reviewed-by: Guillaume Swaenepoel <guillaume.swaenepoel@smile.fr> > --- > v4->v5: Quentin's review: > * use :term: link in title > > v3->v4: > Quentin's Review > * make missing dependencies more explicit > Guillaume's Reviewed-by > > v2->v3: Quentin's review > * Double tick quote variable in title > * Removed Guillaume Reviewed-by (given privately) > > v1->v2: Quentin's review > * tick-quote variable in title > * a set of recipeS > * 3 spaces to align a code block (not 4) > --- > .../test-manual/reproducible-builds.rst | 20 +++++++++++++++++++ > 1 file changed, 20 insertions(+) > > diff --git a/documentation/test-manual/reproducible-builds.rst b/documentation/test-manual/reproducible-builds.rst > index b9f671d68..b913aa4ea 100644 > --- a/documentation/test-manual/reproducible-builds.rst > +++ b/documentation/test-manual/reproducible-builds.rst > @@ -145,3 +145,23 @@ set of recipes before the test, meaning they are excluded from reproducibility > testing. As a practical example, you could set ``sstate_targets`` to > ``core-image-sato``, then setting ``targets`` to ``core-image-sato-sdk`` would > run reproducibility tests only on the targets belonging only to ``core-image-sato-sdk``. > + > +Using :term:`OEQA_REPRODUCIBLE_TEST_* <OEQA_REPRODUCIBLE_TEST_LEAF_TARGETS>` variables > +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > + > +If you want to test the reproducibility of a set of recipes, you can define > +:term:`OEQA_REPRODUCIBLE_TEST_LEAF_TARGETS`, in your local.conf:: > + > + OEQA_REPRODUCIBLE_TEST_LEAF_TARGETS = "my-recipe" > + > +This will test the reproducibility of ``my-recipe`` but will use the > +:ref:`Shared State <overview-manual/concepts:Shared State>` for most its I think this is proper English, but it itches me a bit, feels like it's missing an "of". Up to you to add it or not. > +dependencies (i.e. the ones explicitly listed in DEPENDS, which may not be all > +dependencies, c.f. [depends] varflags, PACKAGE_DEPENDS and other > +implementations). > + Same remark as for patch 1 in the series, with that: Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de> Thanks! Quentin
diff --git a/documentation/test-manual/reproducible-builds.rst b/documentation/test-manual/reproducible-builds.rst index b9f671d68..b913aa4ea 100644 --- a/documentation/test-manual/reproducible-builds.rst +++ b/documentation/test-manual/reproducible-builds.rst @@ -145,3 +145,23 @@ set of recipes before the test, meaning they are excluded from reproducibility testing. As a practical example, you could set ``sstate_targets`` to ``core-image-sato``, then setting ``targets`` to ``core-image-sato-sdk`` would run reproducibility tests only on the targets belonging only to ``core-image-sato-sdk``. + +Using :term:`OEQA_REPRODUCIBLE_TEST_* <OEQA_REPRODUCIBLE_TEST_LEAF_TARGETS>` variables +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +If you want to test the reproducibility of a set of recipes, you can define +:term:`OEQA_REPRODUCIBLE_TEST_LEAF_TARGETS`, in your local.conf:: + + OEQA_REPRODUCIBLE_TEST_LEAF_TARGETS = "my-recipe" + +This will test the reproducibility of ``my-recipe`` but will use the +:ref:`Shared State <overview-manual/concepts:Shared State>` for most its +dependencies (i.e. the ones explicitly listed in DEPENDS, which may not be all +dependencies, c.f. [depends] varflags, PACKAGE_DEPENDS and other +implementations). + +You can have finer control on the test with: + +- :term:`OEQA_REPRODUCIBLE_TEST_TARGET`: lists recipes to be built, +- :term:`OEQA_REPRODUCIBLE_TEST_SSTATE_TARGETS`: lists recipes that will + be built using :ref:`Shared State <overview-manual/concepts:Shared State>`.