diskimage-builder/diskimage_builder/elements/yum
Steve Baker 296c81b9ca Add DIB_YUM_REPO_PACKAGE as an alternative to DIB_YUM_REPO_CONF
A custom yum repository can now be configured by defining
`DIB_YUM_REPO_PACKAGE` as a yum available package or a URL to an rpm file.
This package can install repo files with any associated keys and
certificates.

A good example of such a package upstream is rdo-release[1] which
includes multiple repo files, the repo keys, and a root certificate.
This makes these repos impractical to install via DIB_YUM_REPO_CONF.

Downstream, repo packages like this a frequently used to bootstrap
development builds of RHEL with development repos.

[1] https://www.rdoproject.org/repos/rdo-release.rpm

Change-Id: I2832e723998c9bd7635cdf7541a4c20eff6294d2
2021-09-13 09:32:53 +12:00
..
bin Ensure redhat efi packages are reinstalled during finalise 2021-04-21 10:56:37 +12:00
cleanup.d Move elements & lib relative to diskimage_builder package 2016-11-01 17:27:41 -07:00
extra-data.d Move elements & lib relative to diskimage_builder package 2016-11-01 17:27:41 -07:00
post-install.d Use $YUM instead of direct calls in more places 2019-10-03 00:22:18 +00:00
pre-install.d Add DIB_YUM_REPO_PACKAGE as an alternative to DIB_YUM_REPO_CONF 2021-09-13 09:32:53 +12:00
root.d Move elements & lib relative to diskimage_builder package 2016-11-01 17:27:41 -07:00
README.rst Add DIB_YUM_REPO_PACKAGE as an alternative to DIB_YUM_REPO_CONF 2021-09-13 09:32:53 +12:00
element-deps Move elements & lib relative to diskimage_builder package 2016-11-01 17:27:41 -07:00

README.rst

yum

Provide yum specific image building glue.

RHEL/Fedora/CentOS and other yum based distributions need specific yum customizations.

Customizations include caching of downloaded yum packages outside of the build chroot so that they can be reused by subsequent image builds. The cache increases image building speed when building multiple images, especially on slow connections. This is more effective than using an HTTP proxy as a yum cache since the same rpm from different mirrors is often requested.

Custom yum repository configurations can also be applied by defining DIB_YUM_REPO_CONF to a space separated list of repo configuration files. The files will be copied to /etc/yum.repos.d/ during the image build, and then removed at the end of the build. Each repo file should be named differently to avoid a filename collision.

The yum repository can also be configured by defining DIB_YUM_REPO_PACKAGE as a yum available package or a URL to an rpm file. This package can install repo files with any associated keys and certificates.

Environment Variables for Module Selection during Image Creation

The following environment variable is used to select module streams to be enabled during an image build on Yum/DNF based distributions. Any existing stream for the given module is first disabled prior to enabling the specified stream.

#### DIB_DNF_MODULE_STREAMS This is a space-separated list of module streams to enable prior to any RPMs being installed.

Image Build Module Selection Example

When using Train release on RHEL/CentOS/Fedora, one must select the appropriate virt and container-tools module streams:

DIB_DNF_MODULE_STREAMS='virt:8.2 container-tools:3.0'