Merge "Update cloud-init-datasources README"

This commit is contained in:
Jenkins 2015-04-24 04:43:15 +00:00 committed by Gerrit Code Review
commit c4072920ab

View File

@ -1,6 +1,7 @@
======================
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
@ -8,17 +9,19 @@ 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.
Environment Variables
---------------------
DIB_CLOUD_INIT_DATASOURCES
:Required: Yes
:Default: None
:Description: A comma-separated list of valid data sources to limit the data
sources that will be queried for metadata on first boot.
:Example: ``DIB_CLOUD_INIT_DATASOURCES="Ec2"`` will enable only the Ec2 data
source.
:Example: ``DIB_CLOUD_INIT_DATASOURCES="Ec2, ConfigDrive, OpenStack"`` will
enable the Ec2, ConfigDrive and OpenStack data sources.