From: waynedunican Date: Thu, 13 Apr 2023 08:13:05 +0000 (+0100) Subject: Add documentation for local installation of PF components X-Git-Tag: 3.7.2~10^2 X-Git-Url: https://gerrit.onap.org/r/gitweb?p=policy%2Fparent.git;a=commitdiff_plain;h=f4e2d245485f4a55185d3ef52060b136a25aff6a Add documentation for local installation of PF components Issue-ID: POLICY-4582 Change-Id: I8013a128f6a3bcea7b595b9a82122aaa8d64150e Signed-off-by: waynedunican --- 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 Binary files /dev/null and b/docs/development/devtools/images/a1-ppnt-intellij.png 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 Binary files /dev/null and b/docs/development/devtools/images/acm-eclipse.png 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 Binary files /dev/null and b/docs/development/devtools/images/acm-intellij.png 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 Binary files /dev/null and b/docs/development/devtools/images/apex-pdp-eclipse.png 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 Binary files /dev/null and b/docs/development/devtools/images/apex-pdp-intellij.png 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 Binary files /dev/null and b/docs/development/devtools/images/drools-pdp-eclipse.png 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 Binary files /dev/null and b/docs/development/devtools/images/drools-pdp-intellij.png 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 Binary files /dev/null and b/docs/development/devtools/images/http-ppnt-intellij.png 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 Binary files /dev/null and b/docs/development/devtools/images/k8s-ppnt-intellij.png 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 Binary files /dev/null and b/docs/development/devtools/images/kserve-ppnt-intellij.png 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 Binary files /dev/null and b/docs/development/devtools/images/policy-api-eclipse.png 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 Binary files /dev/null and b/docs/development/devtools/images/policy-api-intellij.png 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 Binary files /dev/null and b/docs/development/devtools/images/policy-pap-eclipse.png 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 Binary files /dev/null and b/docs/development/devtools/images/policy-pap-intellij.png 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 Binary files /dev/null and b/docs/development/devtools/images/policy-ppnt-eclipse.png 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 Binary files /dev/null and b/docs/development/devtools/images/policy-ppnt-intellij.png 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 Binary files /dev/null and b/docs/development/devtools/images/xacml-pdp-eclipse.png 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 Binary files /dev/null and b/docs/development/devtools/images/xacml-pdp-intellij.png 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