summaryrefslogtreecommitdiff
path: root/doc/sources/cloudsigma/README.rst
blob: 8cb2b0fe7140e9cf28f203b207e1c4c7ff646e55 (plain)
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
=====================
CloudSigma Datasource
=====================

This datasource finds metadata and user-data from the `CloudSigma`_ cloud platform.
Data transfer occurs through a virtual serial port of the `CloudSigma`_'s VM and the
presence of network adapter is **NOT** a requirement,

  See `server context`_ in the public documentation for more information.


Setting a hostname
~~~~~~~~~~~~~~~~~~

By default the name of the server will be applied as a hostname on the first boot.


Providing user-data
~~~~~~~~~~~~~~~~~~~

You can provide user-data to the VM using the dedicated `meta field`_ in the `server context`_
``cloudinit-user-data``. By default *cloud-config* format is expected there and the ``#cloud-config``
header could be omitted. However since this is a raw-text field you could provide any of the valid
`config formats`_.

If your user-data needs an internet connection you have to create a `meta field`_ in the `server context`_
``cloudinit-dsmode`` and set "net" as value. If this field does not exist the default value is "local".



.. _CloudSigma: http://cloudsigma.com/
.. _server context: http://cloudsigma-docs.readthedocs.org/en/latest/server_context.html
.. _meta field: http://cloudsigma-docs.readthedocs.org/en/latest/meta.html
.. _config formats: http://cloudinit.readthedocs.org/en/latest/topics/format.html