Fix output format in deployment document 33/17533/1
authorxinhuili <lxinhui@vmware.com>
Sat, 7 Oct 2017 20:14:33 +0000 (04:14 +0800)
committerxinhuili <lxinhui@vmware.com>
Sat, 7 Oct 2017 20:14:33 +0000 (04:14 +0800)
This patch is to fix several problems with output format in the
deployment document.

Change-Id: Ic6b91f76e7cfd773bb667268bb270a96362188a2
issue-id: MULTICLOUD-86
Signed-off-by: Xinhui Li <lxinhui@vmware.com>
docs/MultiCloud-Deployment-Guide.rst

index 77c5a2d..f3c26c4 100644 (file)
@@ -15,89 +15,119 @@ Clone oom project:  git clone http://gerrit.onap.org/r/oom
 Source the setenv.bash script in /oom/kubernetes/oneclick/, it will set your helm list of components to start/delete
 Run the one time config pod - which mounts the volume /dockerdata/ contained in the pod config-init.
 
-# cd  oom/kubernetes/config
-# cp onap-parameters-sample.yaml onap-parameters.yaml
-# ./createConfig.sh -n onap
+.. code-block:: console
+
+  $ cd  oom/kubernetes/config
+  $ cp onap-parameters-sample.yaml onap-parameters.yaml
+  $ ./createConfig.sh -n onap
 
 wait for "onap" namespace created, pod "config-init" created
-# kubectl get  namespaces
-NAME              STATUS    AGE
-default           Active    10d
-kube-public       Active    10d
-kube-system       Active    10d
-onap              Active    9d
+
+.. code-block:: console
+
+  $ kubectl get namespaces
+  +------------+------------+------+
+  | NAME       |     STATUS |  AGE |
+  +------------+------------+------+
+  |default           Active    10d |
+  |kube-public       Active    10d |
+  |kube-system       Active    10d |
+  |onap              Active    9d  |
+  +------------+------------+------+
 
 startup containers
 ~~~~~~~~~~~~~~~~~~
 
 first run kube2msb container.
 
-# cd oom/kubernetes/oneclick
-# ./createAll.bash -n onap -a kube2msb
+.. code-block:: console
+
+ $ cd oom/kubernetes/oneclick
+ $ ./createAll.bash -n onap -a kube2msb
 
 run msb container
-# ./createAll.bash -n onap -a msb
+
+.. code-block:: console
+
+  $ ./createAll.bash -n onap -a msb
 
 run aai container
-# ./createAll.bash -n onap -a aai
+
+.. code-block:: console
+
+  $ ./createAll.bash -n onap -a aai
 
 
 Finally run multicloud container
-# ./createAll.bash -n onap -a multicloud
+
+.. code-block:: console
+
+  $ ./createAll.bash -n onap -a multicloud
 
 get all pods
