diff options
author | Pamela Dragosh <pdragosh@research.att.com> | 2019-06-25 13:11:07 -0400 |
---|---|---|
committer | Pamela Dragosh <pdragosh@research.att.com> | 2019-06-26 12:11:00 +0000 |
commit | e3fcf2d153bc82d4fdc78bbdecd4bab5f8ad1656 (patch) | |
tree | 79613ce16a29dc7e0aba4f32bcfaaa043d590a4e | |
parent | e76731f77035a13565e91ddb845a19af3190c11e (diff) |
Move docker documentation into installation
In the wrong spot.
Issue-ID: POLICY-1850
Change-Id: If421614ab94bd1f02fec241d3583034baf0e3fcb
Signed-off-by: Pamela Dragosh <pdragosh@research.att.com>
(cherry picked from commit ba5f4d309fe94c7e98199276584b96fb1617706f)
-rw-r--r-- | docs/development/development.rst | 98 | ||||
-rw-r--r-- | docs/installation/docker.rst | 95 |
2 files changed, 95 insertions, 98 deletions
diff --git a/docs/development/development.rst b/docs/development/development.rst index 252e10da..104f8333 100644 --- a/docs/development/development.rst +++ b/docs/development/development.rst @@ -217,103 +217,5 @@ If the developer is only interested in working with the new architecture compone -Building the ONAP Policy Framework Docker Images -************************************************ -The instructions here are based on the instructions in the file *~/git/onap/policy/docker/README.md*. - -**Step 1:** Build the Policy API Docker image - - .. code-block:: bash - - cd ~/git/onap/policy/api/packages - mvn clean install -P docker - -**Step 2:** Build the Policy PAP Docker image - - .. code-block:: bash - - cd ~/git/onap/policy/pap/packages - mvn clean install -P docker - -**Step 3:** Build the Drools PDP docker image. - -This image is a standalone vanilla Drools engine, which does not contain any pre-built drools rules or applications. - - .. code-block:: bash - - cd ~/git/onap/policy/drools-pdp/ - ./docker_verify.sh - -**Step 4:** Build the Drools Application Control Loop image. - -This image has the drools use case application and the supporting software built together with the Drools PDP engine. It is recommended to use this image if you are first working with ONAP Policy and wish to test or learn how the use cases work. - - .. code-block:: bash - - cd ~/git/onap/policy/drools-applications - chmod 755 controlloop/build/docker-cl - controlloop/build/docker-cl --verify - -**Step 5:** Build the Apex PDP docker image: - - .. code-block:: bash - - cd ~/git/onap/policy/apex-pdp/packages/apex-pdp-docker/target - docker build -t onap/policy-apex-pdp policy-apex-pdp - -**Step 5:** Build the XACML PDP docker image: - - .. code-block:: bash - - cd ~/git/onap/policy/xacml-pdp/packages - mvn clean install -P docker - -**Step 7:** Build the policy engine docker image (If working with the legacy Policy Architecture/API): - - .. code-block:: bash - - cd ~/git/onap/policy/engine/ - ./docker_verify.sh - -**Step 8:** Build the Policy SDC Distribution docker image: - - .. code-block:: bash - - cd ~/git/onap/policy/distribution/packages - mvn clean install -Pdocker - - -Starting the ONAP Policy Framework Docker Images -************************************************ - -In order to run the containers, you can use *docker-compose*. This uses the *docker-compose.yml* yaml file to bring up the ONAP Policy Framework. This file is located in the policy/docker repository. - -**Step 1:** Set the environment variable *MTU* to be a suitable MTU size for the application. - - .. code-block:: bash - - export MTU=9126 - - -**Step 2:** Determine if you want policies pre-loaded or not. By default, all the configuration and operational policies will be pre-loaded by the docker compose script. If you do not wish for that to happen, then export this variable: - - .. code-block:: bash - - export PRELOAD_POLICIES=false - - -**Step 3:** Run the system using *docker-compose*. Note that on some systems you may have to run the *docker-compose* command as root or using *sudo*. Note that this command takes a number of minutes to execute on a laptop or desktop computer. - - .. code-block:: bash - - docker-compose up -d - - -**You now have a full standalone ONAP Policy framework up and running!** - - - - - End of Document diff --git a/docs/installation/docker.rst b/docs/installation/docker.rst index 6652c114..bf6064f0 100644 --- a/docs/installation/docker.rst +++ b/docs/installation/docker.rst @@ -10,6 +10,101 @@ Policy Docker Installation :depth: 2 +Building the ONAP Policy Framework Docker Images +************************************************ +The instructions here are based on the instructions in the file *~/git/onap/policy/docker/README.md*. + +**Step 1:** Build the Policy API Docker image + +.. code-block:: bash + +cd ~/git/onap/policy/api/packages +mvn clean install -P docker + +**Step 2:** Build the Policy PAP Docker image + +.. code-block:: bash + +cd ~/git/onap/policy/pap/packages +mvn clean install -P docker + +**Step 3:** Build the Drools PDP docker image. + +This image is a standalone vanilla Drools engine, which does not contain any pre-built drools rules or applications. + +.. code-block:: bash + +cd ~/git/onap/policy/drools-pdp/ +./docker_verify.sh + +**Step 4:** Build the Drools Application Control Loop image. + +This image has the drools use case application and the supporting software built together with the Drools PDP engine. It is recommended to use this image if you are first working with ONAP Policy and wish to test or learn how the use cases work. + +.. code-block:: bash + +cd ~/git/onap/policy/drools-applications +chmod 755 controlloop/build/docker-cl +controlloop/build/docker-cl --verify + +**Step 5:** Build the Apex PDP docker image: + +.. code-block:: bash + +cd ~/git/onap/policy/apex-pdp/packages/apex-pdp-docker/target +docker build -t onap/policy-apex-pdp policy-apex-pdp + +**Step 5:** Build the XACML PDP docker image: + +.. code-block:: bash + +cd ~/git/onap/policy/xacml-pdp/packages +mvn clean install -P docker + +**Step 7:** Build the policy engine docker image (If working with the legacy Policy Architecture/API): + +.. code-block:: bash + +cd ~/git/onap/policy/engine/ +./docker_verify.sh + +**Step 8:** Build the Policy SDC Distribution docker image: + +.. code-block:: bash + +cd ~/git/onap/policy/distribution/packages +mvn clean install -Pdocker + + +Starting the ONAP Policy Framework Docker Images +************************************************ + +In order to run the containers, you can use *docker-compose*. This uses the *docker-compose.yml* yaml file to bring up the ONAP Policy Framework. This file is located in the policy/docker repository. + +**Step 1:** Set the environment variable *MTU* to be a suitable MTU size for the application. + +.. code-block:: bash + +export MTU=9126 + + +**Step 2:** Determine if you want policies pre-loaded or not. By default, all the configuration and operational policies will be pre-loaded by the docker compose script. If you do not wish for that to happen, then export this variable: + +.. code-block:: bash + +export PRELOAD_POLICIES=false + + +**Step 3:** Run the system using *docker-compose*. Note that on some systems you may have to run the *docker-compose* command as root or using *sudo*. Note that this command takes a number of minutes to execute on a laptop or desktop computer. + +.. code-block:: bash + +docker-compose up -d + + +**You now have a full standalone ONAP Policy framework up and running!** + + End of Document |