summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorshangxdy <shang.xiaodong@zte.com.cn>2017-03-11 01:08:53 +0800
committershangxdy <shang.xiaodong@zte.com.cn>2017-03-11 01:11:25 +0800
commit61a6e142120e622eb74751c4ff1ba9fa9ffceba4 (patch)
tree038887338cdbdd27d406813701c5b529e5b07e8b /docs
parent9c41f06b30811b8f2d21a3fb5032ad5f2ecb2682 (diff)
Add apigateway docs
Add documents for apigateway. JIRA:PARSER-123 Change-Id: Ibe8ebd6e3a3f62d58d8da0da4d9be8ceb673fb7b Signed-off-by: shangxdy <shang.xiaodong@zte.com.cn>
Diffstat (limited to 'docs')
-rw-r--r--docs/developer/design/apigateway.rst38
-rw-r--r--docs/developer/design/images/API_gateway_architecture.pngbin0 -> 323213 bytes
-rw-r--r--docs/developer/design/index.rst1
-rw-r--r--docs/developer/design/policy2tosca.rst4
-rw-r--r--docs/developer/design/tosca2heat.rst4
-rw-r--r--docs/developer/design/verigraph.rst4
-rw-r--r--docs/developer/overview/overview.rst8
-rw-r--r--docs/developer/requirements/parser_requirement_arno_release.rst2
-rw-r--r--docs/release/installation/installation.instruction.rst36
-rw-r--r--docs/release/release-notes/release-notes.rst24
10 files changed, 102 insertions, 19 deletions
diff --git a/docs/developer/design/apigateway.rst b/docs/developer/design/apigateway.rst
new file mode 100644
index 0000000..dbeb94d
--- /dev/null
+++ b/docs/developer/design/apigateway.rst
@@ -0,0 +1,38 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+=================
+Parser apigateway
+=================
+
+This document provides a description of apigateway, a message relay submodule for the other
+parser submodules.
+
+.. contents::
+ :depth: 3
+ :local:
+
+Overview
+--------
+Provide unified access interfaces for follow independent parser components:
+ - tosca2heat
+ - yang2tosca
+ - policy2tosca
+ - verigraph
+ - parser ui
+ The apigateway will relay message between above submodules throngh gRPC interface, in additon,
+apigateway also exposes restful api to provide parser all functions to the 3rd applications.
+
+
+Architecture
+------------
+Apigateway exploits three sub-components:
+
+- **APIGW**, the main part of apigateway, which is the message center.
+- **gRPC**, provide gRPC client and server for the other parser sub-modules, it can be devided
+into defferent pair of client/server according to the function.
+- **CLI**, command line tool for apigateway access and management .
+
+Apigateway architecture is shown below:
+
+.. image:: /images/API_gateway_architecture.png
diff --git a/docs/developer/design/images/API_gateway_architecture.png b/docs/developer/design/images/API_gateway_architecture.png
new file mode 100644
index 0000000..7fbaa74
--- /dev/null
+++ b/docs/developer/design/images/API_gateway_architecture.png
Binary files differ
diff --git a/docs/developer/design/index.rst b/docs/developer/design/index.rst
index 0f29a8a..fa13788 100644
--- a/docs/developer/design/index.rst
+++ b/docs/developer/design/index.rst
@@ -15,3 +15,4 @@ OPNFV Parser Design Documentation
yang2tosca.rst
policy2tosca.rst
verigraph.rst
+ apigateway.rst
diff --git a/docs/developer/design/policy2tosca.rst b/docs/developer/design/policy2tosca.rst
index 3753d6c..8dcedad 100644
--- a/docs/developer/design/policy2tosca.rst
+++ b/docs/developer/design/policy2tosca.rst
@@ -1,8 +1,8 @@
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
-===================
+==================
Parser polic2tosca
-===================
+==================
diff --git a/docs/developer/design/tosca2heat.rst b/docs/developer/design/tosca2heat.rst
index d4ead14..3fb1d26 100644
--- a/docs/developer/design/tosca2heat.rst
+++ b/docs/developer/design/tosca2heat.rst
@@ -1,7 +1,7 @@
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
-===================
+=================
Parser tosca2heat
-===================
+=================
diff --git a/docs/developer/design/verigraph.rst b/docs/developer/design/verigraph.rst
index d364091..1362e23 100644
--- a/docs/developer/design/verigraph.rst
+++ b/docs/developer/design/verigraph.rst
@@ -1,9 +1,9 @@
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
-=================
+================
Parser verigraph
-=================
+================
This document provides a description of VeriGraph, a formal verification tool for service graphs.
diff --git a/docs/developer/overview/overview.rst b/docs/developer/overview/overview.rst
index 8baffdd..3ae173a 100644
--- a/docs/developer/overview/overview.rst
+++ b/docs/developer/overview/overview.rst
@@ -10,7 +10,7 @@ OPNFV Parser Danube Overview Doumentation
:local:
Introduction
----------------
+------------
In NFV, various templates (such as descriptors, records and so on) are utilized
to describe the deployment requirements (such as basic VM requirements – vCPU,
@@ -27,7 +27,7 @@ translate TOSCA/CAMP templates into certain common templates, which could be
used in IaaS orchestration projects like OpenStack Heat.
For Arno Release
-------------------------
+----------------
Parser is not one of the Arno Release projects, however the project has established
the code base for the later releases:
@@ -35,7 +35,7 @@ the code base for the later releases:
* Initial documentation on use cases
Upgrades from Arno Release
-------------------------
+--------------------------
For Brahmaputra Release, Parser offers the following additional capabilities:
@@ -59,7 +59,7 @@ For Brahmaputra Release, Parser offers the following additional capabilities:
scenario. See also https://wiki.opnfv.org/parser.
Upgrades from Brahmaputra Release
------------------------
+---------------------------------
For Colorado Release, Parser offers the following additional capabilities:
diff --git a/docs/developer/requirements/parser_requirement_arno_release.rst b/docs/developer/requirements/parser_requirement_arno_release.rst
index 96d1d38..67f812c 100644
--- a/docs/developer/requirements/parser_requirement_arno_release.rst
+++ b/docs/developer/requirements/parser_requirement_arno_release.rst
@@ -10,7 +10,7 @@ OPNFV Parser Requirements In Arno Release
:local:
Use Case Description
----------------
+--------------------
* When Operators want to do automation on utilizing VIM to manage hypervisor
level accelerators which VNFs don't have knowledge of, certain templates
diff --git a/docs/release/installation/installation.instruction.rst b/docs/release/installation/installation.instruction.rst
index de6956a..ae2cbb1 100644
--- a/docs/release/installation/installation.instruction.rst
+++ b/docs/release/installation/installation.instruction.rst
@@ -3,7 +3,7 @@
Parser tosca2heat Installation
-============================
+==============================
Please follow the below installation steps to install tosca2heat submodule in parser.
@@ -81,7 +81,7 @@ Step 3: Change directory to the downloaded directory and run the setup file.
python setup.py
Step 4: install python-lxml
---------------
+---------------------------
Please follow the below installation link. http://lxml.de/installation.html
@@ -131,3 +131,35 @@ Step 2: Go to the verigraph directory.
Step3: Follow the instructions in README.rst for downloading verigraph
dependencies and for installing verigraph.
+
+
+Parser apigateway Installation
+==============================
+
+In the present release, apigateway requires that the following software is also installed:
+
+ - grpcio (https://github.com/golang/protobuf/protoc-gen-go)
+
+Please follow the below installation steps to install apigateway submodule in parser.
+
+Step 1: Clone the parser project.
+
+.. code-block:: bash
+
+ git clone https://gerrit.opnfv.org/gerrit/parser
+
+Step 2: Install the apigateway submodule.
+
+.. code-block:: bash
+
+ # change directory to apigateway
+ cd parser/apigateway
+
+ # install requirements
+ pip install -r requirements.txt
+
+ # install apigateway
+ python setup.py install
+
+**Notes**: In release D, apigateway submodule is only initial framework code, and more feature will
+be provided in the next release. \ No newline at end of file
diff --git a/docs/release/release-notes/release-notes.rst b/docs/release/release-notes/release-notes.rst
index 5d62b74..0db5c35 100644
--- a/docs/release/release-notes/release-notes.rst
+++ b/docs/release/release-notes/release-notes.rst
@@ -90,12 +90,22 @@ Feature additions
| **JIRA REFERENCE** | **SLOGAN** |
| | |
+--------------------------------------+--------------------------------------+
-| | |
+| PARSER-111 | Verigraph Code Base |
+--------------------------------------+--------------------------------------+
-| | |
+| PARSER-112 | Init api gateway framework |
+--------------------------------------+--------------------------------------+
-| PARSER-111 | Verigraph Code Base |
-| | |
+| PARSER-113 | Add input validation test case |
++--------------------------------------+--------------------------------------+
+| PARSER-114 | Add output in vRNC for substitution |
+| | mappings. |
++--------------------------------------+--------------------------------------+
+| PARSER-115 | Add output validation for |
+| | substitution. |
++--------------------------------------+--------------------------------------+
+| PARSER-116 | Add output validation test case for |
+| | substitution. |
++--------------------------------------+--------------------------------------+
+| PARSER-121 | Add ip output in compute node |
+--------------------------------------+--------------------------------------+
@@ -108,9 +118,10 @@ Bug corrections
| **JIRA REFERENCE** | **SLOGAN** |
| | |
+--------------------------------------+--------------------------------------+
-| | |
+| PARSER-117 | Fix ci bug when integrated with |
+| | functest |
+--------------------------------------+--------------------------------------+
-| | |
+| PARSER-122 | Fix docs bug |
+--------------------------------------+--------------------------------------+
Deliverables
@@ -123,6 +134,7 @@ Software deliverables
- yang2tosca
- policy2tosca
- verigraph
+- apigateway
Documentation deliverables
^^^^^^^^^^^^^^^^^^^^^^^^^^