summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorFrank Kimmlingen <frank.kimmlingen@telekom.de>2022-09-07 11:23:52 +0200
committerFrank Kimmlingen <frank.kimmlingen@telekom.de>2022-09-09 12:59:06 +0000
commit43496fb210dd08bd934fedf2e5e1bba4636000d1 (patch)
tree27874cf1746f7c7f02ab47c2bcaf581a440ec669 /docs
parent27778ac1289588a9f68e9b9408819f7bfb1c7d21 (diff)
Make UatExecutor accessible inside a CBA JUnit test
Issue-ID: CCSDK-3748 Signed-off-by: Frank Kimmlingen <frank.kimmlingen@telekom.de> Change-Id: Icbc0a44d91fd08f2e06a12bcdf016655a2b2282d
Diffstat (limited to 'docs')
-rw-r--r--docs/modelingconcepts/test.rst43
1 files changed, 42 insertions, 1 deletions
diff --git a/docs/modelingconcepts/test.rst b/docs/modelingconcepts/test.rst
index 1ea8b889f..cd29d88d9 100644
--- a/docs/modelingconcepts/test.rst
+++ b/docs/modelingconcepts/test.rst
@@ -39,4 +39,45 @@ Reference link for sample generated uat.yaml file for pnf plug & play use case:
As UAT is part of unit testing, it runs in jenkins job
`ccsdk-cds-master-verify-java <https://jenkins.onap.org/job/ccsdk-cds-master-verify-java/>`_
-whenever a new commit/patch pushed on gerrit in ccsdk/cds repo. \ No newline at end of file
+whenever a new commit/patch pushed on gerrit in ccsdk/cds repo.
+
+Executing UAT based test inside you own CBA as SpringBootTest based JUnit test
+*******************************************************************************
+
+Beside the above mentioned internal usage of UATs, it is also possible to execute the User Acceptance Tests (UATs)
+locally inside your own CBA as a "simple JUnit" test.
+Therefor there exists an abstract *SpringBootTest* class **BaseBlueprintsAcceptanceTest**
+(see class in *archetype-blueprint*).
+From this you need to implement an inherited class e.g. **BlueprintAcceptanceSunnyTest**
+(see class in *archetype-blueprint*), which only needs to specify the **uat.yaml** file, that should be executed.
+This means it is possible to simply integrate this kind of tests in your own regression test suite.
+
+UATs aims to fully test your workflow of your CBA.
+
+The BPP runs in an almost production-like configuration with some minor exceptions:
+
+* It uses an embedded, in-memory, and initially empty H2 database, running in MySQL/MariaDB compatibility mode;
+* All external services are mocked.
+
+For further information about User Acceptance Tests (UATs) see the following README.md inside the CDS repository
+
+`Link to uat-blueprints README.md in CDS Github repository
+<https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/blueprint-model/uat-blueprints/README.md>`_
+
+Additionally please mention, that you also need resources, which configures the SpringBootTest. These resources you can
+also find in the *archetype-blueprint* (Tests/resources folder).
+
+To have a good starting point with your cba development, please generate the cba *archetype-blueprint* project with
+the following command.
+
+.. code-block:: bash
+
+ mvn archetype:generate -DarchetypeGroupId=org.onap.ccsdk.cds.components.cba \
+ -DarchetypeArtifactId=archetype-blueprint \
+ -DarchetypeVersion=1.4.0-SNAPSHOT \
+ -DgroupId=org.onap.ccsdk.cds.components.cba \
+ -DartifactId=testUat \
+ -Dversion=1.0-SNAPSHOT
+
+There you will find the above mentioned base class, sample class and resources you could use as a starting point for
+writing UAT tests inside your own CBA. \ No newline at end of file