summaryrefslogtreecommitdiffstats
path: root/docs/development/devtools/pairwise/clamp-dcae.rst
diff options
context:
space:
mode:
authorFrancescoFioraEst <francesco.fiora@est.tech>2023-04-19 10:05:53 +0100
committerFrancescoFioraEst <francesco.fiora@est.tech>2023-04-19 11:35:48 +0100
commit1ebe9f0a2425b1eb89b50d1658c07f7fbe92e4db (patch)
tree21245c90fbdea9e7deb816ae036bf501cdcd102a /docs/development/devtools/pairwise/clamp-dcae.rst
parent6b22fd6c16dbf30a1a95a688e9debde7b2a76d83 (diff)
Restructure of devtools folder for pairwise tests
Move pairwise tests docs to pairwise folder Issue-ID: POLICY-4627 Change-Id: Id87534466ffc33b7c88a8472fbf896eebb1c92c9 Signed-off-by: FrancescoFioraEst <francesco.fiora@est.tech>
Diffstat (limited to 'docs/development/devtools/pairwise/clamp-dcae.rst')
-rw-r--r--docs/development/devtools/pairwise/clamp-dcae.rst117
1 files changed, 117 insertions, 0 deletions
diff --git a/docs/development/devtools/pairwise/clamp-dcae.rst b/docs/development/devtools/pairwise/clamp-dcae.rst
new file mode 100644
index 00000000..0d48c2bc
--- /dev/null
+++ b/docs/development/devtools/pairwise/clamp-dcae.rst
@@ -0,0 +1,117 @@
+.. This work is licensed under a
+.. Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+.. _clamp-pairwise-testing-label:
+
+.. toctree::
+ :maxdepth: 2
+
+CLAMP <-> Dcae
+~~~~~~~~~~~~~~
+
+The pairwise testing is executed against a default ONAP installation in the OOM.
+CLAMP-Automation Composition interacts with DCAE to deploy dcaegen2 services like PMSH.
+This test verifies the interaction between DCAE and clamp-acm works as expected.
+
+General Setup
+*************
+
+The kubernetes installation allocated all policy components across multiple worker node VMs.
+The worker VM hosting the policy components has the following spec:
+
+- 16GB RAM
+- 8 VCPU
+- 160GB Ephemeral Disk
+
+
+The ONAP components used during the pairwise tests are:
+
+- CLAMP acm runtime, policy participant, kubernetes participant.
+- DCAE for running dcaegen2-service via kubernetes participant.
+- ChartMuseum service from platform, initialised with DCAE helm charts.
+- DMaaP for the communication between Automation Composition runtime and participants.
+- Policy Gui for instantiation and commissioning of control loops.
+
+
+ChartMuseum Setup
+*****************
+
+The chartMuseum helm chart from the platform is deployed in the same cluster. The chart server is then initialized with the helm charts of dcaegen2-services by running the below script in OOM repo.
+The script accepts the directory path as an argument where the helm charts are located.
+
+.. code-block:: bash
+
+ #!/bin/sh
+ ./oom/kubernetes/contrib/tools/registry-initialize.sh -d /oom/kubernetes/dcaegen2-services/charts/
+
+Testing procedure
+*****************
+
+The test set focused on the following use cases:
+
+- Deployment and Configuration of DCAE microservice PMSH
+- Undeployment of PMSH
+
+Creation of the Automation Composition:
+---------------------------------------
+An Automation Composition is created by commissioning a Tosca template with Automation Composition definitions and instantiating the Automation Composition with the state "UNINITIALISED".
+
+- Upload a TOSCA template from the POLICY GUI. The definitions include a kubernetes participant and automation composition elements that deploys and configures a microservice in the kubernetes cluster.
+ Automation Composition element for kubernetes participant includes a helm chart information of DCAE microservice and the element for Http Participant includes the configuration entity for the microservice.
+ :download:`Sample Tosca template <tosca/pairwise-testing.yml>`
+
+ .. image:: images/ac-commission.png
+
+ .. image:: images/ac-upload.png
+
+ Verification: The template is commissioned successfully without errors.
+
+- Instantiate the commissioned Automation Composition definitions from the Policy Gui under 'Instantiation Management'.
+
+ .. image:: images/create-instance.png
+
+ Update instance properties of the Automation Composition Elements if required.
+
+ .. image:: images/update-instance.png
+
+ Verification: The Automation composition is created with default state "UNINITIALISED" without errors.
+
+ .. image:: images/ac-instantiation.png
+
+
+Deployment and Configuration of DCAE microservice (PMSH):
+---------------------------------------------------------
+The Automation Composition state is changed from "UNINITIALISED" to "PASSIVE" from the Policy Gui. The kubernetes participant deploys the PMSH helm chart from the DCAE chartMuseum server.
+
+.. image:: images/ac-passive.png
+
+Verification:
+
+- DCAE service PMSH is deployed in to the kubernetes cluster. PMSH pods are in RUNNING state.
+ `helm ls -n <namespace>` - The helm deployment of dcaegen2 service PMSH is listed.
+ `kubectl get pod -n <namespace>` - The PMSH pods are deployed, up and running.
+
+- The subscription configuration for PMSH microservice from the TOSCA definitions are updated in the Consul server. The configuration can be verified on the Consul server UI `http://<CONSUL-SERVER_IP>/ui/#/dc1/kv/`
+
+- The overall state of the Automation Composition is changed to "PASSIVE" in the Policy Gui.
+
+.. image:: images/ac-create.png
+
+
+Undeployment of DCAE microservice (PMSH):
+-----------------------------------------
+The Automation Composition state is changed from "PASSIVE" to "UNINITIALISED" from the Policy Gui.
+
+.. image:: images/ac-uninitialise.png
+
+Verification:
+
+- The kubernetes participant uninstall the DCAE PMSH helm chart from the kubernetes cluster. The pods are removed from the cluster.
+
+- The overall state of the Automation Composition is changed to "UNINITIALISED" in the Policy Gui.
+
+.. image:: images/ac-uninitialised-state.png
+
+
+