X-Git-Url: https://gerrit.onap.org/r/gitweb?p=multicloud%2Fframework.git;a=blobdiff_plain;f=docs%2FMultiCloud-Deployment-Guide.rst;fp=docs%2Fuser%2Fmultivimproxy.txt;h=77c5a2d4309f1ca48a382c6aedc0e5e3210c7aee;hp=5f83de90ab5cd14a7fc30ab712a5f0d78827ff94;hb=d04a2f7056c4579ee72b328dbb3413a3521ec662;hpb=ed6f94fc70e18c849b043b5616dbdd7cafa8ba9b diff --git a/docs/user/multivimproxy.txt b/docs/MultiCloud-Deployment-Guide.rst similarity index 84% rename from docs/user/multivimproxy.txt rename to docs/MultiCloud-Deployment-Guide.rst index 5f83de9..77c5a2d 100644 --- a/docs/user/multivimproxy.txt +++ b/docs/MultiCloud-Deployment-Guide.rst @@ -1,4 +1,9 @@ -1 prepare docker environment +================================ +ONAP MultiCloud Deployment Guide +================================ + +prepare docker environment +~~~~~~~~~~~~~~~~~~~~~~~~~~ Please refer to onap deployment in kubernetes website(https://wiki.onap.org/display/DW/ONAP+on+Kubernetes) to setup kubernets cluster. @@ -22,7 +27,8 @@ kube-public Active 10d kube-system Active 10d onap Active 9d -2 startup containers +startup containers +~~~~~~~~~~~~~~~~~~ first run kube2msb container. @@ -101,16 +107,18 @@ No Service Name Version NameSpace Url Protocol Visualrange Control 1 multicloud v0 /api/multicloud/v0 REST InSystem 2 multicloud-vio v0 /api/multicloud-vio/v0 REST InSystem - Then register vio information into AAI service with region name "vmware" and region id "vio" -# cur -X PUT -H "Authorization: Basic QUFJOkFBSQ==" - "Content-Type: application/json" -H "X-TransactionId:get_aai_subcr" + +.. code-block:: console + +# curl -X PUT -H "Authorization: Basic QUFJOkFBSQ==" -H "Content-Type: application/json" -H "X-TransactionId:get_aai_subcr" https://aai_resource_docker_host_ip:30233/aai/v01/cloud-infrastructure/cloud-regions/cloud-region/vmware/vio -d "{ - "cloud-type": "vmware", - "cloud-region-version": "4.0", - "esr-system-info-list": { - "esr-system-info": [ - { + "cloud-type": "vmware", + "cloud-region-version": "4.0", + "esr-system-info-list": { + "esr-system-info": [ + { "esr-system-info-id": "123-456", "system-name": "vim-vio", "system-type": "vim", @@ -121,31 +129,32 @@ https://aai_resource_docker_host_ip:30233/aai/v01/cloud-infrastructure/cloud-reg "cloud-domain": "default", "default-tenant": "admin", "ssl-insecure": false - } - ] - } + } + ] + } }" - - - -3 Test Examples +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. -2.1 Get auth token +Get 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://$HOST_IP/api/multicloud/v0//identity/auth/tokens -test.json content example: +.. code-block:: console +test.json content example: { - "auth": - { + "auth": sudo pip install virtualenv{ "scope": {"project": {"id": “”}}, "identity": { @@ -170,77 +179,91 @@ Nova endpoint: http://$HOST_IP/api/multicloud-vio/v0//compute/ -2.2 List projects +List projects +------------- Use identity’s endpoint: http://$HOST_IP/api/multicloud-vio/v0//identity/ curl -X GET -H 'X-Auth-Token:' http://$HOST_IP/api/multicloud-vio/v0//identity/projects -2.3 Get os Hypervisor +Get os Hypervisor +----------------- Use nova’s endpoint: http://$HOST_IP/api/multicloud-vio/v0//nova/ -curl -X GET -H 'X-Auth-Token:' http://$HOST_IP/api/multicloud-vio/v0//nova//os-hypervisors/detail +curl -X GET -H 'X-Auth-Token:' http://$HOST_IP/api/multicloud-vio/v0//nova//os-hypervisors/detail -2.4 List instance of user’s project +List instance of user’s project +-------------------------------- -curl -X GET -H 'X-Auth-Token:' http://$HOST_IP/api/multicloud-vio/v0//nova//servers +curl -X GET -H 'X-Auth-Token:' http://$HOST_IP/api/multicloud-vio/v0//nova//servers -2.5 Show instance detail +Show instance detail +-------------------- you need to input in url path. -curl -X GET -H 'X-Auth-Token:' http://$HOST_IP/api/multicloud-vio/v0/vimid/nova/tenantid/servers/ +.. code-block:: console + $ curl -X GET -H 'X-Auth-Token:' http://$HOST_IP/api/multicloud-vio/v0/vimid/nova/tenantid/servers/ -2.6 Shutdown instance + +Shutdown instance +----------------- you need to input in url path -curl -X POST -d '{"os-stop":null}' -H 'X-Auth-Token:' -H 'Content-Type:application/json' http://$HOST_IP/api/multicloud-vio/v0//nova//servers//action +.. code-block:: console + + $ curl -X POST -d '{"os-stop":null}' -H 'X-Auth-Token:' -H 'Content-Type:application/json' http://$HOST_IP/api/multicloud-vio/v0//nova//servers//action -2.7 Start instance +Start instance +-------------- you need to input in url path -curl -X POST -d '{"os-start":null}' -H 'X-Auth-Token:' -H 'Content-Type:application/json' http://$HOST_IP/api/multicloud-vio/v0//nova//servers//action +curl -X POST -d '{"os-start":null}' -H 'X-Auth-Token:' -H 'Content-Type:application/json' http://$HOST_IP/api/multicloud-vio/v0//nova//servers//action -2.8 Suspend instance +Suspend instance +---------------- you need to input in url path -curl -X POST -d '{"suspend":null}' -H 'X-Auth-Token:' -H 'Content-Type:application/json' http://$HOST_IP/api/multicloud-vio/v0//nova//servers//action +curl -X POST -d '{"suspend":null}' -H 'X-Auth-Token:' -H 'Content-Type:application/json' http://$HOST_IP/api/multicloud-vio/v0//nova//servers//action -2.9 Resume instance +Resume instance +---------------- you need to input in url path curl -X POST -d '{"resume":null}' -H 'X-Auth-Token:' -H 'Content-Type:application/json' http://$HOST_IP/api/multicloud-vio/v0//nova//servers//action -2.10 Pause instance +Pause instance +-------------- you need to input in url path -curl -X POST -d '{"pause":null}' -H 'X-Auth-Token:' -H 'Content-Type:application/json' http://$HOST_IP/api/multicloud-vio/v0//nova//servers//action - +curl -X POST -d '{"pause":null}' -H 'X-Auth-Token:' -H 'Content-Type:application/json' http://$HOST_IP/api/multicloud-vio/v0//nova//servers//action -2.11 Unpasue instance +Unpasue instance +---------------- you need to input in url path curl -X POST -d '{"unpause":null}' -H 'X-Auth-Token: -H 'Content-Type:application/json' http://$HOST_IP/api/multicloud-vio/v0//nova//servers//action -2.12 Reboot instance +Reboot instance +--------------- you need to input in url path