summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorwaynedunican <wayne.dunican@est.tech>2023-04-13 09:13:05 +0100
committerLiam Fallon <liam.fallon@est.tech>2023-04-14 16:41:21 +0000
commitf4e2d245485f4a55185d3ef52060b136a25aff6a (patch)
treed45fb1755f7448383ad7dc22a051ae54f961b1ba
parent0fb2d6e3dec60ea19d916da57cfde4ee098fca83 (diff)
Add documentation for local installation of PF components
Issue-ID: POLICY-4582 Change-Id: I8013a128f6a3bcea7b595b9a82122aaa8d64150e Signed-off-by: waynedunican <wayne.dunican@est.tech>
-rw-r--r--docs/development/devtools/devtools.rst10
-rw-r--r--docs/development/devtools/images/a1-ppnt-intellij.pngbin0 -> 169355 bytes
-rw-r--r--docs/development/devtools/images/acm-eclipse.pngbin0 -> 228862 bytes
-rw-r--r--docs/development/devtools/images/acm-intellij.pngbin0 -> 163735 bytes
-rw-r--r--docs/development/devtools/images/apex-pdp-eclipse.pngbin0 -> 306536 bytes
-rw-r--r--docs/development/devtools/images/apex-pdp-intellij.pngbin0 -> 273045 bytes
-rw-r--r--docs/development/devtools/images/drools-pdp-eclipse.pngbin0 -> 326193 bytes
-rw-r--r--docs/development/devtools/images/drools-pdp-intellij.pngbin0 -> 186189 bytes
-rw-r--r--docs/development/devtools/images/http-ppnt-intellij.pngbin0 -> 176737 bytes
-rw-r--r--docs/development/devtools/images/k8s-ppnt-intellij.pngbin0 -> 174754 bytes
-rw-r--r--docs/development/devtools/images/kserve-ppnt-intellij.pngbin0 -> 183985 bytes
-rw-r--r--docs/development/devtools/images/policy-api-eclipse.pngbin0 -> 891410 bytes
-rw-r--r--docs/development/devtools/images/policy-api-intellij.pngbin0 -> 474845 bytes
-rw-r--r--docs/development/devtools/images/policy-pap-eclipse.pngbin0 -> 161261 bytes
-rw-r--r--docs/development/devtools/images/policy-pap-intellij.pngbin0 -> 492975 bytes
-rw-r--r--docs/development/devtools/images/policy-ppnt-eclipse.pngbin0 -> 210489 bytes
-rw-r--r--docs/development/devtools/images/policy-ppnt-intellij.pngbin0 -> 169818 bytes
-rw-r--r--docs/development/devtools/images/xacml-pdp-eclipse.pngbin0 -> 292217 bytes
-rw-r--r--docs/development/devtools/images/xacml-pdp-intellij.pngbin0 -> 265483 bytes
-rw-r--r--docs/development/devtools/local-installation.rst252
20 files changed, 262 insertions, 0 deletions
diff --git a/docs/development/devtools/devtools.rst b/docs/development/devtools/devtools.rst
index 0ea25d09..1bb96a8d 100644
--- a/docs/development/devtools/devtools.rst
+++ b/docs/development/devtools/devtools.rst
@@ -421,6 +421,16 @@ To test these images, CSITs will be run.
Automated tests will be run, and log files displayed.
+Running Policy Components Locally
+*********************************
+
+The following page outlines how to run the policy framework components locally use IntelliJ, Eclipse and the Command Line.
+
+.. toctree::
+ :maxdepth: 1
+
+ local-installation.rst
+
Generating Swagger Documentation
********************************
diff --git a/docs/development/devtools/images/a1-ppnt-intellij.png b/docs/development/devtools/images/a1-ppnt-intellij.png
new file mode 100644
index 00000000..808911e3
--- /dev/null
+++ b/docs/development/devtools/images/a1-ppnt-intellij.png
Binary files differ
diff --git a/docs/development/devtools/images/acm-eclipse.png b/docs/development/devtools/images/acm-eclipse.png
new file mode 100644
index 00000000..d70337cf
--- /dev/null
+++ b/docs/development/devtools/images/acm-eclipse.png
Binary files differ
diff --git a/docs/development/devtools/images/acm-intellij.png b/docs/development/devtools/images/acm-intellij.png
new file mode 100644
index 00000000..cd55acdf
--- /dev/null
+++ b/docs/development/devtools/images/acm-intellij.png
Binary files differ
diff --git a/docs/development/devtools/images/apex-pdp-eclipse.png b/docs/development/devtools/images/apex-pdp-eclipse.png
new file mode 100644
index 00000000..d02cfce4
--- /dev/null
+++ b/docs/development/devtools/images/apex-pdp-eclipse.png
Binary files differ
diff --git a/docs/development/devtools/images/apex-pdp-intellij.png b/docs/development/devtools/images/apex-pdp-intellij.png
new file mode 100644
index 00000000..350ceb1f
--- /dev/null
+++ b/docs/development/devtools/images/apex-pdp-intellij.png
Binary files differ
diff --git a/docs/development/devtools/images/drools-pdp-eclipse.png b/docs/development/devtools/images/drools-pdp-eclipse.png
new file mode 100644
index 00000000..8ce2ac47
--- /dev/null
+++ b/docs/development/devtools/images/drools-pdp-eclipse.png
Binary files differ
diff --git a/docs/development/devtools/images/drools-pdp-intellij.png b/docs/development/devtools/images/drools-pdp-intellij.png
new file mode 100644
index 00000000..73af7973
--- /dev/null
+++ b/docs/development/devtools/images/drools-pdp-intellij.png
Binary files differ
diff --git a/docs/development/devtools/images/http-ppnt-intellij.png b/docs/development/devtools/images/http-ppnt-intellij.png
new file mode 100644
index 00000000..ae0b0ef7
--- /dev/null
+++ b/docs/development/devtools/images/http-ppnt-intellij.png
Binary files differ
diff --git a/docs/development/devtools/images/k8s-ppnt-intellij.png b/docs/development/devtools/images/k8s-ppnt-intellij.png
new file mode 100644
index 00000000..9911b68e
--- /dev/null
+++ b/docs/development/devtools/images/k8s-ppnt-intellij.png
Binary files differ
diff --git a/docs/development/devtools/images/kserve-ppnt-intellij.png b/docs/development/devtools/images/kserve-ppnt-intellij.png
new file mode 100644
index 00000000..077d3f5b
--- /dev/null
+++ b/docs/development/devtools/images/kserve-ppnt-intellij.png
Binary files differ
diff --git a/docs/development/devtools/images/policy-api-eclipse.png b/docs/development/devtools/images/policy-api-eclipse.png
new file mode 100644
index 00000000..d083578e
--- /dev/null
+++ b/docs/development/devtools/images/policy-api-eclipse.png
Binary files differ
diff --git a/docs/development/devtools/images/policy-api-intellij.png b/docs/development/devtools/images/policy-api-intellij.png
new file mode 100644
index 00000000..b109b510
--- /dev/null
+++ b/docs/development/devtools/images/policy-api-intellij.png
Binary files differ
diff --git a/docs/development/devtools/images/policy-pap-eclipse.png b/docs/development/devtools/images/policy-pap-eclipse.png
new file mode 100644
index 00000000..e93a298c
--- /dev/null
+++ b/docs/development/devtools/images/policy-pap-eclipse.png
Binary files differ
diff --git a/docs/development/devtools/images/policy-pap-intellij.png b/docs/development/devtools/images/policy-pap-intellij.png
new file mode 100644
index 00000000..9f2d1c94
--- /dev/null
+++ b/docs/development/devtools/images/policy-pap-intellij.png
Binary files differ
diff --git a/docs/development/devtools/images/policy-ppnt-eclipse.png b/docs/development/devtools/images/policy-ppnt-eclipse.png
new file mode 100644
index 00000000..ac011ab9
--- /dev/null
+++ b/docs/development/devtools/images/policy-ppnt-eclipse.png
Binary files differ
diff --git a/docs/development/devtools/images/policy-ppnt-intellij.png b/docs/development/devtools/images/policy-ppnt-intellij.png
new file mode 100644
index 00000000..282e5136
--- /dev/null
+++ b/docs/development/devtools/images/policy-ppnt-intellij.png
Binary files differ
diff --git a/docs/development/devtools/images/xacml-pdp-eclipse.png b/docs/development/devtools/images/xacml-pdp-eclipse.png
new file mode 100644
index 00000000..35a35307
--- /dev/null
+++ b/docs/development/devtools/images/xacml-pdp-eclipse.png
Binary files differ
diff --git a/docs/development/devtools/images/xacml-pdp-intellij.png b/docs/development/devtools/images/xacml-pdp-intellij.png
new file mode 100644
index 00000000..3025cfff
--- /dev/null
+++ b/docs/development/devtools/images/xacml-pdp-intellij.png
Binary files differ
diff --git a/docs/development/devtools/local-installation.rst b/docs/development/devtools/local-installation.rst
new file mode 100644
index 00000000..76520143
--- /dev/null
+++ b/docs/development/devtools/local-installation.rst
@@ -0,0 +1,252 @@
+.. _local-policy-label:
+
+.. toctree::
+ :maxdepth: 2
+
+Policy Framework Component Local Execution
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This page will explain how to execute policy components locally using an IDE (IntelliJ/Eclipse) or using the command line.
+The intention of this page is to outline how a developer can quickly execute a single component for testing purposes, alleviating the need to generate docker images per change to test in Docker/Kubernetes environments.
+
+These instructions are for development purposes only.
+
+Note: Run "mvn clean install" before bringing up the components using the methods outlined below.
+Note: Running applications in the IDEs will require run configurations if shown below.
+
+Policy API
+**********
+
+Eclipse
+-------
+
+ .. image:: images/policy-api-eclipse.png
+
+IntelliJ
+--------
+
+ .. image:: images/policy-api-intellij.png
+
+Command Line
+------------
+
+ .. code-block:: bash
+
+ mvn spring-boot:run -Dspring-boot.run.arguments=”–server.port=8082”
+
+Policy PAP
+**********
+
+Eclipse
+-------
+
+ .. image:: images/policy-pap-eclipse.png
+
+IntelliJ
+--------
+
+ .. image:: images/policy-pap-intellij.png
+
+Command Line
+------------
+
+ .. code-block:: bash
+
+ mvn spring-boot:run -Dspring-boot.run.arguments=”–server.port=8082”
+
+Apex-PDP
+********
+
+Eclipse
+-------
+
+ .. image:: images/apex-pdp-eclipse.png
+
+IntelliJ
+--------
+
+ .. image:: images/apex-pdp-intellij.png
+
+Command Line
+------------
+
+ .. code-block:: bash
+
+ cd services/services-engine
+ mvn -q -e clean compile exec:java -Dexec.mainClass="org.onap.policy.apex.service.engine.main.ApexMain" -Dexec.args="-p /PATH/TO/POLICY_FILE.json"
+
+ACM-Runtime
+***********
+
+Eclipse
+-------
+
+ .. image:: images/acm-eclipse.png
+
+IntelliJ
+--------
+
+ .. image:: images/acm-intellij.png
+
+Command Line
+------------
+
+ .. code-block:: bash
+
+ mvn spring-boot:run -Dspring-boot.run.arguments=”–server.port=8082”
+
+Models Simulators
+*****************
+
+Command Line
+------------
+
+ .. code-block:: bash
+
+ mvn -q -e clean compile exec:java -Dexec.mainClass="org.onap.policy.models.sim.pdp.PdpSimulatorMain" -Dexec.args="-c /PATH/TO/OnapPfConfig.json"
+
+ .. code-block:: bash
+
+ mvn -q -e clean compile exec:java -Dexec.mainClass="org.onap.policy.models.sim.dmaap.startstop.Main" -Dexec.args="-c /PATH/TO/DefaultConfig.json"
+
+XACML-PDP
+*********
+
+Eclipse
+-------
+
+ .. image:: images/xacml-pdp-eclipse.png
+
+IntelliJ
+--------
+
+ .. image:: images/xacml-pdp-intellij.png
+
+Command Line
+------------
+
+ .. code-block:: bash
+
+ cd main
+ mvn -q -e clean compile exec:java -Dexec.mainClass="org.onap.policy.pdpx.main.startstop.Main" -Dexec.args="-c /PATH/TO/XacmlPdpConfigParameters.json"
+
+Drools-PDP
+**********
+
+Eclipse
+-------
+
+ .. image:: images/drools-pdp-eclipse.png
+
+IntelliJ
+--------
+
+ .. image:: images/drools-pdp-intellij.png
+
+Command Line
+------------
+
+ .. code-block:: bash
+
+ cd policy-management
+ mvn -q -e clean compile exec:java -Dexec.mainClass="org.onap.policy.drools.system.Main"
+
+Policy Participant
+******************
+
+Eclipse
+-------
+
+ .. image:: images/policy-ppnt-eclipse.png
+
+IntelliJ
+--------
+
+ .. image:: images/policy-ppnt-intellij.png
+
+Command Line
+------------
+
+ .. code-block:: bash
+
+ mvn spring-boot:run -Dspring-boot.run.arguments=”–server.port=8082”
+
+Http Participant
+****************
+
+Eclipse
+-------
+
+Similar to above eclipse configuration for participant startup.
+
+IntelliJ
+--------
+
+ .. image:: images/http-ppnt-intellij.png
+
+Command Line
+------------
+
+ .. code-block:: bash
+
+ mvn spring-boot:run -Dspring-boot.run.arguments=”–server.port=8082”
+
+Kubernetes Participant
+**********************
+
+Eclipse
+-------
+
+Similar to above eclipse configuration for participant startup.
+
+IntelliJ
+--------
+
+ .. image:: images/k8s-ppnt-intellij.png
+
+Command Line
+------------
+
+ .. code-block:: bash
+
+ mvn spring-boot:run -Dspring-boot.run.arguments=”–server.port=8082”
+
+A1 Participant
+**************
+
+Eclipse
+-------
+
+Similar to above eclipse configuration for participant startup.
+
+IntelliJ
+--------
+
+ .. image:: images/a1-ppnt-intellij.png
+
+Command Line
+------------
+
+ .. code-block:: bash
+
+ mvn spring-boot:run -Dspring-boot.run.arguments=”–server.port=8082”
+
+Kserve Participant
+******************
+
+Eclipse
+-------
+
+Similar to above eclipse configuration for participant startup.
+
+IntelliJ
+--------
+
+ .. image:: images/kserve-ppnt-intellij.png
+
+Command Line
+------------
+
+ .. code-block:: bash
+
+ mvn spring-boot:run -Dspring-boot.run.arguments=”–server.port=8082” \ No newline at end of file