-# kubectl get pods --all-namespaces
-NAMESPACE         NAME                                    READY     STATUS    RESTARTS   AGE
-kube-system       heapster-4285517626-2k4l1               1/1       Running   1          9d
-kube-system       kube-dns-2514474280-mxh18               3/3       Running   3          9d
-kube-system       kubernetes-dashboard-716739405-jl6mk    1/1       Running   1          9d
-kube-system       monitoring-grafana-3552275057-hrpn5     1/1       Running   1          9d
-kube-system       monitoring-influxdb-4110454889-t8tpv    1/1       Running   1          9d
-kube-system       tiller-deploy-737598192-8q523           1/1       Running   1          9d
-onap-aai          aai-resources-837807428-2t158           1/1       Running   0          2d
-onap-aai          aai-service-3869033750-1nvg5            1/1       Running   0          2d
-onap-aai          aai-traversal-50329389-gnsnk            1/1       Running   0          2d
-onap-aai          data-router-2254557428-zwxx1            1/1       Running   0          2d
-onap-aai          elasticsearch-622738319-sx6q1           1/1       Running   0          2d
-onap-aai          gremlin-671060974-npsg5                 1/1       Running   0          2d
-onap-aai          hbase-3690059193-2pjc5                  1/1       Running   0          2d
-onap-aai          model-loader-service-849987455-w6vwn    1/1       Running   0          2d
-onap-aai          search-data-service-4105978183-p1nnj    1/1       Running   0          2d
-onap-aai          sparky-be-2696729089-mcjbw              1/1       Running   0          2d
-onap-kube2msb     kube2msb-registrator-1600827891-1s3s4   1/1       Running   3          7d
-onap-msb          msb-consul-3388279333-hbr16             1/1       Running   0          2d
-onap-msb          msb-discovery-1109629174-t14q8          1/1       Running   0          2d
-onap-msb          msb-eag-3969419634-2fdnr                1/1       Running   0          2d
-onap-msb          msb-iag-1114772402-sjlww                1/1       Running   0          2d
-onap-multicloud   framework-1225620501-9567n              1/1       Running   0          21h
-onap-multicloud   multicloud-vio-269945856-rl6w6          1/1       Running   0          21h
+
+.. code-block:: console
+
+  $ kubectl get pods --all-namespaces
+  +---------------+---------------------------------------+--------+-----------+----------+-----+
+  |NAMESPACE      |  NAME                                 | READY  |   STATUS  |RESTARTS  | AGE |
+  +---------------+---------------------------------------+--------+-----------+----------+-----+
+  |kube-system       heapster-4285517626-2k4l1               1/1       Running   1          9d  |
+  |kube-system       kube-dns-2514474280-mxh18               3/3       Running   3          9d  |
+  |kube-system       kubernetes-dashboard-716739405-jl6mk    1/1       Running   1          9d  |
+  |kube-system       monitoring-grafana-3552275057-hrpn5     1/1       Running   1          9d  |
+  |kube-system       monitoring-influxdb-4110454889-t8tpv    1/1       Running   1          9d  |
+  |kube-system       tiller-deploy-737598192-8q523           1/1       Running   1          9d  |
+  |onap-aai          aai-resources-837807428-2t158           1/1       Running   0          2d  |
+  |onap-aai          aai-service-3869033750-1nvg5            1/1       Running   0          2d  |
+  |onap-aai          aai-traversal-50329389-gnsnk            1/1       Running   0          2d  |
+  |onap-aai          data-router-2254557428-zwxx1            1/1       Running   0          2d  |
+  |onap-aai          elasticsearch-622738319-sx6q1           1/1       Running   0          2d  |
+  |onap-aai          gremlin-671060974-npsg5                 1/1       Running   0          2d  |
+  |onap-aai          hbase-3690059193-2pjc5                  1/1       Running   0          2d  |
+  |onap-aai          model-loader-service-849987455-w6vwn    1/1       Running   0          2d  |
+  |onap-aai          search-data-service-4105978183-p1nnj    1/1       Running   0          2d  |
+  |onap-aai          sparky-be-2696729089-mcjbw              1/1       Running   0          2d  |
+  |onap-kube2msb     kube2msb-registrator-1600827891-1s3s4   1/1       Running   3          7d  |
+  |onap-msb          msb-consul-3388279333-hbr16             1/1       Running   0          2d  |
+  |onap-msb          msb-discovery-1109629174-t14q8          1/1       Running   0          2d  |
+  |onap-msb          msb-eag-3969419634-2fdnr                1/1       Running   0          2d  |
+  |onap-msb          msb-iag-1114772402-sjlww                1/1       Running   0          2d  |
+  |onap-multicloud   framework-1225620501-9567n              1/1       Running   0          21h |
+  |onap-multicloud   multicloud-vio-269945856-rl6w6          1/1       Running   0          21h |
+  +---------------+---------------------------------------+--------+-----------+----------+-----+
 
 get cluster-ip and port
 
