From f4e2d245485f4a55185d3ef52060b136a25aff6a Mon Sep 17 00:00:00 2001 From: waynedunican Date: Thu, 13 Apr 2023 09:13:05 +0100 Subject: Add documentation for local installation of PF components Issue-ID: POLICY-4582 Change-Id: I8013a128f6a3bcea7b595b9a82122aaa8d64150e Signed-off-by: waynedunican --- docs/development/devtools/local-installation.rst | 252 +++++++++++++++++++++++ 1 file changed, 252 insertions(+) create mode 100644 docs/development/devtools/local-installation.rst (limited to 'docs/development/devtools/local-installation.rst') 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 -- cgit 1.2.3-korg