diskimage-builder/elements/base
2017-02-07 20:23:06 +00:00
..
cleanup.d Unify tidy up logs in lib/img-functions 2017-01-14 09:40:44 +00:00
environment.d Split dib-init-system into its own element 2015-03-25 13:28:38 -04:00
install.d Move generation of dib_[environment|args] to manifest element 2017-02-07 11:33:16 +11: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 Remove unnecessary dkms install from base 2016-09-12 11:42:51 -05: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.