-# kubectl get svc --all-namespaces
-NAMESPACE         NAME                   CLUSTER-IP      EXTERNAL-IP   PORT(S)                                                             AGE
-default           kubernetes             10.43.0.1       <none>        443/TCP                                                             10d
-kube-system       heapster               10.43.96.134    <none>        80/TCP                                                              10d
-kube-system       kube-dns               10.43.0.10      <none>        53/UDP,53/TCP                                                       10d
-kube-system       kubernetes-dashboard   10.43.9.43      <none>        9090/TCP                                                            10d
-kube-system       monitoring-grafana     10.43.210.16    <none>        80/TCP                                                              10d
-kube-system       monitoring-influxdb    10.43.32.60     <none>        8086/TCP                                                            10d
-kube-system       tiller-deploy          10.43.84.208    <none>        44134/TCP                                                           10d
-onap-aai          aai-resources          None            <none>        8447/TCP,5005/TCP                                                   2d
-onap-aai          aai-service            10.43.88.92     <nodes>       8443:30233/TCP,8080:30232/TCP                                       2d
-onap-aai          aai-traversal          None            <none>        8446/TCP,5005/TCP                                                   2d
-onap-aai          elasticsearch          None            <none>        9200/TCP                                                            2d
-onap-aai          gremlin                None            <none>        8182/TCP                                                            2d
-onap-aai          hbase                  None            <none>        2181/TCP,8080/TCP,8085/TCP,9090/TCP,16000/TCP,16010/TCP,16201/TCP   2d
-onap-aai          model-loader-service   10.43.172.213   <nodes>       8443:30229/TCP,8080:30210/TCP                                       2d
-onap-aai          search-data-service    None            <none>        9509/TCP                                                            2d
-onap-aai          sparky-be              None            <none>        9517/TCP                                                            2d
-onap-msb          msb-consul             10.43.41.203    <nodes>       8500:30500/TCP                                                      2d
-onap-msb          msb-discovery          10.43.6.205     <nodes>       10081:30081/TCP                                                     2d
-onap-msb          msb-eag                10.43.81.104    <nodes>       80:30082/TCP                                                        2d
-onap-msb          msb-iag                10.43.188.78    <nodes>       80:30080/TCP                                                        2d
-onap-multicloud   framework              10.43.97.54     <nodes>       9001:30291/TCP                                                      21h
-onap-multicloud   multicloud-vio         10.43.230.197   <nodes>       9004:30294/TCP                                                      21h
+.. code-block:: console
+
+  $ kubectl get svc --all-namespaces
+  +---------------+----------------------+---------------+-------------+-------------------------------------------------------------------+--------+
+  | NAMESPACE     |      NAME            |  CLUSTER-IP   | EXTERNAL-IP |               PORT(S)                                             |  AGE   |
+  +---------------+----------------------+---------------+-------------+-------------------------------------------------------------------+--------+
+  |default           kubernetes             10.43.0.1       <none>        443/TCP                                                             10d   |
+  |kube-system       heapster               10.43.96.134    <none>        80/TCP                                                              10d   |
+  |kube-system       kube-dns               10.43.0.10      <none>        53/UDP,53/TCP                                                       10d   |
+  |kube-system       kubernetes-dashboard   10.43.9.43      <none>        9090/TCP                                                            10d   |
+  |kube-system       monitoring-grafana     10.43.210.16    <none>        80/TCP                                                              10d   |
+  |kube-system       monitoring-influxdb    10.43.32.60     <none>        8086/TCP                                                            10d   |
+  |kube-system       tiller-deploy          10.43.84.208    <none>        44134/TCP                                                           10d   |
+  |onap-aai          aai-resources          None            <none>        8447/TCP,5005/TCP                                                   2d    |
+  |onap-aai          aai-service            10.43.88.92     <nodes>       8443:30233/TCP,8080:30232/TCP                                       2d    |
+  |onap-aai          aai-traversal          None            <none>        8446/TCP,5005/TCP                                                   2d    |
+  |onap-aai          elasticsearch          None            <none>        9200/TCP                                                            2d    |
+  |onap-aai          gremlin                None            <none>        8182/TCP                                                            2d    |
+  |onap-aai          hbase                  None            <none>        2181/TCP,8080/TCP,8085/TCP,9090/TCP,16000/TCP,16010/TCP,16201/TCP   2d    |
+  |onap-aai          model-loader-service   10.43.172.213   <nodes>       8443:30229/TCP,8080:30210/TCP                                       2d    |
+  |onap-aai          search-data-service    None            <none>        9509/TCP                                                            2d    |
+  |onap-aai          sparky-be              None            <none>        9517/TCP                                                            2d    |
+  |onap-msb          msb-consul             10.43.41.203    <nodes>       8500:30500/TCP                                                      2d    |
+  |onap-msb          msb-discovery          10.43.6.205     <nodes>       10081:30081/TCP                                                     2d    |
+  |onap-msb          msb-eag                10.43.81.104    <nodes>       80:30082/TCP                                                        2d    |
+  |onap-msb          msb-iag                10.43.188.78    <nodes>       80:30080/TCP                                                        2d    |
+  |onap-multicloud   framework              10.43.97.54     <nodes>       9001:30291/TCP                                                      21h   |
+  |onap-multicloud   multicloud-vio         10.43.230.197   <nodes>       9004:30294/TCP                                                      21h   |
+  +---------------+----------------------+---------------+-------------+-------------------------------------------------------------------+--------+
 
 
 Now msb,aai and multicloud container are online, navigate to http://msb_docker_host_ip:30081/iui/microservices/index.html,
@@ -111,28 +141,28 @@ Then register vio information into AAI service with region name "vmware" and reg
 
 .. 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": [
-           {
-                               "esr-system-info-id": "123-456",
-                               "system-name": "vim-vio",
-                               "system-type": "vim",
-                               "type": "vim",
-                               "user-name": "admin",
-                               "password": "vmware",
-                               "service-url": "<keystone auth url>",
-                               "cloud-domain": "default",
-                               "default-tenant": "admin",
-                               "ssl-insecure": false
-           }
-       ]
-   }
-}"
+  $ 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": [
+             {
+              "esr-system-info-id": "123-456",
+              "system-name": "vim-vio",
+              "system-type": "vim",
+              "type": "vim",
+              "user-name": "admin",
+              "password": "vmware",
+              "service-url": "<keystone auth url>",
+              "cloud-domain": "default",
+              "default-tenant": "admin",
+              "ssl-insecure": false
+             }
+           ]
+          }
+        }"
 
 Test Examples
 ~~~~~~~~~~~~~
