From 83c0cd2c078f89a386701b7f8e680fd3fc70ecfd Mon Sep 17 00:00:00 2001 From: "Singal, Kapil (ks220y)" Date: Mon, 19 Oct 2020 10:00:59 -0400 Subject: Refactoring docs Issue-ID: CCSDK-2916 Signed-off-by: Singal, Kapil (ks220y) Change-Id: Ide8d830bc5cfe223752f81b35d2f09a5759f5aa2 --- docs/index.rst | 2 - docs/microservices/blueprintsProcessorMS.rst | 87 ------------------------ docs/microservices/controllerBlueprintMS.rst | 21 ------ docs/microservices/dynamicapi.rst | 23 ------- docs/microservices/enrichment.rst | 33 --------- docs/microservices/media/Enrichment-REST.png | Bin 156586 -> 0 bytes docs/microservices/media/Enrichment-UI1.png | Bin 42383 -> 0 bytes docs/microservices/media/Enrichment-UI2.png | Bin 109402 -> 0 bytes docs/microservices/media/blueprintprocessor.jpg | Bin 63829 -> 0 bytes docs/microservices/media/dyanmicapi.jpg | Bin 118101 -> 0 bytes docs/microservices/workflow.rst | 69 ------------------- docs/userguide/developer-guide.rst | 27 +++++++- docs/userguide/media/blueprintprocessor.jpg | Bin 0 -> 63829 bytes docs/userguide/running-bp-processor-in-ide.rst | 6 +- 14 files changed, 27 insertions(+), 241 deletions(-) delete mode 100644 docs/microservices/blueprintsProcessorMS.rst delete mode 100644 docs/microservices/controllerBlueprintMS.rst delete mode 100644 docs/microservices/dynamicapi.rst delete mode 100644 docs/microservices/enrichment.rst delete mode 100644 docs/microservices/media/Enrichment-REST.png delete mode 100644 docs/microservices/media/Enrichment-UI1.png delete mode 100644 docs/microservices/media/Enrichment-UI2.png delete mode 100644 docs/microservices/media/blueprintprocessor.jpg delete mode 100644 docs/microservices/media/dyanmicapi.jpg delete mode 100644 docs/microservices/workflow.rst create mode 100644 docs/userguide/media/blueprintprocessor.jpg diff --git a/docs/index.rst b/docs/index.rst index e551b53e1..690ba134a 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -77,8 +77,6 @@ Modeling Concept Links: :maxdepth: 1 modelingconcepts/index - microservices/controllerBlueprintMS - microservices/blueprintsProcessorMS Scripts ------- diff --git a/docs/microservices/blueprintsProcessorMS.rst b/docs/microservices/blueprintsProcessorMS.rst deleted file mode 100644 index 9f13c0e5d..000000000 --- a/docs/microservices/blueprintsProcessorMS.rst +++ /dev/null @@ -1,87 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons. -.. Copyright (C) 2019 IBM. - -Blueprints Processor -==================== - -.. toctree:: - :maxdepth: 1 - :titlesonly: - -Micro service to Manage Controller Blueprint Models, such as Resource Dictionary, Service Models, Velocity Templates etc, which will serve service for Controller Design Studio and Controller runtimes. - -This microservice is used to deploy Controller Blueprint Archive file in Run time database. This also helps to test the Valid Blueprint. - -Architecture: -------------- - -|image0| - -.. |image0| image:: media/blueprintprocessor.jpg - :width: 400pt - -Running Blueprints Processor Microservice Locally: --------------------------------------------------- - -The purpose of this page is to show how to run the Blueprints Processor microservice locally, using the docker-compose.yaml file provided in the project. - -Check out the CDS' code: - -Check out the latest code from Gerrit: https://gerrit.onap.org/r/#/admin/projects/ccsdk/cds - -Build CDS locally: -In the checked out directory, type - -.. code-block:: none - - mvn clean install -Pq -Dadditionalparam=-Xdoclint:none - -Create the needed Docker images: - -The Blueprints Processor microservice project has a module, called distribution, that provides a docker-compose.yaml file that can be used to spin up Docker containers to run this microservice. - -The first step is to create any custom image needed, by building the distribution module. From the CDS home directory (where the code was checked out), navigate to the module: - -.. code-block:: none - - cd ms/blueprintsprocessor/distribution/ - -Build it using the Maven profile called Docker: - -.. code-block:: none - - mvn clean install -Pdocker - - -Start Docker containers using docker-composer: ----------------------------------------------- - -Navigate to the docker-compose file in the distribution module: - -.. code-block:: none - - cd src/main/dc/ - -From there, start the containers: - -.. code-block:: none - - docker-compose up -d - -This will spin the Docker containers declared inside the docker-compose.yaml file in the background. - - -To verify the logs generated by docker-composer, type: - -.. code-block:: none - - docker-compose logs -f - - -Testing the environment: ------------------------- - -Point your browser to http://localhost:8000/api/v1/execution-service/ping (please note that the port is 8000, not 8080) - -To authenticate, use login user id and password. \ No newline at end of file diff --git a/docs/microservices/controllerBlueprintMS.rst b/docs/microservices/controllerBlueprintMS.rst deleted file mode 100644 index 6b9fb49a2..000000000 --- a/docs/microservices/controllerBlueprintMS.rst +++ /dev/null @@ -1,21 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons. -.. Copyright (C) 2019 IBM. - -Controller Blueprints Studio Processor -====================================== - -The **C**\ ontroller **B**\ lueprint **A**\ rchive is the overall service design, fully model-driven, intent based -**package** needed for SELF SERVICE provisioning and configuration management automation. - -The CBA is .zip file, which is saved in Controller Blueprint Database. - - -Controller Blueprint Microservices: ------------------------------------ - -.. toctree:: - :maxdepth: 1 - - dynamicapi - enrichment diff --git a/docs/microservices/dynamicapi.rst b/docs/microservices/dynamicapi.rst deleted file mode 100644 index 264dcc570..000000000 --- a/docs/microservices/dynamicapi.rst +++ /dev/null @@ -1,23 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 -.. Copyright (C) 2019 IBM. - -Dynamic API -=========== - -The nature of the API request and response is meant to be model driven and dynamic. They both share the same definition. - -The actionName, under the actionIdentifiers refers to the name of a Workflow (see workflow) - -The content of the payload is what is fully dynamic / model driven. - -The first top level element will always be either $actionName-request for a request or $actionName-response for a response. - -Then the content within this element is fully based on the workflow input and output. - -Here is how the a generic request and response look like. - -|image0| - -.. |image0| image:: media/dyanmicapi.jpg - :width: 500pt \ No newline at end of file diff --git a/docs/microservices/enrichment.rst b/docs/microservices/enrichment.rst deleted file mode 100644 index 5ddb23bb4..000000000 --- a/docs/microservices/enrichment.rst +++ /dev/null @@ -1,33 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 -.. International License. http://creativecommons.org/licenses/by/4.0 -.. Copyright (C) 2019 IBM. - - -Enrichment -========== -.. toctree:: - :maxdepth: 1 - -Once the base CBA zip file is done, the enrichment process will complete the design by providing all the definitions required for the self-service provisioning. - -The following shows 2 ways to run CBA enrichment - -REST API request: ------------------ -|image0| - - -CDS UI: -------- -|image1| - -|image2| - -.. |image0| image:: media/Enrichment-REST.png - :width: 500pt - -.. |image1| image:: media/Enrichment-UI1.png - :width: 500pt - -.. |image2| image:: media/Enrichment-UI2.png - :width: 500pt \ No newline at end of file diff --git a/docs/microservices/media/Enrichment-REST.png b/docs/microservices/media/Enrichment-REST.png deleted file mode 100644 index 005f7960b..000000000 Binary files a/docs/microservices/media/Enrichment-REST.png and /dev/null differ diff --git a/docs/microservices/media/Enrichment-UI1.png b/docs/microservices/media/Enrichment-UI1.png deleted file mode 100644 index 082af6128..000000000 Binary files a/docs/microservices/media/Enrichment-UI1.png and /dev/null differ diff --git a/docs/microservices/media/Enrichment-UI2.png b/docs/microservices/media/Enrichment-UI2.png deleted file mode 100644 index 90be708b5..000000000 Binary files a/docs/microservices/media/Enrichment-UI2.png and /dev/null differ diff --git a/docs/microservices/media/blueprintprocessor.jpg b/docs/microservices/media/blueprintprocessor.jpg deleted file mode 100644 index 429876a13..000000000 Binary files a/docs/microservices/media/blueprintprocessor.jpg and /dev/null differ diff --git a/docs/microservices/media/dyanmicapi.jpg b/docs/microservices/media/dyanmicapi.jpg deleted file mode 100644 index 5cc1ae176..000000000 Binary files a/docs/microservices/media/dyanmicapi.jpg and /dev/null differ diff --git a/docs/microservices/workflow.rst b/docs/microservices/workflow.rst deleted file mode 100644 index 5a564870c..000000000 --- a/docs/microservices/workflow.rst +++ /dev/null @@ -1,69 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 -.. International License. http://creativecommons.org/licenses/by/4.0 -.. Copyright (C) 2019 IBM. - -Workflow -======== -A workflow defines an overall action to be taken on the service, hence is an entry-point for the run-time execution of the CBA package. - -A workflow also defines inputs and outputs that will defined the payload contract of the request and response (see Dynamic API) - -A workflow can be composed of one or multiple sub-actions to execute. - -A CBA package can have as many workflows as needed. - - -Single action -------------- -The workflow is directly backed by a node_template of type tosca.nodes.Component - - -Multiple sub-actions --------------------- -The workflow is backed by Directed Graph engine, node_template of type dg-generic, and are imperative workflows. - -A DG used as workflow for CDS is composed of multiple execute nodes; each individual execute node refers to a plugin, that is a node_template of type tosca.nodes.Component. - -Below the properties of a workflow: - - -Workflow Example ----------------- -.. code-block:: json - - { - "workflow": { - "resource-assignment": { <- workflow-name - "inputs": { - "vnf-id": { <- static inputs - "required": true, - "type": "string" - }, - "resource-assignment-properties": { <- dynamic inputs - "required": true, - "type": "dt-resource-assignment-properties" - } - }, - "steps": { - "call-resource-assignment": { <- step-name - "description": "Resource Assignment Workflow", - "target": "resource-assignment-process" <- node_template targeted by the step - } - }, - "outputs": { - "template-properties": { <- output - "type": "json", <- complex type - "value": { - "get_attribute": [ <- uses expression to retrieve attribute from context - "resource-assignment", - "assignment-params" - ] - } - } - } - } - } - } - - -TOSCA definition: http://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.2/csd01/TOSCA-Simple-Profile-YAML-v1.2-csd01.html#_Toc494454203 diff --git a/docs/userguide/developer-guide.rst b/docs/userguide/developer-guide.rst index 3f8112244..be73f59c7 100644 --- a/docs/userguide/developer-guide.rst +++ b/docs/userguide/developer-guide.rst @@ -1,4 +1,3 @@ -.. This work is a derivative of https://wiki.onap.org/display/DW/Running+Blueprints+Processor+Microservice+in+an+IDE .. This work is licensed under a Creative Commons Attribution 4.0 .. International License. http://creativecommons.org/licenses/by/4.0 .. Copyright (C) 2020 Deutsche Telekom AG. @@ -6,8 +5,30 @@ Developer Guide ================= +Blueprints Processor Microservice: +---------------------------------- + +Micro service to Manage Controller Blueprint Models, such as Resource Dictionary, Service Models, Velocity Templates etc, which will serve service for Controller Design Studio and Controller runtimes. + +This microservice is used to deploy Controller Blueprint Archive file in Run time database. This also helps to test the Valid CBA. + .. toctree:: - :caption: Table of Contents :maxdepth: 1 - running-bp-processor-in-ide \ No newline at end of file + running-bp-processor-in-ide + +Architecture: +~~~~~~~~~~~~~ + +|image0| + +.. |image0| image:: media/blueprintprocessor.jpg + :width: 400pt + + +Testing in local environment: +----------------------------- + +Point your browser to http://localhost:8000/api/v1/execution-service/ping (please note that the port is 8000, not 8080) + +To authenticate, use ccsdkapps/ccsdkapps login user id and password. \ No newline at end of file diff --git a/docs/userguide/media/blueprintprocessor.jpg b/docs/userguide/media/blueprintprocessor.jpg new file mode 100644 index 000000000..429876a13 Binary files /dev/null and b/docs/userguide/media/blueprintprocessor.jpg differ diff --git a/docs/userguide/running-bp-processor-in-ide.rst b/docs/userguide/running-bp-processor-in-ide.rst index d27b9906a..e5ea2b09d 100644 --- a/docs/userguide/running-bp-processor-in-ide.rst +++ b/docs/userguide/running-bp-processor-in-ide.rst @@ -32,8 +32,8 @@ Spin up a Docker container with the database The Blueprints Processor project uses a database to store information about the blueprints and therefore it needs to be online before attempting to run it. -One way to create the database is by using the :file:`docker-compose.yaml` -file present on the distribution module. This database will require a local directory to mount a volume, before running docker-compose remember to create following directory: +One way to create the database is by using the :file:`docker-compose.yaml` file. +This database will require a local directory to mount a volume, before running docker-compose remember to create following directory: .. code-block:: bash @@ -123,7 +123,7 @@ Import the project into the IDE Right-click inside it, at any point, to load the context menu and select create BlueprintProcessorApplication configuration from context: - |imageCreateRunConfigkt| + |imageCreateRunConfigKt| **The following window will open:** -- cgit 1.2.3-korg