summaryrefslogtreecommitdiffstats
path: root/docs/development/devtools/devtools.rst
diff options
context:
space:
mode:
authordanielhanrahan <daniel.hanrahan@est.tech>2022-05-26 13:49:38 +0100
committerdanielhanrahan <daniel.hanrahan@est.tech>2022-05-27 17:06:46 +0100
commit16ab2df4bf5c9785ea43e3ae7d021f6d5e9e1801 (patch)
tree78c20fedfedc817f0e9509374592cbad655f756e /docs/development/devtools/devtools.rst
parent2e11c2e6df991a40933a72c3ff5e8341c047c613 (diff)
Documentation update for OpenSuse images
Update policy documentation to show how to build and test OpenSuse docker images. Issue-ID: POLICY-4219 Signed-off-by: danielhanrahan <daniel.hanrahan@est.tech> Change-Id: I5b4b5e1661b3157bc40ef6e75d02c108772f3cae
Diffstat (limited to 'docs/development/devtools/devtools.rst')
-rw-r--r--docs/development/devtools/devtools.rst51
1 files changed, 51 insertions, 0 deletions
diff --git a/docs/development/devtools/devtools.rst b/docs/development/devtools/devtools.rst
index 37fba6cc..2c73369e 100644
--- a/docs/development/devtools/devtools.rst
+++ b/docs/development/devtools/devtools.rst
@@ -355,6 +355,57 @@ the Policy Framework works in a full ONAP deployment.
distribution-pairwise.rst
+Testing OpenSuse docker images
+******************************
+
+Policy Framework offers docker images in two flavors: Alpine and OpenSuse.
+Alpine images are used in OOM for ONAP deployments.
+The OpenSuse images are built manually if needed, by running Maven with the -Pdockersuse profile.
+To test these images, CSITs will be run.
+
+1. Build the OpenSuse image you want by running Maven with -Pdockersuse:
+
+ .. code-block:: bash
+
+ cd policy/apex-pdp
+ mvn clean install -Pdockersuse
+
+ The image onap/policy-apex-pdp:latest will be produced.
+
+2. To avoid ambiguity, tag the image as opensuse:
+
+ .. code-block:: bash
+
+ docker tag onap/policy-apex-pdp:latest onap/policy-apex-pdp:opensuse
+
+3. Clone policy/docker repo.
+
+4. Modify docker/csit/docker-compose-all.yml to use the tagged OpenSuse image.
+
+ Replace:
+
+ .. code-block:: yaml
+
+ apex-pdp:
+ image: nexus3.onap.org:10001/onap/policy-apex-pdp:${POLICY_APEX_PDP_VERSION}
+
+ with:
+
+ .. code-block:: yaml
+
+ apex-pdp:
+ image: onap/policy-apex-pdp:opensuse
+
+5. Run the project CSIT. For apex-pdp:
+
+ .. code-block:: bash
+
+ cd docker/csit
+ ./run-project-csit.sh apex-pdp
+
+ Automated tests will be run, and log files displayed.
+
+
Generating Swagger Documentation
********************************