diff options
| author |   shiva-charan.m-s <shiva-charan.m-s@hp.com> | 2016-01-08 09:47:02 -0600 |
|---|---|---|
| committer |   Zhipeng (Howard) Huang <huangzhipeng@huawei.com> | 2016-01-19 02:00:46 +0000 |
| commit | 6aa28409d5b570e350af3c72717f48f1c641084e (patch) | |
| tree | 3a48ae23f3d64feefdbd0d677a26551eb2252727 | |
| parent | ad5974ac97515d79292d08990dfbfd56b7489ab9 (diff) | |
JIRA:PARSER-1 -docs for yang2tosca patch set-3
Signed-off-by: shiva-charan.m-s <shiva-charan.m-s@hp.com>
(cherry picked from commit ebb5960749eed3a612623819ad7cccc213e16f54)
Change-Id: If09be9d7a3cfde8b34c22feeff4752295434da54
| -rw-r--r-- | docs/yang2tosca/README.rst | 66 | ||||
| -rw-r--r-- | docs/yang2tosca/index.rst | 16 |
2 files changed, 82 insertions, 0 deletions
diff --git a/docs/yang2tosca/README.rst b/docs/yang2tosca/README.rst new file mode 100644 index 0000000..0a3b419 --- /dev/null +++ b/docs/yang2tosca/README.rst @@ -0,0 +1,66 @@ +=========================
+Parser YANG2TOSCA
+========================
+
+Overview
+===========================
+
+Parser is an open source project and licensed under Apache 2. Parser will help
+to provide a tooling mechanism, by parsing Telecom operators’ VNF descriptors
+(YANG templates) into TOSCA templates and then further translate TOSCA
+templates into certain common templates, which could be used in IaaS orchestration
+projects like OpenStack Heat.
+
+Prerequisites
+==========================
+
+Parser requires the following to be installed.
+
+1. PYANG
+-----------------
+
+Please follow the below installation steps.
+
+Step 1: Clone pyang tool or download the zip file from the following link.
+ git clone https://github.com/mbj4668/pyang.git
+ or
+ wget https://github.com/mbj4668/pyang/archive/master.zip
+
+Step 2: Change directory to the downloaded directory and run the setup file.
+ cd pyang
+ python setup.py
+
+2. python-lxml
+--------------------
+
+Please follow the below installation link.
+ http://lxml.de/installation.html
+
+
+Installation
+============================
+
+Please follow the below installation steps to install parser.
+
+Step 1: Clone the parser project.
+ git clone https://gerrit.opnfv.org/gerrit/parser
+
+Execution
+===========================
+
+Step 1: Change directory to where the scripts are present.
+ cd parser/yang2tosca
+
+Step 2: Copy the YANG file which needs to be converted into TOSCA to
+ current (parser/yang2tosca) folder.
+
+Step 3: Run the python script "parser.py" with the YANG file as an input option.
+ python parser.py -n "YANG filename"
+ Example:
+ python parser.py -n example.yaml
+
+Step 4: Verify the TOSCA YAMl which file has been created with the same name
+ as the YANG file with a “_tosca” suffix.
+ cat "YANG filename_tosca.yaml"
+ Example:
+ cat example_tosca.yaml
diff --git a/docs/yang2tosca/index.rst b/docs/yang2tosca/index.rst new file mode 100644 index 0000000..47c1b03 --- /dev/null +++ b/docs/yang2tosca/index.rst @@ -0,0 +1,16 @@ +****************
+YANG to TOSCA Documents
+****************
+
+This is the directory to store documents regarding YANG to TOSCA translation.
+
+The "README" document demonstrates parsing Telecom operators’ VNF descriptors (YANG templates)
+into TOSCA templates and then further translate TOSCA templates into certain common templates,
+which could be used in IaaS orchestration projects like OpenStack Heat.
+
+See also https://wiki.opnfv.org/parser .
+
+.. toctree::
+ :maxdepth: 2
+
+ README.rst
|