From 2cbcccc6d06324f3c91306ed73f262b631457a23 Mon Sep 17 00:00:00 2001
From: Todd Malsbary <todd.malsbary@intel.com>
Date: Fri, 7 Aug 2020 10:20:12 -0700
Subject: Add playbooks for v2 emco chart.

Rename v2/onap4k8s to v2/emco, and rename sanity-check-for-v2.sh to
emco.sh.  This allows --plugins emco to be passed to installer.sh in
place of --plugins onap4k8s.

Issue-ID: MULTICLOUD-1181
Signed-off-by: Todd <todd.malsbary@intel.com>
Change-Id: Idb427a8aa4c8aaff181965a540078c8cf6dd88aa
---
 deployments/helm/v2/emco/README.md | 78 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 78 insertions(+)
 create mode 100644 deployments/helm/v2/emco/README.md

(limited to 'deployments/helm/v2/emco/README.md')

diff --git a/deployments/helm/v2/emco/README.md b/deployments/helm/v2/emco/README.md
new file mode 100644
index 00000000..3534f5a5
--- /dev/null
+++ b/deployments/helm/v2/emco/README.md
@@ -0,0 +1,78 @@
+#################################################################
+# EMCO v2 helm charts
+#################################################################
+
+EMCO Helm charts include charts for EMCO microservices along with MongoDb, etcd, Fluentd
+
+
+### Steps to generate and install packages
+**1. Create a local helm repo from Makefile**
+
+`$ make repo`
+
+**2. Run make file to package all the required chart**
+
+`$ make clean`
+
+`$ make all`
+
+Pacakges helm charts in tar.gz format. All packages are in **dist/packages** directory and the package of intrest are:
+
+   File      | Description |
+  | ----------- | ----------- |
+  | **emco-db-0.1.0.tgz**      | Includes database packages for mongo & etcd       |
+  | **emco-services-0.1.0.tgz**   | Includes packages for all EMCO services like orchestrator, ncm, rsync etc        |
+  | **emco-tools-0.1.0.tgz**   | Tools like Fluentd to be used with EMCO        |
+  | **emco-0.1.0.tgz**   | Includes all charts including database, all services and tools        |
+
+
+**3. Deploy EMCO Packages for Databases and Services**
+
+`$ helm install dist/packages/emco-db-0.1.0.tgz --name emco-db --namespace emco`
+
+`$ helm install dist/packages/emco-services-0.1.0.tgz --name emco-services --namespace emco`
+
+**4. Deploy tools (Optional)**
+
+`$ helm install dist/packages/emco-tools-0.1.0.tgz --name rel-tools --namespace emco`
+
+NOTE: Deploy the Chart emco-0.1.0.tgz to deploy all packages including database, services and tools.
+
+`$ helm install dist/packages/emco-0.1.0.tgz --name rel --namespace emco`
+
+
+**5. To check logs of the different Microservices check fluentd logs**
+
+`kubectl logs rel-fluentd-0 -n emco | grep orchestrator`
+
+
+**6. Delete all packages**
+
+`$ helm delete rel-services --purge`
+
+`$ helm delete rel-db --purge`
+
+Optional if tools were installed
+
+`$ helm delete rel-tools --purge`
+
+NOTE: If the Chart emco-0.1.0.tgz was deployed
+
+`$ helm delete rel --purge`
+
+
+**7. Delete local helm repo**
+
+`make repo-stop`
+
+### Known Issues
+
+After deleting the db package and before installing the package again following error happens:
+
+`Error: release rel-db failed: object is being deleted: persistentvolumes "rel-db-emco-etcd-data-0" already exists`
+
+Workaround :
+
+`kubectl edit persistentvolumes rel-db-emco-etcd-data-0`
+
+and remover finalizers section
-- 
cgit 1.2.3-korg