openstack/diskimage-builder
Code Issues Proposed changes
master
diskimage-builder/diskimage_builder/elements/base/README.rst
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

1.4 KiB
Raw Permalink Blame History

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