openstack/diskimage-builder
Code Issues Proposed changes
fd5fbdd4b5
diskimage-builder/elements/base
History
Jenkins 13323c9495 Merge "Export die() function"
2016-06-07 01:00:50 +00:00
..
cleanup.d Standarise tracing for scripts 2015-02-12 10:41:32 +11:00
environment.d Split dib-init-system into its own element 2015-03-25 13:28:38 -04:00
extra-data.d Export die() function 2016-05-27 09:25:22 +10:00
install.d Remove deprecated overriding of cloud-init defaults 2016-05-23 17:44:32 +02:00
pre-install.d Fix add-apt-repository package for precise 2016-04-06 11:08:07 -07:00
root.d Standarise tracing for scripts 2015-02-12 10:41:32 +11:00
element-deps Break install-types out of base 2015-04-14 13:39:18 -04:00
package-installs.yaml Use package-installs for ubuntu and base elements 2015-02-06 10:13:08 -08:00
pkg-map Fix Gentoo hardened support 2016-02-01 20:56:37 -06:00
README.rst Make managing hosts entries optional 2015-05-11 14:40:43 +02: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.)

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
  • This element ensures /tmp/ccache will be available in the chroot during the root, extra-data, pre-install, install and post-install stages. /tmp/ccache is unavailable during block-device, finalise and cleanup stages as it will have been automatically unmounted by then.