1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
|
.. _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<datasource_ironic>` itself to ``cloud-init``. For these
exceptions, one can override datasource detection either by configuring a
single datasource in the :ref:`datasource_list<base_config_datasource_list>`,
or by using :ref:`kernel command line arguments<kernel_datasource_override>`.
.. _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
|
