summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorShixin Ruan <matboy_80@aliyun.com>2019-09-18 13:15:25 +0000
committerServer Team CI Bot <josh.powers+server-team-bot@canonical.com>2019-09-18 13:15:25 +0000
commit571f7c36e89f67f4c2d1cacfd8f9269bf864d560 (patch)
treeca88604c5f74aef35455e250dc781a4c1fc62f5b /doc
parent4df0065998961ad21a9b733fb23ae2ebd78b7380 (diff)
downloadvyos-cloud-init-571f7c36e89f67f4c2d1cacfd8f9269bf864d560.tar.gz
vyos-cloud-init-571f7c36e89f67f4c2d1cacfd8f9269bf864d560.zip
Add datasource for ZStack platform.
Zstack platform provides a AWS Ec2 metadata service, and identifies their platform to the guest by setting the 'chassis asset tag' to a string that ends with '.zstack.io'. LP: #1841181
Diffstat (limited to 'doc')
-rw-r--r--doc/rtd/topics/datasources.rst1
-rw-r--r--doc/rtd/topics/datasources/zstack.rst36
2 files changed, 37 insertions, 0 deletions
diff --git a/doc/rtd/topics/datasources.rst b/doc/rtd/topics/datasources.rst
index 8e58be97..a337c08c 100644
--- a/doc/rtd/topics/datasources.rst
+++ b/doc/rtd/topics/datasources.rst
@@ -45,6 +45,7 @@ The following is a list of documents for each supported datasource:
datasources/oracle.rst
datasources/ovf.rst
datasources/smartos.rst
+ datasources/zstack.rst
Creation
diff --git a/doc/rtd/topics/datasources/zstack.rst b/doc/rtd/topics/datasources/zstack.rst
new file mode 100644
index 00000000..36e60ffb
--- /dev/null
+++ b/doc/rtd/topics/datasources/zstack.rst
@@ -0,0 +1,36 @@
+.. _datasource_zstack:
+
+ZStack
+======
+ZStack platform provides a AWS Ec2 metadata service, but with different datasource identity.
+More information about ZStack can be found at `ZStack <https://www.zstack.io>`__.
+
+Discovery
+---------
+To determine whether a vm running on ZStack platform, cloud-init checks DMI information
+by 'dmidecode -s chassis-asset-tag', if the output ends with '.zstack.io', it's running
+on ZStack platform:
+
+
+Metadata
+^^^^^^^^
+Same as EC2, instance metadata can be queried at
+
+::
+
+ GET http://169.254.169.254/2009-04-04/meta-data/
+ instance-id
+ local-hostname
+
+Userdata
+^^^^^^^^
+Same as EC2, instance userdata can be queried at
+
+::
+
+ GET http://169.254.169.254/2009-04-04/user-data/
+ meta_data.json
+ user_data
+ password
+
+.. vi: textwidth=78