Skip to content

Commit

Permalink
docs: document bootstrap_image_ready option
Browse files Browse the repository at this point in the history
  • Loading branch information
praiskup authored and xsuchy committed Oct 18, 2023
1 parent 5a4bba0 commit 830f0cc
Showing 1 changed file with 15 additions and 1 deletion.
16 changes: 15 additions & 1 deletion docs/Feature-container-for-bootstrap.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,10 +23,24 @@ Note however that also this is prerequisite:

To specify which image should be used for bootstrap container you can put in config:

config_opts['bootstrap_image'] = 'fedora:latest'
config_opts['bootstrap_image'] = 'registry.fedoraproject.org/fedora:latest'

This is a general config. Each config has specified its own image specified. E.g. CentOS 7 has `config_opts['bootstrap_image'] = 'centos:7'` in config. So unless you use your own config, you can enable this feature, and the right image will be used.

The image contents are typically suboptimal for Mock's use-case. In particular,
Mock needs to have a correct package manager (as specified in the
`package_manager` configuration option) installed inside the image, along with
the `builddep` functionality (typically provided by `python3-dnf-plugins-core`).
This is why Mock still has to 'update the downloaded bootstrap' somehow. If you
happen to have an image with `builddep` pre-installed, you can set
`bootstrap_image_ready` to 'True':

config_opts['bootstrap_image_ready'] = True

This option will significantly reduce the bootstrap preparation time, as no
package management actions need to be performed for the bootstrap (no need to
download and initialize package manager caches).

There is one known issue:

* Neither Mageia 6 nor 7 works correctly now with this feature.
Expand Down

0 comments on commit 830f0cc

Please sign in to comment.