diff --git a/elements/cloud-init-datasources/README.rst b/elements/cloud-init-datasources/README.rst index 0849cb6c..375f4278 100644 --- a/elements/cloud-init-datasources/README.rst +++ b/elements/cloud-init-datasources/README.rst @@ -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. +