diff options
author | Antti Myyrä <antti.myyra@gmail.com> | 2021-02-08 17:24:36 +0200 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-02-08 10:24:36 -0500 |
commit | 0497c7b1f752c7011006b36f9c07ac141c0bb3c2 (patch) | |
tree | df05d44e9347a0cf71e52e0f49ad3f4520d83c43 /doc/rtd/topics/datasources | |
parent | 3a0a5894d112d667f313d7fb3ab0850a39bc3020 (diff) | |
download | vyos-cloud-init-0497c7b1f752c7011006b36f9c07ac141c0bb3c2.tar.gz vyos-cloud-init-0497c7b1f752c7011006b36f9c07ac141c0bb3c2.zip |
Datasource for UpCloud (#743)
New datasource utilizing UpCloud metadata API, including relevant unit
tests and documentation.
Diffstat (limited to 'doc/rtd/topics/datasources')
-rw-r--r-- | doc/rtd/topics/datasources/upcloud.rst | 24 |
1 files changed, 24 insertions, 0 deletions
diff --git a/doc/rtd/topics/datasources/upcloud.rst b/doc/rtd/topics/datasources/upcloud.rst new file mode 100644 index 00000000..0b7a9bb0 --- /dev/null +++ b/doc/rtd/topics/datasources/upcloud.rst @@ -0,0 +1,24 @@ +.. _datasource_upcloud: + +UpCloud +============= + +The `UpCloud`_ datasource consumes information from UpCloud's `metadata +service`_. This metadata service serves information about the +running server via HTTP over the address 169.254.169.254 available in every +DHCP-configured interface. The metadata API endpoints are fully described in +UpCloud API documentation at +`https://developers.upcloud.com/1.3/8-servers/#metadata-service +<https://developers.upcloud.com/1.3/8-servers/#metadata-service>`_. + +Providing user-data +------------------- + +When creating a server, user-data is provided by specifying it as `user_data` +in the API or via the server creation tool in the control panel. User-data is +immutable during server's lifetime and can be removed by deleting the server. + +.. _UpCloud: https://upcloud.com/ +.. _metadata service: https://upcloud.com/community/tutorials/upcloud-metadata-service/ + +.. vi: textwidth=78 |