docs/sections/services/datalake-handler/installation-helm.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   2 .. http://creativecommons.org/licenses/by/4.0
   3 .. _dl-installation-helm:
   4
   5 Helm Installation
   6 =================
   7
   8 DL-handler consists of three pods- the feeder, admin UI and des. It can be deployed by using helm charts. The following steps guides you launch datalake though helm.
   9
  10
  11 Pre-requisites
  12 ~~~~~~~~~~~~~~
  13 - Datalake postgres should be properly deployed and functional.
  14
  15 - Presto service should be deployed for des deployment.Here is a sample how presto is deployed in the environment.
  16
  17    Deploying presto service:
  18     The package of presto version we are using is v0.0.2:presto-v0.0.2.tar.gz
  19
  20      #docker build -t presto:v0.0.2 .
  21      #docker tag presto:v0.0.2 registry.baidubce.com/onap/presto:v0.0.2
  22      #docker push registry.baidubce.com/onap/presto:v0.0.2
  23
  24     Note: Replace the repository path with your own repository.
  25
  26      #kubectl -n onap run dl-presto --image=registry.baidubce.com/onap/presto:v0.0.2 --env="MongoDB_IP=192.168.235.11" --env="MongoDB_PORT=27017"
  27      #kubectl -n onap expose deployment dl-presto --port=9000 --target-port=9000 --type=NodePort
  28
  29     Note: MonoDB_IP and Mongo_PORT you can replace this two values with your own configuration.
  30
  31 - The environment should have helm and kubernetes installed.
  32
  33 - Check whether all the charts mentioned in the requirements.yaml file are present in the charts/ folder. If not present, package the respective chart and put it in the charts/ folder.
  34
  35  For example:
  36     .. code-block:: bash
  37
  38         helm package <dcaegen2-services-common>
  39
  40
  41 Deployment steps
  42 ~~~~~~~~~~~~~~~~
  43 Validate the charts using below commands
  44     .. code-block:: bash
  45
  46         helm lint <dcae-datalake-admin-ui>
  47         helm lint <dcae-datalake-feeder>
  48         helm lint <dcae-datalake-des>
  49
  50 Deploy the charts using below commands
  51     .. code-block:: bash
  52
  53         helm install <datalake-admin-ui> <dcae-datalake-admin-ui> --namespace onap --set global.masterPassword=<password>
  54         helm install <datalake-feeder> <dcae-datalake-feeder> --namespace onap --set global.masterPassword=<password>
  55         helm install <datalake-des> <dcae-datalake-des> --namespace onap --set global.masterPassword=<password>
  56
  57 For checking logs of the containers
  58     .. code-block:: bash
  59
  60         kubectl logs -f -n onap <dev-dcae-datalake-admin-ui-843bfsk4f4-btd7s> -c <dcae-datalake-admin-ui>
  61         kubectl logs -f -n onap <dev-dcae-datalake-feeder-758bbf547b-ctf6s> -c <dcae-datalake-feeder>
  62         kubectl logs -f -n onap <dev-dcae-datalake-des-56465d86fd-2w56c> -c <dcae-datalake-des>
  63
  64 To un-deploy
  65     .. code-block:: bash
  66
  67         helm uninstall <datalake-admin-ui>
  68         helm uninstall <datalake-feeder>
  69         helm uninstall <datalake-des>
  70
  71
  72 Application configurations
  73 ~~~~~~~~~~~~~~~~~~~~~~~~~~
  74 Datalake-admin-ui:
  75
  76 +-------------------------------+------------------------------------------------+
  77 |Configuration                  | Description                                    |
  78 +===============================+================================================+
  79 |FEEDER_ADDR                    | Host where dl-feeder is running                |
  80 +-------------------------------+------------------------------------------------+
  81
  82 Datalake-feeder:
  83
  84 +-------------------------------+------------------------------------------------+
  85 |Configuration                  | Description                                    |
  86 +===============================+================================================+
  87 |PRESTO_HOST                    | Host where the presto application is running   |
  88 +-------------------------------+------------------------------------------------+
  89 |PG_HOST                        | Host where the postgres application is running |
  90 +-------------------------------+------------------------------------------------+
  91 |CONSUL_HOST                    | Host where counsul loader container is running |
  92 +-------------------------------+------------------------------------------------+
  93 |PG_DB                          | Postgress database name                        |
  94 +-------------------------------+------------------------------------------------+
  95
  96 Datalake-Des:
  97
  98 +-------------------------------+------------------------------------------------+
  99 |Configuration                  | Description                                    |
 100 +===============================+================================================+
 101 |PRESTO_HOST                    | Host where the presto application is running   |
 102 +-------------------------------+------------------------------------------------+
 103 |PG_HOST                        | Host where the postgres application is running |
 104 +-------------------------------+------------------------------------------------+
 105 |PG_DB                          | Postgress database name                        |
 106 +-------------------------------+------------------------------------------------+
 107