Merge "Add documentation for local installation of PF components"

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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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