File: none.rst

package info (click to toggle)
cloud-init 25.3-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 12,412 kB
  • sloc: python: 135,894; sh: 3,883; makefile: 141; javascript: 30; xml: 22
file content (49 lines) | stat: -rw-r--r-- 1,191 bytes parent folder | download | duplicates (3)
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
.. _datasource_none:

None
****

The data source ``None`` may be used when no other viable datasource is
present on disk. This has two primary use cases:

1. Providing user-data to cloud-init from on-disk configuration when
   no other datasource is present.
2. As a fallback for when a datasource is otherwise intermittently
   unavailable.

When the datasource is ``None``, cloud-init is unable to obtain or
render networking configuration. Additionally, when cloud-init
completes, a warning is logged that DataSourceNone is being used.

Configuration
=============

User-data and meta-data may be passed to cloud-init via system
configuration in :file:`/etc/cloud/cloud.cfg` or
:file:`/etc/cloud/cloud.cfg.d/*.cfg`.

``userdata_raw``
----------------

A **string** containing the user-data (including header) to be used by
cloud-init.

``metadata``
-------------
The metadata to be used by cloud-init.

.. _datasource_none_example:

Example configuration
---------------------

.. code-block:: yaml

  datasource:
    None:
      metadata:
        local-hostname: "myhost.internal"
      userdata_raw: |
        #cloud-config
        runcmd:
        - echo 'mydata' > /var/tmp/mydata.txt