openstack/diskimage-builder
Code Issues Proposed changes
fe559242cb
diskimage-builder/elements/base
History
Jenkins 97954ccd4e Merge "Make managing hosts entries optional"
2015-05-12 13:29:48 +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 Break install-types out of base 2015-04-14 13:39:18 -04:00
install.d Merge "Make managing hosts entries optional" 2015-05-12 13:29:48 +00:00
pre-install.d Split dib-init-system into its own element 2015-03-25 13:28:38 -04: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 Remove install of vlan/vconfig from base 2015-05-08 15:42:37 -04: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.