diff options
author | 2023-03-24 11:26:41 +0000 | |
---|---|---|
committer | 2023-03-31 07:11:10 +0000 | |
commit | 5705086df021779c9e15f08ae12e29f3db161294 (patch) | |
tree | ec2e1075ccde3d572cca37e534843f3eae30c3b9 /docs | |
parent | 36128a2e16e5eac1dd47ff36e2e2d4d17586e60f (diff) |
Fix doc-rules job and cds-ui build
- Doc changes to satisfy new doc-rules
- Fixo f CDS-UI build
Issue-ID: CCSDK-3859
Signed-off-by: Lukasz Rajewski <lukasz.rajewski@t-mobile.pl>
Change-Id: I9471e845afd39d06466da9a5db8fde5acdf15ea1
(cherry picked from commit 4d906e5210c570678bba6db82d85b16ff2ebaaf8)
Diffstat (limited to 'docs')
-rw-r--r-- | docs/api-reference/bp-processor.rst | 10 | ||||
-rw-r--r-- | docs/api-reference/media/api-doc-template.txt (renamed from docs/api-reference/api-doc-template.rst) | 3 | ||||
-rw-r--r-- | docs/api-reference/media/cds-bp-processor-api-swagger.json | 292 | ||||
-rw-r--r-- | docs/cba/cba-description.rst | 2 | ||||
-rw-r--r-- | docs/index.rst | 2 | ||||
-rw-r--r-- | docs/modelingconcepts/artifact-type.rst | 12 | ||||
-rw-r--r-- | docs/modelingconcepts/data-dictionary.rst | 4 | ||||
-rw-r--r-- | docs/modelingconcepts/data-type.rst | 4 | ||||
-rw-r--r-- | docs/modelingconcepts/expression.rst | 10 | ||||
-rw-r--r-- | docs/modelingconcepts/external-system.rst | 15 | ||||
-rw-r--r-- | docs/modelingconcepts/node-type.rst | 26 | ||||
-rw-r--r-- | docs/modelingconcepts/tosca-meta.rst | 12 | ||||
-rw-r--r-- | docs/modelingconcepts/workflow.rst | 7 | ||||
-rw-r--r-- | docs/release-notes.rst | 9 | ||||
-rw-r--r-- | docs/tox.ini | 4 | ||||
-rw-r--r-- | docs/ui/hello-world-resource-resolution-cba.rst | 61 | ||||
-rw-r--r-- | docs/userguides/developer-guide/running-bp-processor-in-ide.rst | 4 |
17 files changed, 292 insertions, 185 deletions
diff --git a/docs/api-reference/bp-processor.rst b/docs/api-reference/bp-processor.rst index eb29b093c..efb56b117 100644 --- a/docs/api-reference/bp-processor.rst +++ b/docs/api-reference/bp-processor.rst @@ -11,7 +11,7 @@ Introduction This section shows all resources and endpoints which CDS BP processor currently provides through a swagger file which is automatically created during CDS build process by Swagger Maven Plugin. A corresponding Postman collection is also included. Endpoints can also be described using this template -:download:`api-doc-template.rst <api-doc-template.rst>` but this is not the preferred way to describe the CDS API. +:download:`api-doc-template.rst <media/api-doc-template.txt>` but this is not the preferred way to describe the CDS API. You can find a sample workflow tutorial :ref:`below <workflow-tutorial>` which will show how to use the endpoints in the right order. This will give you a better understanding of the CDS Blueprint Processor API. @@ -83,9 +83,6 @@ HTTP Status 202 OK "mappings": { "dispatcherHandlers": { "webHandler": [ - - ... - { "predicate": "{GET /api/v1/blueprint-model, produces [application/json]}", "handler": "org.onap.ccsdk.cds.blueprintsprocessor.designer.api.BlueprintModelController#allBlueprintModel()", @@ -144,9 +141,6 @@ HTTP Status 202 OK } } } - - ... - ] } }, @@ -247,4 +241,4 @@ Take care that the last step will fail if you don't have a netconf server set up :width: 500pt .. |saveResponseImage| image:: media/save-response-postman.png - :width: 500pt
\ No newline at end of file + :width: 500pt diff --git a/docs/api-reference/api-doc-template.rst b/docs/api-reference/media/api-doc-template.txt index a0dc0cec5..a983a8cfe 100644 --- a/docs/api-reference/api-doc-template.rst +++ b/docs/api-reference/media/api-doc-template.txt @@ -175,9 +175,6 @@ Related topics .. toctree:: :maxdepth: 1 - topic1 - topic2 - Method 2 Endpoint 1 ~~~~~~~~~~~~~~~~~~~~ diff --git a/docs/api-reference/media/cds-bp-processor-api-swagger.json b/docs/api-reference/media/cds-bp-processor-api-swagger.json index 606d0b861..de7e94c6a 100644 --- a/docs/api-reference/media/cds-bp-processor-api-swagger.json +++ b/docs/api-reference/media/cds-bp-processor-api-swagger.json @@ -998,32 +998,6 @@ } } }, - "/api/v1/model-type/" : { - "post" : { - "tags" : [ "Model Type Catalog" ], - "summary" : "Save a model type", - "description" : "Save a model type by model type definition provided.", - "operationId" : "ModelTypeController_saveModelType_POST.org.onap.ccsdk.cds.blueprintsprocessor.designer.api", - "consumes" : [ "application/json" ], - "produces" : [ "application/json" ], - "parameters" : [ { - "in" : "body", - "name" : "body", - "required" : false, - "schema" : { - "$ref" : "#/definitions/ModelType" - } - } ], - "responses" : { - "200" : { - "description" : "successful operation", - "schema" : { - "$ref" : "#/definitions/ModelType" - } - } - } - } - }, "/api/v1/model-type/by-definition/{definitionType}" : { "get" : { "tags" : [ "Model Type Catalog" ], @@ -1179,7 +1153,7 @@ "tags" : [ "Resources" ], "summary" : "Delete resources using resolution key", "description" : "Delete all the resources associated to a resolution-key using blueprint metadata, artifact name and the resolution-key.", - "operationId" : "ResourceController_deleteByBlueprintNameAndBlueprintVersionAndArtifactNameAndResolutionKey_DELETE.org.onap.ccsdk.cds.blueprintsprocessor.resource.api", + "operationId" : "ResourceController_deleteResolutions_DELETE.org.onap.ccsdk.cds.blueprintsprocessor.resource.api", "produces" : [ "application/json" ], "parameters" : [ { "name" : "bpName", @@ -1203,14 +1177,106 @@ "name" : "resolutionKey", "in" : "query", "description" : "Resolution Key associated with the resolution", + "required" : false, + "type" : "string" + }, { + "name" : "resourceType", + "in" : "query", + "description" : "resourceType associated with the resolution, must be used with resourceId", + "required" : false, + "type" : "string" + }, { + "name" : "resourceId", + "in" : "query", + "description" : "Resolution Key associated with the resolution, must be used with resourceType", + "required" : false, + "type" : "string" + }, { + "name" : "lastN", + "in" : "query", + "description" : "Only delete last N occurrences", + "required" : false, + "type" : "integer", + "format" : "int32" + } ], + "responses" : { + "200" : { + "description" : "successful operation", + "schema" : { + "type" : "object" + } + } + } + } + }, + "/api/v1/resources/occurrences" : { + "get" : { + "tags" : [ "Resources" ], + "summary" : "Get the map of resolved resources with 'occurrence' as the keys to the resolved resources ", + "description" : "With optional 'occurrence' options, subset of stored resolved resources can be retrieved using the blueprint name, blueprint version, artifact name and the resolution-key.", + "operationId" : "ResourceController_getOccurrences_GET.org.onap.ccsdk.cds.blueprintsprocessor.resource.api", + "produces" : [ "application/json" ], + "parameters" : [ { + "name" : "bpName", + "in" : "query", + "description" : "Name of the CBA.", "required" : true, "type" : "string" + }, { + "name" : "bpVersion", + "in" : "query", + "description" : "Version of the CBA.", + "required" : true, + "type" : "string" + }, { + "name" : "artifactName", + "in" : "query", + "description" : "Artifact name for which to retrieve a resolved resource.", + "required" : true, + "type" : "string" + }, { + "name" : "resolutionKey", + "in" : "query", + "description" : "Resolution Key associated with the resolution.", + "required" : true, + "type" : "string" + }, { + "name" : "firstN", + "in" : "query", + "description" : "Number of earlier N occurrences of the resolutions.", + "required" : false, + "type" : "integer", + "format" : "int32" + }, { + "name" : "lastN", + "in" : "query", + "description" : "Number of latest N occurrences of the resolutions.", + "required" : false, + "type" : "integer", + "format" : "int32" + }, { + "name" : "begin", + "in" : "query", + "description" : "For Range option - 'begin' is the start occurrence of range of the resolutions.", + "required" : false, + "type" : "integer", + "format" : "int32" + }, { + "name" : "end", + "in" : "query", + "description" : "For Range option - 'end' is the end occurrence of the range of the resolutions.", + "required" : false, + "type" : "integer", + "format" : "int32" } ], "responses" : { "200" : { "description" : "successful operation", "schema" : { - "$ref" : "#/definitions/Unit" + "type" : "array", + "items" : { + "$ref" : "#/definitions/ResourceResolution" + } } } } @@ -1258,7 +1324,80 @@ "200" : { "description" : "successful operation", "schema" : { - "$ref" : "#/definitions/ResourceResolution" + "type" : "object" + } + } + } + } + }, + "/api/v1/template/occurrences" : { + "get" : { + "tags" : [ "Resource template" ], + "summary" : "Get the map of resolved templates with 'occurrence' as the keys to the resolved templates ", + "description" : "With optional 'occurrence' options, subset of stored resolved templates can be retrieved using the blueprint name, blueprint version, artifact name and the resolution-key.", + "operationId" : "TemplateController_getOccurrences_GET.org.onap.ccsdk.cds.blueprintsprocessor.resource.api", + "produces" : [ "application/json" ], + "parameters" : [ { + "name" : "bpName", + "in" : "query", + "description" : "Name of the CBA.", + "required" : true, + "type" : "string" + }, { + "name" : "bpVersion", + "in" : "query", + "description" : "Version of the CBA.", + "required" : true, + "type" : "string" + }, { + "name" : "artifactName", + "in" : "query", + "description" : "Artifact name for which to retrieve a resolved resource.", + "required" : true, + "type" : "string" + }, { + "name" : "resolutionKey", + "in" : "query", + "description" : "Resolution Key associated with the resolution.", + "required" : true, + "type" : "string" + }, { + "name" : "firstN", + "in" : "query", + "description" : "Number of earlier N occurrences of the templates.", + "required" : false, + "type" : "integer", + "format" : "int32" + }, { + "name" : "lastN", + "in" : "query", + "description" : "Number of latest N occurrences of the templates.", + "required" : false, + "type" : "integer", + "format" : "int32" + }, { + "name" : "begin", + "in" : "query", + "description" : "For Range option - 'begin' is the start occurrence of range of the templates.", + "required" : false, + "type" : "integer", + "format" : "int32" + }, { + "name" : "end", + "in" : "query", + "description" : "For Range option - 'end' is the end occurrence of the range of the templates.", + "required" : false, + "type" : "integer", + "format" : "int32" + } ], + "responses" : { + "200" : { + "description" : "successful operation", + "schema" : { + "type" : "array", + "items" : { + "$ref" : "#/definitions/TemplateResolution" + } } } } @@ -1612,19 +1751,13 @@ "JsonNode" : { "type" : "object", "properties" : { - "array" : { - "type" : "boolean" - }, - "null" : { - "type" : "boolean" - }, "float" : { "type" : "boolean" }, - "bigInteger" : { + "array" : { "type" : "boolean" }, - "bigDecimal" : { + "null" : { "type" : "boolean" }, "valueNode" : { @@ -1655,25 +1788,31 @@ "type" : "string", "enum" : [ "ARRAY", "BINARY", "BOOLEAN", "MISSING", "NULL", "NUMBER", "OBJECT", "POJO", "STRING" ] }, + "object" : { + "type" : "boolean" + }, "number" : { "type" : "boolean" }, - "binary" : { + "bigDecimal" : { "type" : "boolean" }, - "boolean" : { + "bigInteger" : { "type" : "boolean" }, "double" : { "type" : "boolean" }, + "long" : { + "type" : "boolean" + }, "int" : { "type" : "boolean" }, - "long" : { + "boolean" : { "type" : "boolean" }, - "object" : { + "binary" : { "type" : "boolean" } } @@ -1839,6 +1978,13 @@ "type" : "integer", "format" : "int64" }, + "number" : { + "type" : "integer", + "format" : "int32" + }, + "sort" : { + "$ref" : "#/definitions/Sort" + }, "size" : { "type" : "integer", "format" : "int32" @@ -1849,12 +1995,11 @@ "type" : "object" } }, - "number" : { - "type" : "integer", - "format" : "int32" + "first" : { + "type" : "boolean" }, - "sort" : { - "$ref" : "#/definitions/Sort" + "last" : { + "type" : "boolean" }, "pageable" : { "$ref" : "#/definitions/Pageable" @@ -1863,12 +2008,6 @@ "type" : "integer", "format" : "int32" }, - "last" : { - "type" : "boolean" - }, - "first" : { - "type" : "boolean" - }, "empty" : { "type" : "boolean" } @@ -1885,6 +2024,13 @@ "type" : "integer", "format" : "int64" }, + "number" : { + "type" : "integer", + "format" : "int32" + }, + "sort" : { + "$ref" : "#/definitions/Sort" + }, "size" : { "type" : "integer", "format" : "int32" @@ -1895,12 +2041,11 @@ "$ref" : "#/definitions/BlueprintModelSearch" } }, - "number" : { - "type" : "integer", - "format" : "int32" + "first" : { + "type" : "boolean" }, - "sort" : { - "$ref" : "#/definitions/Sort" + "last" : { + "type" : "boolean" }, "pageable" : { "$ref" : "#/definitions/Pageable" @@ -1909,12 +2054,6 @@ "type" : "integer", "format" : "int32" }, - "last" : { - "type" : "boolean" - }, - "first" : { - "type" : "boolean" - }, "empty" : { "type" : "boolean" } @@ -1923,18 +2062,12 @@ "Pageable" : { "type" : "object", "properties" : { - "offset" : { - "type" : "integer", - "format" : "int64" - }, "sort" : { "$ref" : "#/definitions/Sort" }, - "paged" : { - "type" : "boolean" - }, - "unpaged" : { - "type" : "boolean" + "offset" : { + "type" : "integer", + "format" : "int64" }, "pageNumber" : { "type" : "integer", @@ -1943,6 +2076,12 @@ "pageSize" : { "type" : "integer", "format" : "int32" + }, + "paged" : { + "type" : "boolean" + }, + "unpaged" : { + "type" : "boolean" } } }, @@ -2206,13 +2345,13 @@ "Sort" : { "type" : "object", "properties" : { - "unsorted" : { + "empty" : { "type" : "boolean" }, - "sorted" : { + "unsorted" : { "type" : "boolean" }, - "empty" : { + "sorted" : { "type" : "boolean" } } @@ -2265,9 +2404,6 @@ } } }, - "Unit" : { - "type" : "object" - }, "WorkFlowSpecRequest" : { "type" : "object", "required" : [ "blueprintName", "workflowName" ], diff --git a/docs/cba/cba-description.rst b/docs/cba/cba-description.rst index 08702fbce..c6a328bc0 100644 --- a/docs/cba/cba-description.rst +++ b/docs/cba/cba-description.rst @@ -10,7 +10,7 @@ The CBA is **.zip** file, comprised of the following folder structure, the files .. code-block language is required for ReadTheDocs to render code-blocks. Python set as default. -.. code-block:: python +.. code-block:: ├── Definitions │ ├── blueprint.json Overall TOSCA service template (workflow + node_template) diff --git a/docs/index.rst b/docs/index.rst index 62e749342..9e226e537 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -132,6 +132,8 @@ CDS Designer UI :maxdepth: 2 ui/designer-guide + ui/hello-world-resource-resolution-cba + ui/hello-world-script-executor-cba.rst Offered APIs diff --git a/docs/modelingconcepts/artifact-type.rst b/docs/modelingconcepts/artifact-type.rst index 3dda2c4ed..cc4b0dc3e 100644 --- a/docs/modelingconcepts/artifact-type.rst +++ b/docs/modelingconcepts/artifact-type.rst @@ -39,14 +39,14 @@ This node was created, derived from ``tosca.artifacts.Root`` to be the root TOSC File must have **.vtl** extension. The **template** can represent anything, such as device config, payload to interact with 3rd party systems, - :ref:`resource-accumulator template`, etc... + resource-accumulator template, etc... Often a template will be **parameterized**, and each **parameter** must be defined within an mapping file (see 'Mapping' in this tab). `Velocity reference document <http://velocity.apache.org/engine/1.7/user-guide.html>`_ - `Here <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/artifact_type/artifact-template-velocity.json>`_ + `Velocity artifact <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/artifact_type/artifact-template-velocity.json>`_ is the TOSCA artifact type: .. code-block:: json @@ -69,13 +69,13 @@ This node was created, derived from ``tosca.artifacts.Root`` to be the root TOSC File must have **.jinja** extension. The **template** can represent **anything**, such as device config, - payload to interact with 3rd party systems, :ref:`resource-accumulator template`, etc... + payload to interact with 3rd party systems, resource-accumulator template, etc... - Often a template will be parameterized, and each parameter must be defined within an :ref:`mapping file`. + Often a template will be parameterized, and each parameter must be defined within an mapping file. `Jinja reference document <https://jinja.palletsprojects.com/en/2.10.x/>`_ - `Here <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/artifact_type/artifact-template-jinja.json>`_ + `Jinja artifact <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/artifact_type/artifact-template-jinja.json>`_ is the TOSCA artifact type: .. code-block:: json @@ -107,7 +107,7 @@ This node was created, derived from ``tosca.artifacts.Root`` to be the root TOSC The **template** can represent **anything**, such as device config, payload to interact with 3rd party systems, resource-accumulator template, etc... - `Here <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/artifact_type/artifact-mapping-resource.json>`_ + `Mapping artifact <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/artifact_type/artifact-mapping-resource.json>`_ is the TOSCA artifact type: .. code-block:: json diff --git a/docs/modelingconcepts/data-dictionary.rst b/docs/modelingconcepts/data-dictionary.rst index 9f9699a05..0f098d7ef 100644 --- a/docs/modelingconcepts/data-dictionary.rst +++ b/docs/modelingconcepts/data-dictionary.rst @@ -35,7 +35,7 @@ As part of modelling a data dictionary entry, the following generic information - Information related - Mandatory * - sources - - List of resource source instance (see :ref:`resource source`) + - List of resource source instance (see :ref:`node_type`) - Mandatory * - property - Defines type and description, as nested JSON @@ -108,4 +108,4 @@ Here is how input-key-mapping, output-key-mapping and key-dependencies can be us } } } - }
\ No newline at end of file + } diff --git a/docs/modelingconcepts/data-type.rst b/docs/modelingconcepts/data-type.rst index ee5908002..548c2c28c 100644 --- a/docs/modelingconcepts/data-type.rst +++ b/docs/modelingconcepts/data-type.rst @@ -98,7 +98,7 @@ List of existing data type: * - dictionary-name - Reference to the name of the data dictionary (see :ref:`data_dictionary`). * - dictionary-source - - Reference the source to use to resolve the resource (see :ref:`resource source`). + - Reference the source to use to resolve the resource (see :ref:`node_type`). * - dependencies - List of dependencies required to resolve this resource. * - updated-date @@ -215,4 +215,4 @@ List of existing data type: } }, "derived_from": "tosca.datatypes.Root" - }
\ No newline at end of file + } diff --git a/docs/modelingconcepts/expression.rst b/docs/modelingconcepts/expression.rst index 9ce5659dc..59145d26e 100644 --- a/docs/modelingconcepts/expression.rst +++ b/docs/modelingconcepts/expression.rst @@ -23,7 +23,7 @@ TOSCA provides for a set of functions to reference elements within the template Within CDS, this is mainly Workflow inputs. - `TOSCA specification + `TOSCA specification - get_input <http://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.2/csd01/TOSCA-Simple-Profile-YAML-v1.2-csd01.html#_Toc494454178>`_ **Example:** @@ -59,7 +59,7 @@ TOSCA provides for a set of functions to reference elements within the template The **get_attribute** function is used to retrieve the values of named attributes declared by the referenced node or relationship template name. - `TOSCA specification + `TOSCA specification - get_attribute <http://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.2/csd01/TOSCA-Simple-Profile-YAML-v1.2-csd01.html#_Toc494454178>`_ **Example:** @@ -80,7 +80,7 @@ TOSCA provides for a set of functions to reference elements within the template The **get_operation_output** function is used to retrieve the values of variables exposed / exported from an interface operation. - `TOSCA specification + `TOSCA specification - get_operation_output <http://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.2/csd01/TOSCA-Simple-Profile-YAML-v1.2-csd01.html#_Toc494454180>`_ **Example:** @@ -96,11 +96,11 @@ TOSCA provides for a set of functions to reference elements within the template The **get_artifact** function is used to retrieve artifact location between modelable entities defined in the same service template. - `TOSCA specification + `TOSCA specification - get_artifact <http://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.2/csd01/TOSCA-Simple-Profile-YAML-v1.2-csd01.html#_Toc494454182>`_ **Example:** .. code-block:: json - "get_artifact" : ["SELF", "artifact-template", "location", true]
\ No newline at end of file + "get_artifact" : ["SELF", "artifact-template", "location", true] diff --git a/docs/modelingconcepts/external-system.rst b/docs/modelingconcepts/external-system.rst index 598cd451e..120accb94 100644 --- a/docs/modelingconcepts/external-system.rst +++ b/docs/modelingconcepts/external-system.rst @@ -30,7 +30,6 @@ Here are some examples on how to populate the system information within the pack * - .. code-block:: json { - . . . "dsl_definitions": { "ipam-1": { "type": "token-auth", @@ -47,7 +46,6 @@ Here are some examples on how to populate the system information within the pack * - .. code-block:: json { - . . . "dsl_definitions": { "ipam-1": { "type": "basic-auth", @@ -56,7 +54,6 @@ Here are some examples on how to populate the system information within the pack "password": "marley" } } - . . . } .. list-table:: @@ -67,19 +64,17 @@ Here are some examples on how to populate the system information within the pack * - .. code-block:: json { - . . . "dsl_definitions": { "ipam-1": { - "type" : "ssl-basic-auth", - "url" : "http://localhost:32778", + "type": "ssl-basic-auth", + "url": "http://localhost:32778", "keyStoreInstance": "JKS or PKCS12", "sslTrust": "trusture", "sslTrustPassword": "trustore password", "sslKey": "keystore", - "sslKeyPassword: "keystore password" + "sslKeyPassword": "keystore password" } } - . . . } .. list-table:: @@ -90,7 +85,6 @@ Here are some examples on how to populate the system information within the pack * - .. code-block:: json { - . . . "dsl_definitions": { "remote-executor": { "type": "token-auth", @@ -99,7 +93,6 @@ Here are some examples on how to populate the system information within the pack "token": "Basic Y2NzZGthcHBzOmNjc2RrYXBwcw==" } } - . . . } .. list-table:: @@ -109,7 +102,6 @@ Here are some examples on how to populate the system information within the pack * - .. code-block:: json { - . . . "dsl_definitions": { "netprog-db": { "type": "maria-db", @@ -118,5 +110,4 @@ Here are some examples on how to populate the system information within the pack "password": "netprog" } } - . . . } diff --git a/docs/modelingconcepts/node-type.rst b/docs/modelingconcepts/node-type.rst index 034a6b063..98c99a61e 100644 --- a/docs/modelingconcepts/node-type.rst +++ b/docs/modelingconcepts/node-type.rst @@ -22,7 +22,7 @@ listed in the other section. Used to represent a **functionality** along with its **contract**, such as **inputs**, **ouputs**, and **attributes** - `Here <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/tosca.nodes.Component.json>`_ + `Component type <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/tosca.nodes.Component.json>`_ is the root component TOSCA node type from which other node type will derive: .. code-block:: json @@ -51,7 +51,7 @@ listed in the other section. Will put the resolution result as an **attribute** in the workflow context called **assignment-params**. - Using the :ref:`undefined <get_attribute expression>`, this attribute can be retrieve to be + Using the **get_attribute** expression, this attribute can be retrieve to be provided as workflow output (see :ref:`workflow`). **Specify which template to resolve:** @@ -90,7 +90,7 @@ listed in the other section. This feature is useful when you need to apply the same configuration accross network elements. - `Here <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/component-resource-resolution.json>`_ + `Resource resolution <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/component-resource-resolution.json>`_ is the definition: .. code-block:: json @@ -201,7 +201,7 @@ listed in the other section. * for kotlin: the package name up to the class. e.g. com.example.Bob * for python: it has to be the path from the Scripts folder, e.g. Scripts/python/Bob.py - `Here <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/component-script-executor.json>`_ + `Script executor type <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/component-script-executor.json>`_ is the definition .. _test_test_test: @@ -330,7 +330,7 @@ listed in the other section. script that couldn't be passed as an argument, such as JSON object, etc... If used, they will be passed in as the last argument of the Python script. - `Here <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/component-remote-python-executor.json>`_ + `Remote executor type <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/component-remote-python-executor.json>`_ is the definition .. code-block:: json @@ -421,7 +421,7 @@ listed in the other section. TBD - `Here <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/component-remote-ansible-executor.json>`_ + `Ansible executor <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/component-remote-ansible-executor.json>`_ is the definition .. code-block:: json @@ -501,7 +501,7 @@ listed in the other section. Defines the **contract** to resolve a resource. - `Here <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/tosca.nodes.ResourceSource.json>`_ + `Resource source type <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/tosca.nodes.ResourceSource.json>`_ is the root component TOSCA node type from which other node type will derive: .. code-block:: @@ -523,7 +523,7 @@ listed in the other section. Expects the **value to be provided as input** to the request. - `Here <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/source-input.json>`_ + `Input source <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/source-input.json>`_ is the Definition .. code-block:: @@ -542,7 +542,7 @@ listed in the other section. Expects the **value to be defaulted** in the model itself. - `Here <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/source-default.json>`_ + `Default source type <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/source-default.json>`_ is the Definition .. code-block:: json @@ -593,7 +593,7 @@ listed in the other section. - Path expression type - default value is JSON_PATH - Optional - `Here <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/source-rest.json>`_ + `Rest source <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/source-rest.json>`_ is the definition: .. code-block:: json @@ -712,7 +712,7 @@ listed in the other section. - Mandatory - `Here <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/source-processor-db.json>`_ + `DB source type <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/source-processor-db.json>`_ is the definition: .. code-block:: json @@ -786,7 +786,7 @@ listed in the other section. - The name of the class to use to create an instance of the script - Mandatory - `Here <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/source-capability.json>`_ + `Capability source type <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/source-capability.json>`_ is the definition: .. code-block:: json @@ -850,7 +850,7 @@ listed in the other section. - The node template the workflow depends on - Required - `Here <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/dg-generic.json>`_ + `DG source type <https://github.com/onap/ccsdk-cds/blob/master/components/model-catalog/definition-type/starter-type/node_type/dg-generic.json>`_ is the definition: .. code-block:: json diff --git a/docs/modelingconcepts/tosca-meta.rst b/docs/modelingconcepts/tosca-meta.rst index 095defe13..a61d2fbde 100644 --- a/docs/modelingconcepts/tosca-meta.rst +++ b/docs/modelingconcepts/tosca-meta.rst @@ -53,11 +53,11 @@ Tosca meta file captures the model entities that compose the cba package name, v - String - | The attribute that holds the blueprint package types. | Valid Options: - * "DEFAULT" – .JSON file consistent of tosca based cba package that describes the package intent. - * "KOTLIN_DSL" – .KT file consistent of tosca based cba package that describes the package intent - composed using Domain Specific Language (DSL). - * "GENERIC_SCRIPT" – Script file consistent of NONE tosca based cba package that describes the package intent - using DSL Language. + * "DEFAULT" – .JSON file consistent of tosca based cba package that describes the package intent. + * "KOTLIN_DSL" – .KT file consistent of tosca based cba package that describes the package intent + composed using Domain Specific Language (DSL). + * "GENERIC_SCRIPT" – Script file consistent of NONE tosca based cba package that describes the package intent + using DSL Language. | If not specified in the tosca.meta file the default is "DEFAULT" * - Template-Tags - Required @@ -76,4 +76,4 @@ https://git.onap.org/ccsdk/cds/tree/components/model-catalog/blueprint-model/tes **GENERIC_SCRIPT Template Type** -https://git.onap.org/ccsdk/cds/tree/components/model-catalog/blueprint-model/test-blueprint/capability_python/TOSCA-Metadata/TOSCA.meta
\ No newline at end of file +https://git.onap.org/ccsdk/cds/tree/components/model-catalog/blueprint-model/test-blueprint/capability_python/TOSCA-Metadata/TOSCA.meta diff --git a/docs/modelingconcepts/workflow.rst b/docs/modelingconcepts/workflow.rst index 7e21cfe0c..1578c3217 100644 --- a/docs/modelingconcepts/workflow.rst +++ b/docs/modelingconcepts/workflow.rst @@ -42,7 +42,6 @@ which actually is the name of the ``node_template`` defined after, of type ``com .. code-block:: json :caption: **Example** - . . . "topology_template": { "workflows": { "resource-assignment": { @@ -101,7 +100,6 @@ which actually is the name of the ``node_template`` defined after, of type ``com } } } - . . . .. _workflow_multiple_actions: @@ -123,7 +121,6 @@ In the example above, you can see the target of the workflow's steps execute-scr .. code-block:: json :caption: **workflow plan example** - . . . "topology_template": { "workflows": { "execute-remote-ansible": { @@ -268,7 +265,7 @@ Properties of a workflow - value resolvable using :ref:`expression` -> get_attribute * - steps - | Defines the actual step to execute as part of the workflow - | + .. list-table:: :widths: 25 25 50 :header-rows: 1 @@ -284,7 +281,7 @@ Properties of a workflow Example: -.. code-block:: json +.. code-block:: :caption: **workflow example** { diff --git a/docs/release-notes.rst b/docs/release-notes.rst deleted file mode 100644 index 428866a8d..000000000 --- a/docs/release-notes.rst +++ /dev/null @@ -1,9 +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. -.. _release_notes: - -Release-Notes -------------- -.. toctree:: - :maxdepth: 1 diff --git a/docs/tox.ini b/docs/tox.ini index 9856e7032..cb899a23d 100644 --- a/docs/tox.ini +++ b/docs/tox.ini @@ -10,7 +10,7 @@ deps = -chttps://raw.githubusercontent.com/openstack/requirements/stable/yoga/upper-constraints.txt -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=kohn commands = - sphinx-build -q -b html -n -d {envtmpdir}/doctrees {toxinidir} {toxinidir}/_build/html + sphinx-build -q -W -b html -n -d {envtmpdir}/doctrees {toxinidir} {toxinidir}/_build/html #[testenv:docs-linkcheck] #basepython = python3.8 @@ -19,7 +19,7 @@ commands = # -chttps://raw.githubusercontent.com/openstack/requirements/stable/yoga/upper-constraints.txt # -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=kohn #commands = -# sphinx-build -q -b linkcheck -d {envtmpdir}/doctrees {toxinidir} {toxinidir}/_build/linkcheck +# sphinx-build -q -W -b linkcheck -d {envtmpdir}/doctrees {toxinidir} {toxinidir}/_build/linkcheck [testenv:docs-spellcheck] basepython = python3.8 diff --git a/docs/ui/hello-world-resource-resolution-cba.rst b/docs/ui/hello-world-resource-resolution-cba.rst index eceadac3c..2bd32ca3c 100644 --- a/docs/ui/hello-world-resource-resolution-cba.rst +++ b/docs/ui/hello-world-resource-resolution-cba.rst @@ -243,37 +243,36 @@ package, which will resolve the value of the "image_name" resource from the REST .. code-block:: json - 200 OK - { - "correlationUUID": null, - "commonHeader": { - "timestamp": "2020-12-13T11:43:10.993Z", - "originatorId": "SDNC_DG", - "requestId": "e5eb1f1e-3386-435d-b290-d49d8af8db4c", - "subRequestId": "143748f9-3cd5-4910-81c9-a4601ff2ea58", - "flags": null - }, - "actionIdentifiers": { - "blueprintName": "hello_world", - "blueprintVersion": "1.0.0", - "actionName": "Action1", - "mode": "sync" - }, - "status": { - "code": 200, - "eventType": "EVENT_COMPONENT_EXECUTED", - "timestamp": "2020-12-13T11:43:11.028Z", - "errorMessage": null, - "message": "success" - }, - "payload": { - "Action1-response": { - "hello-world-output": { - "hello_world_template": "Hello, Sarah Abouzainah!" - } - } - } - } + { + "correlationUUID": null, + "commonHeader": { + "timestamp": "2020-12-13T11:43:10.993Z", + "originatorId": "SDNC_DG", + "requestId": "e5eb1f1e-3386-435d-b290-d49d8af8db4c", + "subRequestId": "143748f9-3cd5-4910-81c9-a4601ff2ea58", + "flags": null + }, + "actionIdentifiers": { + "blueprintName": "hello_world", + "blueprintVersion": "1.0.0", + "actionName": "Action1", + "mode": "sync" + }, + "status": { + "code": 200, + "eventType": "EVENT_COMPONENT_EXECUTED", + "timestamp": "2020-12-13T11:43:11.028Z", + "errorMessage": null, + "message": "success" + }, + "payload": { + "Action1-response": { + "hello-world-output": { + "hello_world_template": "Hello, Sarah Abouzainah!" + } + } + } + } Screenshot from POSTMAN showing how to run the hello_world package, and the CDS Response: diff --git a/docs/userguides/developer-guide/running-bp-processor-in-ide.rst b/docs/userguides/developer-guide/running-bp-processor-in-ide.rst index e31246b01..f2a2a59d2 100644 --- a/docs/userguides/developer-guide/running-bp-processor-in-ide.rst +++ b/docs/userguides/developer-guide/running-bp-processor-in-ide.rst @@ -312,7 +312,7 @@ Import the project into the IDE **Add/replace the following in Blueprint's application-dev.properties file:** - .. code-block:: java + .. code-block:: blueprintsprocessor.grpcclient.remote-python.type=token-auth blueprintsprocessor.grpcclient.remote-python.host=localhost @@ -323,7 +323,7 @@ Import the project into the IDE **Currently the following entries need to be added in VSC too:** - .. code-block:: java + .. code-block:: logging.level.web=DEBUG logging.level.org.springframework.web: DEBUG |