Update cloud-init-datasources README

Updating the README for this element to follow our new environment
variables convention.

Change-Id: I9cf21bd063ea2bfbea7244656af8f3d0e79f20b1
This commit is contained in:
Gregory Haynes 2015-04-08 06:56:37 +00:00
parent 7917e7416b
commit 954b9de79b

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.