.. _datasources: Datasources *********** Datasources are sources of configuration data for ``cloud-init`` that typically come from the user (i.e., user-data) or come from the cloud that created the configuration drive (i.e., meta-data). Typical user-data includes files, YAML, and shell scripts whereas typical meta-data includes server name, instance id, display name, and other cloud specific details. Any meta-data processed by ``cloud-init``'s datasources is persisted as :file:`/run/cloud-init/instance-data.json`. ``Cloud-init`` provides tooling to quickly introspect some of that data. See :ref:`instance-data` for more information. How to configure which datasource to use ======================================== By default ``cloud-init`` should automatically determine which datasource it is running on. Therefore, in most cases, users of ``cloud-init`` should not have to configure ``cloud-init`` to specify which datasource cloud-init is running on; ``cloud-init`` should "figure it out". There are exceptions, however, when the :ref:`datasource does not identify` itself to ``cloud-init``. For these exceptions, one can override datasource detection either by configuring a single datasource in the :ref:`datasource_list`, or by using :ref:`kernel command line arguments`. .. _datasources_supported: Datasources: ============ The following is a list of documentation for each supported datasource: .. toctree:: :titlesonly: datasources/akamai.rst datasources/aliyun.rst datasources/altcloud.rst datasources/ec2.rst datasources/azure.rst datasources/cloudcix.rst datasources/cloudsigma.rst datasources/cloudstack.rst datasources/configdrive.rst datasources/digitalocean.rst datasources/e24cloud.rst datasources/exoscale.rst datasources/fallback.rst datasources/gce.rst datasources/lxd.rst datasources/maas.rst datasources/nocloud.rst datasources/none.rst datasources/nwcs.rst datasources/opennebula.rst datasources/openstack.rst datasources/oracle.rst datasources/ovf.rst datasources/rbxcloud.rst datasources/scaleway.rst datasources/smartos.rst datasources/upcloud.rst datasources/vmware.rst datasources/vultr.rst datasources/wsl.rst datasources/zstack.rst