summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorEthan Lynn <ethanlynnl@vmware.com>2017-10-30 13:36:33 +0800
committerEthan Lynn <ethanlynnl@vmware.com>2017-10-30 13:50:42 +0800
commitec91103a59343be31f6cbcc2d12f58ce5e774e9f (patch)
treea2e79f431b5b09c0a1f4f24bc7e6a8710ca1e8ff /docs
parentabfed00c0697e1593d3c829b9da14faab25ac84f (diff)
Split Test Guide from Deployment Guide
Split the test part from deployment guide. Change-Id: I22b9182d0c83a395b3bb07169af8a124c337f7cc issue-id: MULTICLOUD-122 Signed-off-by: Ethan Lynn <ethanlynnl@vmware.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/MultiCloud-Deployment-Guide.rst231
-rw-r--r--docs/MultiCloud-Heat-Deployment-Guide.rst (renamed from docs/MuliCloud-Heat-Deployment-Guide.rst)0
-rw-r--r--docs/MultiCloud-Test-Guide.rst227
-rw-r--r--docs/index.rst3
4 files changed, 229 insertions, 232 deletions
diff --git a/docs/MultiCloud-Deployment-Guide.rst b/docs/MultiCloud-Deployment-Guide.rst
index 03db16f..ed18a0a 100644
--- a/docs/MultiCloud-Deployment-Guide.rst
+++ b/docs/MultiCloud-Deployment-Guide.rst
@@ -163,234 +163,3 @@ Then register vio information into AAI service with region name "vmware" and reg
]
}
}"
-
-Test Examples
-~~~~~~~~~~~~~
-
-The env HOST_IP is msb-iag service cluster-ip value is "10.43.188.78"(see it above).
-The vimid is "vmware_vio" the registered name in aai.
-
-
-Get V2 auth token
------------------
-
-# VIO openstack support keystone V2 version, vio proxy-plugin will check the request body format, if request body format
-# is keystone V2 format will access keystone V2 service, if not it will access keystone V3 service.
-# this example show how to access keystone V2 service.
-.. code-block:: console
-
- $ curl -X POST -d @testV2.json -H 'Content-Type:application/json' http://$msb_address/api/multicloud/v0/<vimid>/identity/v2.0/tokens
-
-testV2.json content:
-
-::
-
- {
- "auth": {
- "tenantName": "admin",
- "passwordCredentials": {
- "username": "admin",
- "password": "vmware"
- }
- }
- }
-
-
-Response:
-There are a large amounts of data including service endpoint, user information, etc.
-For our testing We take nova and identity service endpoint address and auth token which is in response header named “X-Subject-Token”.
-
-# you can find the endpoint url namespace is "api/multicloiud-vio/v0", it represent the multicloud-vio service, So
-requests sending to mulitcloud-vio will be forwarded to backend VIO openstack.
-
-
-Identity endpoint:
- http://$msb_address/api/multicloud-vio/v0/<vimid>/identity
-
-Nova endpoint:
- http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<user-tenantid>
-
-
-Get V3 auth token
------------------
-
-# send request to multicloud-framework(broker) service to get token
-
-.. code-block:: console
-
- $ curl -X POST -d @test.json -H 'Content-Type:application/json' http://$msb_address/api/multicloud/v0/<vimid>/identity/v3/auth/tokens
-
-test.json content example:
-
-::
-
- {
- "auth": sudo pip install virtualenv{
- "scope": {"project": {"id": “<project-id>”}},
- "identity":
- {
- "password": {"user": {"domain": {"name": “<doman-name>”}, "password": “<user-password>”, "name": “<user-name>”}}, "methods": ["password"]
- }
- }
- }
-
-
-Response:
-There are a large amounts of data including service endpoint, user information, etc.
-For our testing We take nova and identity service endpoint address and auth token which is in response header named “X-Subject-Token”.
-
-# you can find the endpoint url namespace is "api/multicloiud-vio/v0", it represent the multicloud-vio service, So
-requests sending to mulitcloud-vio will be forwarded to backend VIO openstack.
-
-
-Identity endpoint:
- http://$msb_address/api/multicloud-vio/v0/<vimid>/identity
-
-Nova endpoint:
- http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<user-tenantid>
-
-
-List projects
--------------
-
-Use identity’s endpoint: http://$msb_address/api/multicloud-vio/v0/<vimid>/identity/
-
-.. code-block:: console
-
- $ curl -X GET -H 'X-Auth-Token:<token>' http://$msb_address/api/multicloud-vio/v0/<vimid>/identity/projects
-
-
-Get os Hypervisor
------------------
-
-Use nova’s endpoint: http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<user-tenantid>
-
-
-.. code-block:: console
-
- $ curl -X GET -H 'X-Auth-Token:<token>' http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/os-hypervisors/detail
-
-
-List instance of user’s project
---------------------------------
-
-.. code-block:: console
-
- $ curl -X GET -H 'X-Auth-Token:<token>' http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers
-
-
-Show instance detail
---------------------
-
-you need to input <server-id> in url path.
-
-.. code-block:: console
-
- $ curl -X GET -H 'X-Auth-Token:<token>' http://$msb_address/api/multicloud-vio/v0/vimid/nova/tenantid/servers/<server-id>
-
-
-Shutdown instance
------------------
-
-you need to input <server-id> in url path
-
-.. code-block:: console
-
- $ curl -X POST -d '{"os-stop":null}' -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json' http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
-
-
-Start instance
---------------
-
-you need to input <server-id> in url path
-
-.. code-block:: console
-
- $ curl -X POST -d '{"os-start":null}' -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json' http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
-
-
-Suspend instance
-----------------
-
-you need to input <server-id> in url path
-
-.. code-block:: console
-
- $ curl -X POST -d '{"suspend":null}' -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json' http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
-
-
-Resume instance
-----------------
-
-you need to input <server-id> in url path
-
-.. code-block:: console
-
- $ curl -X POST -d '{"resume":null}' -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json' http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
-
-
-Pause instance
---------------
-
-you need to input <server-id> in url path
-
-.. code-block:: console
-
- $ curl -X POST -d '{"pause":null}' -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json' http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
-
-
-Unpasue instance
-----------------
-
-you need to input <server-id> in url path
-
-.. code-block:: console
-
- $ curl -X POST -d '{"unpause":null}' -H 'X-Auth-Token:<token> -H 'Content-Type:application/json' http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
-
-
-Reboot instance
----------------
-
-you need to input <server-id> in url path
-
-.. code-block:: console
-
- $ curl -X POST -d '{"reboot":{"type":"HARD"}}' -H 'X-Auth-Token:<token> -H 'Content-Type:application/json' http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
-
-
-Upload Image Task
------------------
-
-create uploading image task by image url:
-
-.. code-block:: console
-
- $ curl -X POST -d '{"input": {"image_properties":
- {"container_format": "bare", "name": "<image_name>"},
- "import_from_format": "<disk_format>",
- "import_from": "<image_url>"},
- "type": "import"}'
- -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json' http://$msb_address/api/multicloud-vio/v0/<vimid>/glance/v2/tasks
-
-get the taskid from response body,then query the task status by taskid.
-
-.. code-block:: console
-
- $ curl -X GET -H 'X-Auth-Token:<token>' http://$msb_address/api/multicloud-vio/v0/<vimid>/glance/v2/tasks/<taskid>
-
-You can see the description and properties of task in response body,if 'status' is success, it will show image_id in
-result block.
-
-query the image status by image_id
-
-.. code-block:: console
-
- $ curl -X GET -H 'X-Auth-Token:<token>' http://$msb_address/api/multicloud-vio/v0/<vimid>/glance/v2/images/<image_id>
-
-
-
-
-
-
-
diff --git a/docs/MuliCloud-Heat-Deployment-Guide.rst b/docs/MultiCloud-Heat-Deployment-Guide.rst
index d33ab47..d33ab47 100644
--- a/docs/MuliCloud-Heat-Deployment-Guide.rst
+++ b/docs/MultiCloud-Heat-Deployment-Guide.rst
diff --git a/docs/MultiCloud-Test-Guide.rst b/docs/MultiCloud-Test-Guide.rst
new file mode 100644
index 0000000..2be65c0
--- /dev/null
+++ b/docs/MultiCloud-Test-Guide.rst
@@ -0,0 +1,227 @@
+==========================
+ONAP MultiCloud Test Guide
+==========================
+
+Test Examples
+~~~~~~~~~~~~~
+
+The env HOST_IP is msb-iag service cluster-ip value is "10.43.188.78"(see it above).
+The vimid is "vmware_vio" the registered name in aai.
+
+
+Get V2 auth token
+-----------------
+
+# VIO openstack support keystone V2 version, vio proxy-plugin will check the request body format, if request body format
+# is keystone V2 format will access keystone V2 service, if not it will access keystone V3 service.
+# this example show how to access keystone V2 service.
+.. code-block:: console
+
+ $ curl -X POST -d @testV2.json -H 'Content-Type:application/json' http://$msb_address/api/multicloud/v0/<vimid>/identity/v2.0/tokens
+
+testV2.json content:
+
+::
+
+ {
+ "auth": {
+ "tenantName": "admin",
+ "passwordCredentials": {
+ "username": "admin",
+ "password": "vmware"
+ }
+ }
+ }
+
+
+Response:
+There are a large amounts of data including service endpoint, user information, etc.
+For our testing We take nova and identity service endpoint address and auth token which is in response header named “X-Subject-Token”.
+
+# you can find the endpoint url namespace is "api/multicloiud-vio/v0", it represent the multicloud-vio service, So
+requests sending to mulitcloud-vio will be forwarded to backend VIO openstack.
+
+
+Identity endpoint:
+ http://$msb_address/api/multicloud-vio/v0/<vimid>/identity
+
+Nova endpoint:
+ http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<user-tenantid>
+
+
+Get V3 auth token
+-----------------
+
+# send request to multicloud-framework(broker) service to get token
+
+.. code-block:: console
+
+ $ curl -X POST -d @test.json -H 'Content-Type:application/json' http://$msb_address/api/multicloud/v0/<vimid>/identity/v3/auth/tokens
+
+test.json content example:
+
+::
+
+ {
+ "auth": sudo pip install virtualenv{
+ "scope": {"project": {"id": “<project-id>”}},
+ "identity":
+ {
+ "password": {"user": {"domain": {"name": “<doman-name>”}, "password": “<user-password>”, "name": “<user-name>”}}, "methods": ["password"]
+ }
+ }
+ }
+
+
+Response:
+There are a large amounts of data including service endpoint, user information, etc.
+For our testing We take nova and identity service endpoint address and auth token which is in response header named “X-Subject-Token”.
+
+# you can find the endpoint url namespace is "api/multicloiud-vio/v0", it represent the multicloud-vio service, So
+requests sending to mulitcloud-vio will be forwarded to backend VIO openstack.
+
+
+Identity endpoint:
+ http://$msb_address/api/multicloud-vio/v0/<vimid>/identity
+
+Nova endpoint:
+ http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<user-tenantid>
+
+
+List projects
+-------------
+
+Use identity’s endpoint: http://$msb_address/api/multicloud-vio/v0/<vimid>/identity/
+
+.. code-block:: console
+
+ $ curl -X GET -H 'X-Auth-Token:<token>' http://$msb_address/api/multicloud-vio/v0/<vimid>/identity/projects
+
+
+Get os Hypervisor
+-----------------
+
+Use nova’s endpoint: http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<user-tenantid>
+
+
+.. code-block:: console
+
+ $ curl -X GET -H 'X-Auth-Token:<token>' http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/os-hypervisors/detail
+
+
+List instance of user’s project
+--------------------------------
+
+.. code-block:: console
+
+ $ curl -X GET -H 'X-Auth-Token:<token>' http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers
+
+
+Show instance detail
+--------------------
+
+you need to input <server-id> in url path.
+
+.. code-block:: console
+
+ $ curl -X GET -H 'X-Auth-Token:<token>' http://$msb_address/api/multicloud-vio/v0/vimid/nova/tenantid/servers/<server-id>
+
+
+Shutdown instance
+-----------------
+
+you need to input <server-id> in url path
+
+.. code-block:: console
+
+ $ curl -X POST -d '{"os-stop":null}' -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json' http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
+
+
+Start instance
+--------------
+
+you need to input <server-id> in url path
+
+.. code-block:: console
+
+ $ curl -X POST -d '{"os-start":null}' -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json' http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
+
+
+Suspend instance
+----------------
+
+you need to input <server-id> in url path
+
+.. code-block:: console
+
+ $ curl -X POST -d '{"suspend":null}' -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json' http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
+
+
+Resume instance
+----------------
+
+you need to input <server-id> in url path
+
+.. code-block:: console
+
+ $ curl -X POST -d '{"resume":null}' -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json' http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
+
+
+Pause instance
+--------------
+
+you need to input <server-id> in url path
+
+.. code-block:: console
+
+ $ curl -X POST -d '{"pause":null}' -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json' http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
+
+
+Unpasue instance
+----------------
+
+you need to input <server-id> in url path
+
+.. code-block:: console
+
+ $ curl -X POST -d '{"unpause":null}' -H 'X-Auth-Token:<token> -H 'Content-Type:application/json' http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
+
+
+Reboot instance
+---------------
+
+you need to input <server-id> in url path
+
+.. code-block:: console
+
+ $ curl -X POST -d '{"reboot":{"type":"HARD"}}' -H 'X-Auth-Token:<token> -H 'Content-Type:application/json' http://$msb_address/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
+
+
+Upload Image Task
+-----------------
+
+create uploading image task by image url:
+
+.. code-block:: console
+
+ $ curl -X POST -d '{"input": {"image_properties":
+ {"container_format": "bare", "name": "<image_name>"},
+ "import_from_format": "<disk_format>",
+ "import_from": "<image_url>"},
+ "type": "import"}'
+ -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json' http://$msb_address/api/multicloud-vio/v0/<vimid>/glance/v2/tasks
+
+get the taskid from response body,then query the task status by taskid.
+
+.. code-block:: console
+
+ $ curl -X GET -H 'X-Auth-Token:<token>' http://$msb_address/api/multicloud-vio/v0/<vimid>/glance/v2/tasks/<taskid>
+
+You can see the description and properties of task in response body,if 'status' is success, it will show image_id in
+result block.
+
+query the image status by image_id
+
+.. code-block:: console
+
+ $ curl -X GET -H 'X-Auth-Token:<token>' http://$msb_address/api/multicloud-vio/v0/<vimid>/glance/v2/images/<image_id>
diff --git a/docs/index.rst b/docs/index.rst
index 56a95a5..25804de 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -6,6 +6,7 @@ MultiCloud Documentation Repository
:maxdepth: 2
MultiCloud-Deployment-Guide
+ MultiCloud-Test-Guide
MultiCloud-API-Specification-V1
Multicloud-Fake_Cloud-Guide
- MUlticloud-Heat-Deploymnet-Guide
+ MultiCloud-Heat-Deployment-Guide