dev-manual: packages: clarify shared PR service constraint

Explicit the problems previous described as "obvious".

(From yocto-docs rev: c5e3b57398d98626e348cb14d2a89ecc5f424dd4)

Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Suggested-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Signed-off-by: Steve Sakoman <steve@sakoman.com>
This commit is contained in:
Michael Opdenacker
2024-02-21 22:14:35 +01:00
committed by Steve Sakoman
parent d241202fa1
commit 3d5846e144

View File

@@ -205,9 +205,14 @@ history, see the
The OpenEmbedded build system does not maintain :term:`PR` information as
part of the shared state (sstate) packages. If you maintain an sstate
feed, it's expected that either all your building systems that
contribute to the sstate feed use a shared PR Service, or you do not
run a PR Service on any of your building systems. Having some systems
use a PR Service while others do not leads to obvious problems.
contribute to the sstate feed use a shared PR service, or you do not
run a PR Service on any of your building systems.
That's because if you had multiple machines sharing a PR service but
not their sstate feed, you could end up with "diverging" hashes for
the same output artefacts. When presented to the share PR service,
each would be considered as new and would increase the revision
number, causing many unnecessary package upgrades.
For more information on shared state, see the
":ref:`overview-manual/concepts:shared state cache`"