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 cloud-init-datasources
====================== ======================
Configures cloud-init to only use an explicit list of data sources. Configures cloud-init to only use an explicit list of data sources.
Cloud-init contains a growing collection of data source modules and most 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 on first boot. This can cause delays or even boot problems depending on your
environment. 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 Including this element without setting `DIB_CLOUD_INIT_DATASOURCES` will cause
image builds to fail. 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.