almalinux/kiwi-el8
14
0
Fork 0
Code Issues Pull Requests Releases Activity

Merge pull request #1263 from OSInside/update_package_element_docs

Browse Source 
Document possible values for the name attribute of package
This commit is contained in:
Dan Čermák 2019-11-14 15:40:04 +01:00 committed by GitHub
commit 7dcdc19beb
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 21 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
doc/source/working_with_kiwi/xml_description.rst
View File

@ -780,7 +780,27 @@ removed), whose name is specified via the mandatory `name` attribute:
</image>
which adds the package `udev` to the list of packages to be added to the
initial filesystem.
initial filesystem. Note, that the value that you pass via the `name`
attribute is passed directly to the used package manager. Thus, if the
package manager supports other means how packages can be specified, you may
pass them in this context too. For example, RPM based package managers
(like :command:`dnf` or :command:`zypper`) can install packages via their
`Provides:`. This can be used to add a package that provides a certain
capability (e.g. `Provides: /usr/bin/my-binary`) via:
.. code:: xml
<image schemaversion="{schema_version}" name="{exc_image_base_name}">
<!-- snip -->
<packages type="bootstrap">
<package name="/usr/bin/my-binary"/>
</packages>
</image>
Whether this works depends on the package manager and on the environment
that is being used. In the Open Build Service, certain `Provides` either
are not visible or cannot be properly extracted from the KIWI
description. Therefore, relying on `Provides` is not recommended.
Packages can also be included only on specific architectures via the `arch`
attribute. KIWI compares the `arch` attributes value with the output of