summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJakobKrieg <jakob.krieg@bcmsolutions.de>2020-12-01 14:17:11 +0100
committerJakobKrieg <jakob.krieg@bcmsolutions.de>2020-12-01 14:17:24 +0100
commitb7beaee4f6759c1c5997713901f6f5a1dfdb1d2d (patch)
tree1363e3e20a79c296a45fb10e916d0490bb9fefb6
parentd0479b3a0d9e672538b976cf38bee6b885b208b9 (diff)
CDS Read the Docs refactoring
Issue-ID: CCSDK-3011 Change-Id: Id8cff94b104bfa03643eb534e36c2bce8b0b4088 Signed-off-by: JakobKrieg <jakob.krieg@bcmsolutions.de>
-rw-r--r--docs/cba/cba-description.rst41
-rw-r--r--docs/cba/index.rst37
-rw-r--r--docs/index.rst25
-rw-r--r--docs/modelingconcepts/cba.rst37
-rw-r--r--docs/modelingconcepts/index.rst2
-rw-r--r--docs/userguides/design-time-guide/designtime.rst (renamed from docs/userguide/designtime.rst)4
-rw-r--r--docs/userguides/design-time-guide/resourceassignment.rst (renamed from docs/userguide/resourceassignment.rst)0
-rw-r--r--docs/userguides/developer-guide/index.rst (renamed from docs/userguide/developer-guide.rst)9
-rw-r--r--docs/userguides/developer-guide/media/blueprintprocessor.jpg (renamed from docs/userguide/media/blueprintprocessor.jpg)bin63829 -> 63829 bytes
-rw-r--r--docs/userguides/developer-guide/media/build_logs.png (renamed from docs/userguide/media/build_logs.png)bin126733 -> 126733 bytes
-rw-r--r--docs/userguides/developer-guide/media/create_run_config_java.png (renamed from docs/userguide/media/create_run_config_java.png)bin83005 -> 83005 bytes
-rw-r--r--docs/userguides/developer-guide/media/create_run_config_kt.png (renamed from docs/userguide/media/create_run_config_kt.png)bin95597 -> 95597 bytes
-rw-r--r--docs/userguides/developer-guide/media/expand_vm_options.PNG (renamed from docs/userguide/media/expand_vm_options.PNG)bin17547 -> 17547 bytes
-rw-r--r--docs/userguides/developer-guide/media/import_project.png (renamed from docs/userguide/media/import_project.png)bin35239 -> 35239 bytes
-rw-r--r--docs/userguides/developer-guide/media/reimport_maven.png (renamed from docs/userguide/media/reimport_maven.png)bin138930 -> 138930 bytes
-rw-r--r--docs/userguides/developer-guide/media/run_config_java.png (renamed from docs/userguide/media/run_config_java.png)bin73102 -> 73102 bytes
-rw-r--r--docs/userguides/developer-guide/media/run_config_kt.png (renamed from docs/userguide/media/run_config_kt.png)bin56159 -> 56159 bytes
-rw-r--r--docs/userguides/developer-guide/media/run_config_set_up.png (renamed from docs/userguide/media/run-config-set-up.png)bin45625 -> 45625 bytes
-rw-r--r--docs/userguides/developer-guide/media/run_debug.png (renamed from docs/userguide/media/run_debug.png)bin4509 -> 4509 bytes
-rw-r--r--docs/userguides/developer-guide/media/vsc_logs.png (renamed from docs/userguide/media/vsc_logs.png)bin161184 -> 161184 bytes
-rw-r--r--docs/userguides/developer-guide/running-bp-processor-in-ide.rst (renamed from docs/userguide/running-bp-processor-in-ide.rst)6
-rw-r--r--docs/userguides/installation.rst (renamed from docs/userguide/installation.rst)0
22 files changed, 71 insertions, 90 deletions
diff --git a/docs/cba/cba-description.rst b/docs/cba/cba-description.rst
new file mode 100644
index 000000000..08702fbce
--- /dev/null
+++ b/docs/cba/cba-description.rst
@@ -0,0 +1,41 @@
+.. This work is licensed under a Creative Commons Attribution 4.0
+.. International License. http://creativecommons.org/licenses/by/4.0
+.. Copyright (C) 2019 IBM.
+
+
+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, comprised of the following folder structure, the files may vary:
+
+.. code-block language is required for ReadTheDocs to render code-blocks. Python set as default.
+
+.. code-block:: python
+
+ ├── Definitions
+ │ ├── blueprint.json Overall TOSCA service template (workflow + node_template)
+ │ ├── artifact_types.json (generated by enrichment)
+ │ ├── data_types.json (generated by enrichment)
+ │ ├── policy_types.json (generated by enrichment)
+ │ ├── node_types.json (generated by enrichment)
+ │ ├── relationship_types.json (generated by enrichment)
+ │ ├── resources_definition_types.json (generated by enrichment, based on Data Dictionaries)
+ │ └── *-mapping.json One per Template
+ │
+ ├── Environments Contains *.properties files as required by the service
+ │
+ ├── Plans Contains Directed Graph
+ │
+ ├── Tests Contains uat.yaml file for testing cba actions within a cba package
+ │
+ ├── Scripts Contains scripts
+ │ ├── python Python scripts
+ │ └── kotlin Kotlin scripts
+ │
+ ├── TOSCA-Metadata
+ │ └── TOSCA.meta Meta-data of overall package
+ │
+ └── Templates Contains combination of mapping and template
+
+To process a CBA for any service we need to enrich it first. This will gather all the node- type, data-type,
+artifact-type, data-dictionary definitions provided in the blueprint.json.
diff --git a/docs/cba/index.rst b/docs/cba/index.rst
index 70ed2aef8..62eb92717 100644
--- a/docs/cba/index.rst
+++ b/docs/cba/index.rst
@@ -11,43 +11,8 @@ Controller Blueprint Archived Designer Tool (CBA)
Introduction
------------
-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, comprised of the following folder structure, the files may vary:
-
-.. code-block language is required for ReadTheDocs to render code-blocks. Python set as default.
-
-.. code-block:: python
-
- ├── Definitions
- │ ├── blueprint.json Overall TOSCA service template (workflow + node_template)
- │ ├── artifact_types.json (generated by enrichment)
- │ ├── data_types.json (generated by enrichment)
- │ ├── policy_types.json (generated by enrichment)
- │ ├── node_types.json (generated by enrichment)
- │ ├── relationship_types.json (generated by enrichment)
- │ ├── resources_definition_types.json (generated by enrichment, based on Data Dictionaries)
- │ └── *-mapping.json One per Template
- │
- ├── Environments Contains *.properties files as required by the service
- │
- ├── Plans Contains Directed Graph
- │
- ├── Tests Contains uat.yaml file for testing cba actions within a cba package
- │
- ├── Scripts Contains scripts
- │ ├── python Python scripts
- │ └── kotlin Kotlin scripts
- │
- ├── TOSCA-Metadata
- │ └── TOSCA.meta Meta-data of overall package
- │
- └── Templates Contains combination of mapping and template
-
-To process a CBA for any service we need to enrich it first. This will gather all the node- type, data-type,
-artifact-type, data-dictionary definitions provided in the blueprint.json.
+.. include:: cba-description.rst
Architecture
------------
diff --git a/docs/index.rst b/docs/index.rst
index af25a5940..ef2d94f91 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -12,13 +12,14 @@ CONTROLLER DESIGN STUDIO (CDS)
Introduction
------------
- The system is designed to be self service, which means that users, not just
+
+The system is designed to be self service, which means that users, not just
programmers, can reconfigure the software system as needed to meet customer
requirements. To accomplish this goal, the system is built around models that
provide for real-time changes in how the system operates. Users merely need
to change a model to change how a service operates.
- Self service is a completely new way of delivering services. It removes the
+Self service is a completely new way of delivering services. It removes the
dependence on code releases and the delays they cause and puts the control of
services into the hands of the service providers. They can change a model and
its parameters and create a new service without writing a single line of code.
@@ -27,18 +28,19 @@ deliver products that more closely match the needs of its customers.
Architecture
------------
+
The Controller Design Studio is composed of two major components:
* The GUI (or frontend)
* The Run Time (or backend)
- The GUI handles direct user input and allows for displaying both design time
+The GUI handles direct user input and allows for displaying both design time
and run time activities. For design time, it allows for the creation of
controller blueprint, from selecting the DGs to be included, to incorporating
the artifact templates, to adding necessary components. For run time, it
allows the user to direct the system to resolve the unresolved elements of the
controller blueprint and download the resulting configuration into a VNF.
- At a more basic level, it allows for creation of data dictionaries,
+At a more basic level, it allows for creation of data dictionaries,
capabilities catalogs, and controller blueprint, the basic elements that are
used to generate a configuration. The essential function of the Controller
Design Studio is to create and populate a controller blueprint, create a
@@ -51,11 +53,11 @@ configuration file (configlet) to a VNF/PNF.
Modeling Concept
----------------
- In Dublin release, the CDS community has contributed a framework to automate
+In Dublin release, the CDS community has contributed a framework to automate
the resolution of resources for instantiation and any config provisioning
operation, such as day0, day1 or day2 configuration.
- The content of the CBA Package is driven from a catalog of reusable data
+The content of the CBA Package is driven from a catalog of reusable data
dictionary, component and workflow, delivering a reusable and simplified
self service experience.
@@ -105,15 +107,16 @@ Library
.. |cdsArchitectureImage| image:: media/CDS_architecture.jpg
:width: 500pt
-User Guide
-----------
+User Guides
+------------
.. toctree::
:maxdepth: 3
- userguide/developer-guide
- userguide/installation
- userguide/designtime
+ userguides/developer-guide/index
+ userguides/installation
+ userguides/design-time-guide/designtime
+ userguides/resourceassignment
Use Cases
---------
diff --git a/docs/modelingconcepts/cba.rst b/docs/modelingconcepts/cba.rst
index 41baa9924..a352e760a 100644
--- a/docs/modelingconcepts/cba.rst
+++ b/docs/modelingconcepts/cba.rst
@@ -9,39 +9,4 @@
Controller Blueprint Archive (.cba)
-----------------------------------
-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, comprised of the following folder structure, the files may vary:
-
-.. code-block language is required for ReadTheDocs to render code-blocks. Python set as default.
-
-.. code-block:: python
-
- ├── Definitions
- │ ├── blueprint.json Overall TOSCA service template (workflow + node_template)
- │ ├── artifact_types.json (generated by enrichment)
- │ ├── data_types.json (generated by enrichment)
- │ ├── policy_types.json (generated by enrichment)
- │ ├── node_types.json (generated by enrichment)
- │ ├── relationship_types.json (generated by enrichment)
- │ ├── resources_definition_types.json (generated by enrichment, based on Data Dictionaries)
- │ └── *-mapping.json One per Template
- │
- ├── Environments Contains *.properties files as required by the service
- │
- ├── Plans Contains Directed Graph
- │
- ├── Tests Contains uat.yaml file for testing cba actions within a cba package
- │
- ├── Scripts Contains scripts
- │ ├── python Python scripts
- │ └── kotlin Kotlin scripts
- │
- ├── TOSCA-Metadata
- │ └── TOSCA.meta Meta-data of overall package
- │
- └── Templates Contains combination of mapping and template
-
-To process a CBA for any service we need to enrich it first. This will gather all the node- type, data-type,
-artifact-type, data-dictionary definitions provided in the blueprint.json. \ No newline at end of file
+.. include:: ../cba/cba-description.rst \ No newline at end of file
diff --git a/docs/modelingconcepts/index.rst b/docs/modelingconcepts/index.rst
index d8ea3de4b..a7099954c 100644
--- a/docs/modelingconcepts/index.rst
+++ b/docs/modelingconcepts/index.rst
@@ -27,6 +27,8 @@ Most of the TOSCA modeled entity presented in the bellow documentation
can be found
`here <https://github.com/onap/ccsdk-cds/tree/master/components/model-catalog/definition-type/starter-type>`_.
+
+
.. toctree::
:caption: Table of Contents
:maxdepth: 1
diff --git a/docs/userguide/designtime.rst b/docs/userguides/design-time-guide/designtime.rst
index 805cfa89c..52b6e55b9 100644
--- a/docs/userguide/designtime.rst
+++ b/docs/userguides/design-time-guide/designtime.rst
@@ -45,6 +45,6 @@ Services:
.. toctree::
:maxdepth: 2
- ../cba/index
- ../resourcedefinition/index
+ ../../cba/index
+ ../../resourcedefinition/index
resourceassignment
diff --git a/docs/userguide/resourceassignment.rst b/docs/userguides/design-time-guide/resourceassignment.rst
index aa4f6b559..aa4f6b559 100644
--- a/docs/userguide/resourceassignment.rst
+++ b/docs/userguides/design-time-guide/resourceassignment.rst
diff --git a/docs/userguide/developer-guide.rst b/docs/userguides/developer-guide/index.rst
index be73f59c7..129ff7cd6 100644
--- a/docs/userguide/developer-guide.rst
+++ b/docs/userguides/developer-guide/index.rst
@@ -5,7 +5,7 @@
Developer Guide
=================
-Blueprints Processor Microservice:
+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.
@@ -13,11 +13,12 @@ Micro service to Manage Controller Blueprint Models, such as Resource Dictionary
This microservice is used to deploy Controller Blueprint Archive file in Run time database. This also helps to test the Valid CBA.
.. toctree::
+ :caption: Guide how to run Blueprint Processor in an IDE:
:maxdepth: 1
running-bp-processor-in-ide
-Architecture:
+Architecture
~~~~~~~~~~~~~
|image0|
@@ -26,8 +27,8 @@ Architecture:
:width: 400pt
-Testing in local environment:
------------------------------
+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)
diff --git a/docs/userguide/media/blueprintprocessor.jpg b/docs/userguides/developer-guide/media/blueprintprocessor.jpg
index 429876a13..429876a13 100644
--- a/docs/userguide/media/blueprintprocessor.jpg
+++ b/docs/userguides/developer-guide/media/blueprintprocessor.jpg
Binary files differ
diff --git a/docs/userguide/media/build_logs.png b/docs/userguides/developer-guide/media/build_logs.png
index 558fd60a8..558fd60a8 100644
--- a/docs/userguide/media/build_logs.png
+++ b/docs/userguides/developer-guide/media/build_logs.png
Binary files differ
diff --git a/docs/userguide/media/create_run_config_java.png b/docs/userguides/developer-guide/media/create_run_config_java.png
index 5d006e2ac..5d006e2ac 100644
--- a/docs/userguide/media/create_run_config_java.png
+++ b/docs/userguides/developer-guide/media/create_run_config_java.png
Binary files differ
diff --git a/docs/userguide/media/create_run_config_kt.png b/docs/userguides/developer-guide/media/create_run_config_kt.png
index 566ff609c..566ff609c 100644
--- a/docs/userguide/media/create_run_config_kt.png
+++ b/docs/userguides/developer-guide/media/create_run_config_kt.png
Binary files differ
diff --git a/docs/userguide/media/expand_vm_options.PNG b/docs/userguides/developer-guide/media/expand_vm_options.PNG
index 9cb98d3f9..9cb98d3f9 100644
--- a/docs/userguide/media/expand_vm_options.PNG
+++ b/docs/userguides/developer-guide/media/expand_vm_options.PNG
Binary files differ
diff --git a/docs/userguide/media/import_project.png b/docs/userguides/developer-guide/media/import_project.png
index ce7eb3ac5..ce7eb3ac5 100644
--- a/docs/userguide/media/import_project.png
+++ b/docs/userguides/developer-guide/media/import_project.png
Binary files differ
diff --git a/docs/userguide/media/reimport_maven.png b/docs/userguides/developer-guide/media/reimport_maven.png
index bc49b3dc8..bc49b3dc8 100644
--- a/docs/userguide/media/reimport_maven.png
+++ b/docs/userguides/developer-guide/media/reimport_maven.png
Binary files differ
diff --git a/docs/userguide/media/run_config_java.png b/docs/userguides/developer-guide/media/run_config_java.png
index 4da5d7f34..4da5d7f34 100644
--- a/docs/userguide/media/run_config_java.png
+++ b/docs/userguides/developer-guide/media/run_config_java.png
Binary files differ
diff --git a/docs/userguide/media/run_config_kt.png b/docs/userguides/developer-guide/media/run_config_kt.png
index 4e88d2d0a..4e88d2d0a 100644
--- a/docs/userguide/media/run_config_kt.png
+++ b/docs/userguides/developer-guide/media/run_config_kt.png
Binary files differ
diff --git a/docs/userguide/media/run-config-set-up.png b/docs/userguides/developer-guide/media/run_config_set_up.png
index 3c2e5fb4f..3c2e5fb4f 100644
--- a/docs/userguide/media/run-config-set-up.png
+++ b/docs/userguides/developer-guide/media/run_config_set_up.png
Binary files differ
diff --git a/docs/userguide/media/run_debug.png b/docs/userguides/developer-guide/media/run_debug.png
index 3aa90577f..3aa90577f 100644
--- a/docs/userguide/media/run_debug.png
+++ b/docs/userguides/developer-guide/media/run_debug.png
Binary files differ
diff --git a/docs/userguide/media/vsc_logs.png b/docs/userguides/developer-guide/media/vsc_logs.png
index 886d1b3c5..886d1b3c5 100644
--- a/docs/userguide/media/vsc_logs.png
+++ b/docs/userguides/developer-guide/media/vsc_logs.png
Binary files differ
diff --git a/docs/userguide/running-bp-processor-in-ide.rst b/docs/userguides/developer-guide/running-bp-processor-in-ide.rst
index 3cbcc18b1..ab6ae2314 100644
--- a/docs/userguide/running-bp-processor-in-ide.rst
+++ b/docs/userguides/developer-guide/running-bp-processor-in-ide.rst
@@ -26,6 +26,10 @@ In the checked out directory, type
mvn clean install -Pq -Dadditionalparam=-Xdoclint:none
+.. note::
+ If an error ``invalid flag: --release`` appears when executing the maven install command, you need to upgrade Java version of your local
+ Maven installation. Use something like ``export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64``.
+
Wait for the maven install command to finish until you go further.
Spin up a Docker container with the database
@@ -419,6 +423,6 @@ Compilation error?
:width: 500pt
:align: middle
-.. |imageRunConfigSetUp| image:: media/run-config-set-up.png
+.. |imageRunConfigSetUp| image:: media/run_config_set_up.png
:width: 500pt
:align: middle
diff --git a/docs/userguide/installation.rst b/docs/userguides/installation.rst
index 10997294c..10997294c 100644
--- a/docs/userguide/installation.rst
+++ b/docs/userguides/installation.rst