docs/MultiCloud-Deployment-Guide.rst

   1 ================================
   2 ONAP MultiCloud Deployment Guide
   3 ================================
   4
   5 prepare docker environment
   6 ~~~~~~~~~~~~~~~~~~~~~~~~~~
   7
   8 Please refer to onap deployment in kubernetes website(https://wiki.onap.org/display/DW/ONAP+on+Kubernetes)
   9 to setup kubernets cluster.
  10
  11
  12 After installing kubectl and helm, execute "kubectl cluster-info" command to verify your kubernets cluster.
  13
  14 Clone oom project:  git clone http://gerrit.onap.org/r/oom
  15 Source the setenv.bash script in /oom/kubernetes/oneclick/, it will set your helm list of components to start/delete
  16 Run the one time config pod - which mounts the volume /dockerdata/ contained in the pod config-init.
  17
  18 .. code-block:: console
  19
  20   $ cd  oom/kubernetes/config
  21   $ cp onap-parameters-sample.yaml onap-parameters.yaml
  22   $ ./createConfig.sh -n onap
  23
  24 wait for "onap" namespace created, pod "config-init" created
  25
  26 .. code-block:: console
  27
  28   $ kubectl get namespaces
  29   +------------+------------+------+
  30   | NAME       |     STATUS |  AGE |
  31   +------------+------------+------+
  32   |default           Active    10d |
  33   |kube-public       Active    10d |
  34   |kube-system       Active    10d |
  35   |onap              Active    9d  |
  36   +------------+------------+------+
  37
  38 startup containers
  39 ~~~~~~~~~~~~~~~~~~
  40
  41 first run kube2msb container.
  42
  43 .. code-block:: console
  44
  45  $ cd oom/kubernetes/oneclick
  46  $ ./createAll.bash -n onap -a kube2msb
  47
  48 run msb container
  49
  50 .. code-block:: console
  51
  52   $ ./createAll.bash -n onap -a msb
  53
  54 run aai container
  55
  56 .. code-block:: console
  57
  58   $ ./createAll.bash -n onap -a aai
  59
  60
  61 Finally run multicloud container
  62
  63 .. code-block:: console
  64
  65   $ ./createAll.bash -n onap -a multicloud
  66
  67 get all pods
  68
  69 .. code-block:: console
  70
  71   $ kubectl get pods --all-namespaces
  72   +---------------+---------------------------------------+--------+-----------+----------+-----+
  73   |NAMESPACE      |  NAME                                 | READY  |   STATUS  |RESTARTS  | AGE |
  74   +---------------+---------------------------------------+--------+-----------+----------+-----+
  75   |kube-system       heapster-4285517626-2k4l1               1/1       Running   1          9d  |
  76   |kube-system       kube-dns-2514474280-mxh18               3/3       Running   3          9d  |
  77   |kube-system       kubernetes-dashboard-716739405-jl6mk    1/1       Running   1          9d  |
  78   |kube-system       monitoring-grafana-3552275057-hrpn5     1/1       Running   1          9d  |
  79   |kube-system       monitoring-influxdb-4110454889-t8tpv    1/1       Running   1          9d  |
  80   |kube-system       tiller-deploy-737598192-8q523           1/1       Running   1          9d  |
  81   |onap-aai          aai-resources-837807428-2t158           1/1       Running   0          2d  |
  82   |onap-aai          aai-service-3869033750-1nvg5            1/1       Running   0          2d  |
  83   |onap-aai          aai-traversal-50329389-gnsnk            1/1       Running   0          2d  |
  84   |onap-aai          data-router-2254557428-zwxx1            1/1       Running   0          2d  |
  85   |onap-aai          elasticsearch-622738319-sx6q1           1/1       Running   0          2d  |
  86   |onap-aai          gremlin-671060974-npsg5                 1/1       Running   0          2d  |
  87   |onap-aai          hbase-3690059193-2pjc5                  1/1       Running   0          2d  |
  88   |onap-aai          model-loader-service-849987455-w6vwn    1/1       Running   0          2d  |
  89   |onap-aai          search-data-service-4105978183-p1nnj    1/1       Running   0          2d  |
  90   |onap-aai          sparky-be-2696729089-mcjbw              1/1       Running   0          2d  |
  91   |onap-kube2msb     kube2msb-registrator-1600827891-1s3s4   1/1       Running   3          7d  |
  92   |onap-msb          msb-consul-3388279333-hbr16             1/1       Running   0          2d  |
  93   |onap-msb          msb-discovery-1109629174-t14q8          1/1       Running   0          2d  |
  94   |onap-msb          msb-eag-3969419634-2fdnr                1/1       Running   0          2d  |
  95   |onap-msb          msb-iag-1114772402-sjlww                1/1       Running   0          2d  |
  96   |onap-multicloud   framework-1225620501-9567n              1/1       Running   0          21h |
  97   |onap-multicloud   multicloud-vio-269945856-rl6w6          1/1       Running   0          21h |
  98   +---------------+---------------------------------------+--------+-----------+----------+-----+
  99
 100 get cluster-ip and port
 101
 102 .. code-block:: console
 103
 104   $ kubectl get svc --all-namespaces
 105   +---------------+----------------------+---------------+-------------+-------------------------------------------------------------------+--------+
 106   | NAMESPACE     |      NAME            |  CLUSTER-IP   | EXTERNAL-IP |               PORT(S)                                             |  AGE   |
 107   +---------------+----------------------+---------------+-------------+-------------------------------------------------------------------+--------+
 108   |default           kubernetes             10.43.0.1       <none>        443/TCP                                                             10d   |
 109   |kube-system       heapster               10.43.96.134    <none>        80/TCP                                                              10d   |
 110   |kube-system       kube-dns               10.43.0.10      <none>        53/UDP,53/TCP                                                       10d   |
 111   |kube-system       kubernetes-dashboard   10.43.9.43      <none>        9090/TCP                                                            10d   |
 112   |kube-system       monitoring-grafana     10.43.210.16    <none>        80/TCP                                                              10d   |
 113   |kube-system       monitoring-influxdb    10.43.32.60     <none>        8086/TCP                                                            10d   |
 114   |kube-system       tiller-deploy          10.43.84.208    <none>        44134/TCP                                                           10d   |
 115   |onap-aai          aai-resources          None            <none>        8447/TCP,5005/TCP                                                   2d    |
 116   |onap-aai          aai-service            10.43.88.92     <nodes>       8443:30233/TCP,8080:30232/TCP                                       2d    |
 117   |onap-aai          aai-traversal          None            <none>        8446/TCP,5005/TCP                                                   2d    |
 118   |onap-aai          elasticsearch          None            <none>        9200/TCP                                                            2d    |
 119   |onap-aai          gremlin                None            <none>        8182/TCP                                                            2d    |
 120   |onap-aai          hbase                  None            <none>        2181/TCP,8080/TCP,8085/TCP,9090/TCP,16000/TCP,16010/TCP,16201/TCP   2d    |
 121   |onap-aai          model-loader-service   10.43.172.213   <nodes>       8443:30229/TCP,8080:30210/TCP                                       2d    |
 122   |onap-aai          search-data-service    None            <none>        9509/TCP                                                            2d    |
 123   |onap-aai          sparky-be              None            <none>        9517/TCP                                                            2d    |
 124   |onap-msb          msb-consul             10.43.41.203    <nodes>       8500:30500/TCP                                                      2d    |
 125   |onap-msb          msb-discovery          10.43.6.205     <nodes>       10081:30081/TCP                                                     2d    |
 126   |onap-msb          msb-eag                10.43.81.104    <nodes>       80:30082/TCP                                                        2d    |
 127   |onap-msb          msb-iag                10.43.188.78    <nodes>       80:30080/TCP                                                        2d    |
 128   |onap-multicloud   framework              10.43.97.54     <nodes>       9001:30291/TCP                                                      21h   |
 129   |onap-multicloud   multicloud-vio         10.43.230.197   <nodes>       9004:30294/TCP                                                      21h   |
 130   +---------------+----------------------+---------------+-------------+-------------------------------------------------------------------+--------+
 131
 132
 133 Now msb,aai and multicloud container are online, navigate to http://msb_docker_host_ip:30081/iui/microservices/index.html,
 134 you can see  multicloud endpoint have been registered.
 135
 136 No      Service Name    Version NameSpace       Url     Protocol        Visualrange     Control
 137 1       multicloud      v0              /api/multicloud/v0      REST    InSystem
 138 2       multicloud-vio  v0              /api/multicloud-vio/v0  REST    InSystem
 139
 140 Then register vio information into AAI service with region name "vmware" and region id "vio"
 141
 142 .. code-block:: console
 143
 144   $ curl -X PUT -H "Authorization: Basic QUFJOkFBSQ==" -H "Content-Type: application/json" -H "X-TransactionId:get_aai_subcr" \
 145       https://aai_resource_docker_host_ip:30233/aai/v01/cloud-infrastructure/cloud-regions/cloud-region/vmware/vio \
 146       -d "{
 147            "cloud-type": "vmware",
 148            "cloud-region-version": "4.0",
 149            "esr-system-info-list": {
 150            "esr-system-info": [
 151              {
 152               "esr-system-info-id": "123-456",
 153               "system-name": "vim-vio",
 154               "system-type": "vim",
 155               "type": "vim",
 156               "user-name": "admin",
 157               "password": "vmware",
 158               "service-url": "<keystone auth url>",
 159               "cloud-domain": "default",
 160               "default-tenant": "admin",
 161               "ssl-insecure": false
 162              }
 163            ]
 164           }
 165         }"