diskimage-builder/elements/cloud-init-datasources
Gregory Haynes c4bbb6f3bc Create docs site containing element READMEs
We currently do not have the ability to create a docs site which
outlines all the elements.

Change-Id: I77ccf61e0c4b1509b3e7ce9b8f15ea5ccfd50d9b
2015-02-10 11:45:35 -08:00
..
install.d Do not use DatasourceNone for precise cloud-init 2014-06-16 10:58:39 -07:00
README.rst Create docs site containing element READMEs 2015-02-10 11:45:35 -08:00

======================
cloud-init-datasources
======================
Configures cloud-init to only use an explicit list of data sources.

Cloud-init contains a growing collection of data source modules and most
are enabled by default.  This causes cloud-init to query each data source
on first boot.  This can cause delays or even boot problems depending on your
environment.

You must define `DIB_CLOUD_INIT_DATASOURCES` as a comma-separated list of valid
data sources to limit the data sources that will be queried for metadata on
first boot.

For instance, to enable only the Ec2 datasource:

    export `DIB_CLOUD_INIT_DATASOURCES`="Ec2"

Or to enable multiple:

    export `DIB_CLOUD_INIT_DATASOURCES`="Ec2, ConfigDrive, OpenStack"

Including this element without setting `DIB_CLOUD_INIT_DATASOURCES` will cause
image builds to fail.