openstack/diskimage-builder
Code Issues Proposed changes
master
diskimage-builder/diskimage_builder/elements/base
History
Steve Baker 14c651ca44 Add DIB_SKIP_BASE_PACKAGE_INSTALL to base element 
Along with DIB_AVOID_PACKAGES_UPDATE it is now possible to invoke the
base element without invoking any package management. This is useful
when using a dib created image as the base image.

Change-Id: Ic6da340627bd55d4d34b1669ebf3a494131f72a6
2024-09-04 09:23:00 +12:00
..
environment.d Add DIB_SKIP_BASE_PACKAGE_INSTALL to base element 2024-09-04 09:23:00 +12:00
install.d Add DIB_SKIP_BASE_PACKAGE_INSTALL to base element 2024-09-04 09:23:00 +12:00
pre-install.d Debuntu: add apt-transport-https 2020-04-02 10:11:35 +11:00
element-deps Move elements & lib relative to diskimage_builder package 2016-11-01 17:27:41 -07:00
pkg-map Merge "drop deprecated map-services/packages from zypper element" 2017-05-31 02:11:21 +00:00
README.rst Add DIB_SKIP_BASE_PACKAGE_INSTALL to base element 2024-09-04 09:23:00 +12:00

README.rst

base

This is the base element.

Almost all users will want to include this in their disk image build, as it includes a lot of useful functionality.

The DIB_CLOUD_INIT_ETC_HOSTS environment variable can be used to customize cloud-init's management of `/etc/hosts`:

  • If the variable is set to something, write that value as cloud-init's manage_etc_hosts.
  • If the variable is set to an empty string, don't create manage_etc_hosts setting (cloud-init will use its default value).
  • If the variable is not set, use "localhost" for now. Later, not setting the variable will mean using cloud-init's default. (To preserve diskimage-builder's current default behavior in the future, set the variable to "localhost" explicitly.)

The 'DIB_AVOID_PACKAGES_UPDATE' environment variable can be used to avoid updating all packages, useful when wanting to avoid release update.

  • 'DIB_AVOID_PACKAGES_UPDATE' default is '0', all packages will be updated.
  • set 'DIB_AVOID_PACKAGES_UPDATE' to '1' to avoid updating all packages.

The 'DIB_SKIP_BASE_PACKAGE_INSTALL' environment variable can be used to avoid installing base packages, set to '1' to skip.

Notes:

  • If you are getting warnings during the build about your locale being missing, consider installing/generating the relevant locale. This may be as simple as having language-pack-XX installed in the pre-install stage