@@ -148,20 +178,21 @@ Get auth token
 
 .. code-block:: console
 
-curl -X  POST   -d @test.json  -H 'Content-Type:application/json'   http://$HOST_IP/api/multicloud/v0/<vimid>/identity/auth/tokens
-
-.. code-block:: console
+  $ curl -X  POST   -d @test.json  -H 'Content-Type:application/json'   http://$HOST_IP/api/multicloud/v0/<vimid>/identity/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"]
-               }
-       }
-}
+      "scope": {"project": {"id": “<project-id>”}},
+      "identity":
+         {
+               "password": {"user": {"domain": {"name": “<doman-name>”}, "password": “<user-password>”, "name": “<user-name>”}}, "methods": ["password"]
+         }
+    }
+  }
 
 
 Response:
@@ -184,7 +215,9 @@ List projects
 
 Use identity’s endpoint:  http://$HOST_IP/api/multicloud-vio/v0/<vimid>/identity/
 
-curl -X GET   -H 'X-Auth-Token:<token>'  http://$HOST_IP/api/multicloud-vio/v0/<vimid>/identity/projects
+.. code-block:: console
+
+  $ curl -X GET   -H 'X-Auth-Token:<token>'  http://$HOST_IP/api/multicloud-vio/v0/<vimid>/identity/projects
 
 
 Get os Hypervisor
@@ -193,13 +226,17 @@ Get os Hypervisor
 Use nova’s endpoint:  http://$HOST_IP/api/multicloud-vio/v0/<vimid>/nova/<user-tenantid>
 
 
-curl -X GET -H 'X-Auth-Token:<token>' http://$HOST_IP/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/os-hypervisors/detail
+.. code-block:: console
+
+  $ curl -X GET -H 'X-Auth-Token:<token>' http://$HOST_IP/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/os-hypervisors/detail
 
 
 List instance of  user’s project
 --------------------------------
 
-curl -X GET -H 'X-Auth-Token:<token>' http://$HOST_IP/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers
+.. code-block:: console
+
+  $ curl -X GET -H 'X-Auth-Token:<token>' http://$HOST_IP/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers
 
 
 Show instance detail
@@ -227,7 +264,9 @@ Start instance
 
 you need to input <server-id> in url path
 
-curl -X POST -d '{"os-start":null}' -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json' http://$HOST_IP/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
+.. code-block:: console
+
+  $ curl -X POST -d '{"os-start":null}' -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json' http://$HOST_IP/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
 
 
 Suspend instance
@@ -235,7 +274,9 @@ Suspend instance
 
 you need to input <server-id> in url path
 
-curl -X POST -d '{"suspend":null}' -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json' http://$HOST_IP/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
+.. code-block:: console
+
+   $ curl -X POST -d '{"suspend":null}' -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json' http://$HOST_IP/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
 
 
 Resume  instance
@@ -243,7 +284,9 @@ Resume  instance
 
 you need to input <server-id> in url path
 
-curl -X POST -d '{"resume":null}' -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json'  http://$HOST_IP/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
+.. code-block:: console
+
+  $ curl -X POST -d '{"resume":null}' -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json'  http://$HOST_IP/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
 
 
 Pause instance
@@ -251,7 +294,9 @@ Pause instance
 
 you need to input <server-id> in url path
 
-curl -X POST -d '{"pause":null}' -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json' http://$HOST_IP/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
+.. code-block:: console
+
+  $ curl -X POST -d '{"pause":null}' -H 'X-Auth-Token:<token>' -H 'Content-Type:application/json' http://$HOST_IP/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
 
 
 Unpasue instance
@@ -259,7 +304,9 @@ Unpasue instance
 
 you need to input <server-id> in url path
 
-curl -X POST -d '{"unpause":null}' -H 'X-Auth-Token:<token> -H 'Content-Type:application/json'  http://$HOST_IP/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
+.. code-block:: console
+
+  $ curl -X POST -d '{"unpause":null}' -H 'X-Auth-Token:<token> -H 'Content-Type:application/json'  http://$HOST_IP/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
 
 
 Reboot instance
@@ -267,4 +314,6 @@ Reboot instance
 
 you need to input <server-id> in url path
 
-curl -X POST -d '{"reboot":{"type":"HARD"}}' -H 'X-Auth-Token:<token> -H 'Content-Type:application/json'  http://$HOST_IP/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action
+.. code-block:: console
+
+  $ curl -X POST -d '{"reboot":{"type":"HARD"}}' -H 'X-Auth-Token:<token> -H 'Content-Type:application/json'  http://$HOST_IP/api/multicloud-vio/v0/<vimid>/nova/<tenantid>/servers/<server-id>/action