cloud-init-dev team mailing list archive

["Junjie.Wang" <jingni.wjj@xxxxxxxxxxxxxxx>]

Junjie.Wang has proposed merging ~jingni.wjj/cloud-init:add_aliyun_doc into cloud-init:master.

Commit message:
add doc describe aliyun datasource

Requested reviews:
  cloud-init commiters (cloud-init-dev)

For more details, see:
https://code.launchpad.net/~jingni.wjj/cloud-init/+git/cloud-init/+merge/343181
-- 
Your team cloud-init commiters is requested to review the proposed merge of ~jingni.wjj/cloud-init:add_aliyun_doc into cloud-init:master.

diff --git a/doc/rtd/topics/datasources/aliyun.rst b/doc/rtd/topics/datasources/aliyun.rst
new file mode 100644
index 0000000..8c1938e
--- /dev/null
+++ b/doc/rtd/topics/datasources/aliyun.rst
@@ -0,0 +1,58 @@
+.. _datasource_aliyun:
+
+Alibaba Cloud
+================
+The datasource is available as of the cloud-init 0.7.9 for Alibaba Cloud ECS. Once you create an ECS instance, the cloud-init recognizes the platform Alibaba Cloud at first, and then accesses the datasource of the instance to provide the userdata and metadata. The IP address to which cloud-init makes an access request is ``100.100.100.200`` . For more information, see the Alibaba Cloud ECS document `metadata <https://www.alibabacloud.com/help/zh/faq-detail/49122.htm>`__.
+
+Version of the datasource
+-------------------------
+The datasource for the Alibaba Cloud platform has the 2016-01-01 version and a latest version, and both the versions have identical content. However, the default one is 2016-01-01. You can run the following content to check which version supports your instance.
+
+::
+
+	GET http://100.100.100.200/
+	2016-01-01
+	latest
+	
+To query the metadata
+---------------------
+Metadata can be queried at the following URL.
+
+::
+
+	GET http://100.100.100.200/2016-01-01/meta-data
+	dns-conf/
+	eipv4
+	hostname
+	image-id
+	instance-id
+	instance/
+	mac
+	network-type
+	network/
+	ntp-conf/
+	owner-account-id
+	private-ipv4
+	public-keys/
+	region-id
+	serial-number
+	source-address
+	sub-private-ipv4-list
+	vpc-cidr-block
+	vpc-id
+	vswitch-cidr-block
+	vswitch-id
+	zone-id
+	
+To query the userdata
+----------------------
+If you have configured the userdata for an instance, cloud-init looks for the data using the following URL.
+
+::
+
+	GET http://100.100.100.200/2016-01-01/user-data
+	echo "Hello Alibaba Cloud"
+	
+
+.. vi: textwidth=78
+