openstack/diskimage-builder
Code Issues Proposed changes
f5dff9c52a
diskimage-builder/elements/base
History
Jiri Stransky 1e9cf3a1c8 Remove deprecated overriding of cloud-init defaults 
The "set to localhost by default" behavior for manage_etc_hosts has been
deprecated for more than a year now by change
Ia8582883f737548e2911d3f36a1943e5b236281b.

Setting that value to "localhost" is still possible, but it won't be the
default anymore. If the previous behavior of assigning the hostname and
FQDN to 127.0.0.1 is still desired in some environments, it can be
achieved by setting the DIB_CLOUD_INIT_ETC_HOSTS environment variable,
as the deprecation warning message suggested.

Change-Id: I5a19d46e2f305769a0c89c9d25d2e6be02910221
2016-05-23 17:44:32 +02: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 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.