summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSingal, Kapil (ks220y) <ks220y@att.com>2020-10-19 10:00:59 -0400
committerSingal, Kapil (ks220y) <ks220y@att.com>2020-10-19 10:32:56 -0400
commit83c0cd2c078f89a386701b7f8e680fd3fc70ecfd (patch)
treeb2805322de93e7ea4c6a2bbe911cf07678cf280b
parent75946c76fe61ff7f773288335eea314efa245fad (diff)
Refactoring docs
Issue-ID: CCSDK-2916 Signed-off-by: Singal, Kapil (ks220y) <ks220y@att.com> Change-Id: Ide8d830bc5cfe223752f81b35d2f09a5759f5aa2
-rw-r--r--docs/index.rst2
-rw-r--r--docs/microservices/blueprintsProcessorMS.rst87
-rw-r--r--docs/microservices/controllerBlueprintMS.rst21
-rw-r--r--docs/microservices/dynamicapi.rst23
-rw-r--r--docs/microservices/enrichment.rst33
-rw-r--r--docs/microservices/media/Enrichment-REST.pngbin156586 -> 0 bytes
-rw-r--r--docs/microservices/media/Enrichment-UI1.pngbin42383 -> 0 bytes
-rw-r--r--docs/microservices/media/Enrichment-UI2.pngbin109402 -> 0 bytes
-rw-r--r--docs/microservices/media/dyanmicapi.jpgbin118101 -> 0 bytes
-rw-r--r--docs/microservices/workflow.rst69
-rw-r--r--docs/userguide/developer-guide.rst27
-rw-r--r--docs/userguide/media/blueprintprocessor.jpg (renamed from docs/microservices/media/blueprintprocessor.jpg)bin63829 -> 63829 bytes
-rw-r--r--docs/userguide/running-bp-processor-in-ide.rst6
13 files changed, 27 insertions, 241 deletions
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
--- a/docs/microservices/media/Enrichment-REST.png
+++ /dev/null
Binary files differ
diff --git a/docs/microservices/media/Enrichment-UI1.png b/docs/microservices/media/Enrichment-UI1.png
deleted file mode 100644
index 082af6128..000000000
--- a/docs/microservices/media/Enrichment-UI1.png
+++ /dev/null
Binary files differ
diff --git a/docs/microservices/media/Enrichment-UI2.png b/docs/microservices/media/Enrichment-UI2.png
deleted file mode 100644
index 90be708b5..000000000
--- a/docs/microservices/media/Enrichment-UI2.png
+++ /dev/null
Binary files differ
diff --git a/docs/microservices/media/dyanmicapi.jpg b/docs/microservices/media/dyanmicapi.jpg
deleted file mode 100644
index 5cc1ae176..000000000
--- a/docs/microservices/media/dyanmicapi.jpg
+++ /dev/null
Binary files 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/microservices/media/blueprintprocessor.jpg b/docs/userguide/media/blueprintprocessor.jpg
index 429876a13..429876a13 100644
--- a/docs/microservices/media/blueprintprocessor.jpg
+++ b/docs/userguide/media/blueprintprocessor.jpg
Binary files 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:**