From 6b77f909b9bc2799865b3221d0d400c10740d684 Mon Sep 17 00:00:00 2001 From: "denilson.l65" Date: Wed, 13 Oct 2021 04:38:40 +0000 Subject: Add Helm installation guide for datalake-feeder, datalake-admin-ui, datalake-des, slice-analysis-ms Issue-ID: DCAEGEN2-2630 Signed-off-by: denilson.l65 Change-Id: I62e45875f3defc1f63b0ed9a1b06cee530241c0d --- docs/sections/services/datalake-handler/index.rst | 3 +- .../datalake-handler/installation-helm.rst | 107 +++++++++++++++++++++ 2 files changed, 109 insertions(+), 1 deletion(-) create mode 100644 docs/sections/services/datalake-handler/installation-helm.rst (limited to 'docs/sections/services/datalake-handler') diff --git a/docs/sections/services/datalake-handler/index.rst b/docs/sections/services/datalake-handler/index.rst index 7fee00cb..3fade9c6 100644 --- a/docs/sections/services/datalake-handler/index.rst +++ b/docs/sections/services/datalake-handler/index.rst @@ -28,6 +28,7 @@ DataLake-Handler MS Installation Steps and Configurations :maxdepth: 1 ./installation.rst + ./installation-helm.rst DataLake-Handler MS Admin UI User Guide --------------------------------------- @@ -35,4 +36,4 @@ DataLake-Handler MS Admin UI User Guide .. toctree:: :maxdepth: 1 - ./userguide.rst + ./userguide.rst diff --git a/docs/sections/services/datalake-handler/installation-helm.rst b/docs/sections/services/datalake-handler/installation-helm.rst new file mode 100644 index 00000000..015094cf --- /dev/null +++ b/docs/sections/services/datalake-handler/installation-helm.rst @@ -0,0 +1,107 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. _dl-installation-helm: + +Helm Installation +================= + +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. + + +Pre-requisites +~~~~~~~~~~~~~~ +- Datalake postgres should be properly deployed and functional. + +- Presto service should be deployed for des deployment.Here is a sample how presto is deployed in the environment. + + Deploying presto service: + The package of presto version we are using is v0.0.2:presto-v0.0.2.tar.gz + + #docker build -t presto:v0.0.2 . + #docker tag presto:v0.0.2 registry.baidubce.com/onap/presto:v0.0.2 + #docker push registry.baidubce.com/onap/presto:v0.0.2 + + Note: Replace the repository path with your own repository. + + #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" + #kubectl -n onap expose deployment dl-presto --port=9000 --target-port=9000 --type=NodePort + + Note: MonoDB_IP and Mongo_PORT you can replace this two values with your own configuration. + +- The environment should have helm and kubernetes installed. + +- 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. + + For example: + .. code-block:: bash + + helm package + + +Deployment steps +~~~~~~~~~~~~~~~~ +Validate the charts using below commands + .. code-block:: bash + + helm lint + helm lint + helm lint + +Deploy the charts using below commands + .. code-block:: bash + + helm install --namespace onap --set global.masterPassword= + helm install --namespace onap --set global.masterPassword= + helm install --namespace onap --set global.masterPassword= + +For checking logs of the containers + .. code-block:: bash + + kubectl logs -f -n onap -c + kubectl logs -f -n onap -c + kubectl logs -f -n onap -c + +To un-deploy + .. code-block:: bash + + helm uninstall + helm uninstall + helm uninstall + + +Application configurations +~~~~~~~~~~~~~~~~~~~~~~~~~~ +Datalake-admin-ui: + ++-------------------------------+------------------------------------------------+ +|Configuration | Description | ++===============================+================================================+ +|FEEDER_ADDR | Host where dl-feeder is running | ++-------------------------------+------------------------------------------------+ + +Datalake-feeder: + ++-------------------------------+------------------------------------------------+ +|Configuration | Description | ++===============================+================================================+ +|PRESTO_HOST | Host where the presto application is running | ++-------------------------------+------------------------------------------------+ +|PG_HOST | Host where the postgres application is running | ++-------------------------------+------------------------------------------------+ +|CONSUL_HOST | Host where counsul loader container is running | ++-------------------------------+------------------------------------------------+ +|PG_DB | Postgress database name | ++-------------------------------+------------------------------------------------+ + +Datalake-Des: + ++-------------------------------+------------------------------------------------+ +|Configuration | Description | ++===============================+================================================+ +|PRESTO_HOST | Host where the presto application is running | ++-------------------------------+------------------------------------------------+ +|PG_HOST | Host where the postgres application is running | ++-------------------------------+------------------------------------------------+ +|PG_DB | Postgress database name | ++-------------------------------+------------------------------------------------+ + -- cgit 1.2.3-korg