diskimage-builder/elements/base
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

====
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.