almalinux/pungi
14
1
Fork 0
Code Issues Pull Requests Releases Activity

doc: improve osbs_registries explanation

Browse Source 
Explain the use-case for this setting, and use the active voice to
explain what actions Pungi performs relative to other tools.

Signed-off-by: Ken Dreyer <kdreyer@redhat.com>
This commit is contained in:
Ken Dreyer 2022-03-21 14:50:36 -04:00
parent b805ce3d12
commit 903ab076ba
1 changed files with 16 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
doc/configuration.rst
View File

@ -1876,15 +1876,22 @@ they are not scratch builds).
``gpgkey`` can be specified to enable gpgcheck in repo files for variants. ``gpgkey`` can be specified to enable gpgcheck in repo files for variants.
**osbs_registries** **osbs_registries**
(*dict*) -- It is possible to configure extra information about where to (*dict*) -- Use this optional setting to emit ``osbs-request-push``
push the image (unless it is a scratch build). For each finished build, messages for each non-scratch container build. These messages can guide
Pungi will try to match NVR against a key in this mapping (using shell-style other tools how to push the images to other registries. For example, an
globbing) and take the corresponding value and collect them across all built external tool might trigger on these messages and copy the images from
images. The data will be saved into ``logs/global/osbs-registries.json`` as OSBS's registry to a staging or production registry.
a mapping from Koji NVR to the registry data. The same data is also sent to
the message bus on ``osbs-request-push`` topic once the compose finishes For each completed container build, Pungi will try to match the NVR against
successfully. Handling the message and performing the actual push is outside a key in ``osbs_registries`` mapping (using shell-style globbing) and take
of scope for Pungi. the corresponding value and collect them across all built images. Pungi
will save this data into ``logs/global/osbs-registries.json``, mapping each
Koji NVR to the registry data. Pungi will also send this data to the
message bus on the ``osbs-request-push`` topic once the compose finishes
successfully.
Pungi simply logs the mapped data and emits the messages. It does not
handle the messages or push images. A separate tool must do that.
Example config Example config