From 09cf2e1caf628f6b61c35a454dbea6b6a8c2e7aa Mon Sep 17 00:00:00 2001 From: Daniel Watkins Date: Wed, 1 Apr 2015 12:11:29 +0100 Subject: Add documentation about OpenStack vendor data handling. --- doc/sources/openstack/README.rst | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 doc/sources/openstack/README.rst (limited to 'doc/sources') diff --git a/doc/sources/openstack/README.rst b/doc/sources/openstack/README.rst new file mode 100644 index 00000000..8102597e --- /dev/null +++ b/doc/sources/openstack/README.rst @@ -0,0 +1,24 @@ +*TODO* + +Vendor Data +~~~~~~~~~~~ + +The OpenStack metadata server can be configured to serve up vendor data +which is available to all instances for consumption. OpenStack vendor +data is, generally, a JSON object. + +cloud-init will look for configuration in the ``cloud-init`` attribute +of the vendor data JSON object. cloud-init processes this configuration +using the same handlers as user data, so any formats that work for user +data should work for vendor data. + +For example, configuring the following as vendor data in OpenStack would +upgrade packages and install ``htop`` on all instances: + +.. sourcecode:: json + + {"cloud-init": "#cloud-config\npackage_upgrade: True\npackages:\n - htop"} + +For more general information about how cloud-init handles vendor data, +including how it can be disabled by users on instances, see +https://bazaar.launchpad.net/~cloud-init-dev/cloud-init/trunk/view/head:/doc/vendordata.txt -- cgit v1.2.3 From 74820e932cbe4148b9b58e844686562ff2671b31 Mon Sep 17 00:00:00 2001 From: Pierre-Luc Dion Date: Fri, 3 Apr 2015 21:40:17 -0400 Subject: Initial CloudStack Documentation. --- doc/rtd/topics/datasources.rst | 2 +- doc/sources/cloudstack/README.rst | 29 +++++++++++++++++++++++++++++ 2 files changed, 30 insertions(+), 1 deletion(-) create mode 100644 doc/sources/cloudstack/README.rst (limited to 'doc/sources') diff --git a/doc/rtd/topics/datasources.rst b/doc/rtd/topics/datasources.rst index cc0d0ede..a2024bdc 100644 --- a/doc/rtd/topics/datasources.rst +++ b/doc/rtd/topics/datasources.rst @@ -166,7 +166,7 @@ For now see: http://maas.ubuntu.com/ CloudStack --------------------------- -*TODO* +.. include:: ../../sources/cloudstack/README.rst --------------------------- OVF diff --git a/doc/sources/cloudstack/README.rst b/doc/sources/cloudstack/README.rst new file mode 100644 index 00000000..eba1cd7e --- /dev/null +++ b/doc/sources/cloudstack/README.rst @@ -0,0 +1,29 @@ +`Apache CloudStack`_ expose user-data, meta-data, user password and account +sshkey thru the Virtual-Router. For more details on meta-data and user-data, +refer the `CloudStack Administrator Guide`_. + +URLs to access user-data and meta-data from the Virtual Machine. Here 10.1.1.1 +is the Virtual Router IP: + +.. code:: bash + + http://10.1.1.1/latest/user-data + http://10.1.1.1/latest/meta-data + http://10.1.1.1/latest/meta-data/{metadata type} + +Configuration +~~~~~~~~~~~~~ + +Apache CloudStack datasource can be configured as follows: + +.. code:: yaml + + datasource: + CloudStack: {} + None: {} + datasource_list: + - CloudStack + + +.. _Apache CloudStack: http://cloudstack.apache.org/ +.. _CloudStack Administrator Guide: http://docs.cloudstack.apache.org/projects/cloudstack-administration/en/latest/virtual_machines.html#user-data-and-meta-data \ No newline at end of file -- cgit v1.2.3 From 22c7762b0c4a6abc96bdb7fd494599af343eb622 Mon Sep 17 00:00:00 2001 From: Peter Hurley Date: Thu, 17 Dec 2015 10:57:55 -0800 Subject: doc/sources/nocloud: document the volume label requirement document that vfat and iso9660 filesystems must have 'cidata' volume label to be recognized as a potential NoCloud data source. --- doc/sources/nocloud/README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'doc/sources') diff --git a/doc/sources/nocloud/README.rst b/doc/sources/nocloud/README.rst index aa3cf1a3..08a39377 100644 --- a/doc/sources/nocloud/README.rst +++ b/doc/sources/nocloud/README.rst @@ -3,7 +3,7 @@ and meta-data to the instance without running a network service (or even without having a network at all). You can provide meta-data and user-data to a local vm boot via files on a `vfat`_ -or `iso9660`_ filesystem. +or `iso9660`_ filesystem. The filesystem volume label must be ``cidata``. These user-data and meta-data files are expected to be in the following format. -- cgit v1.2.3