summaryrefslogtreecommitdiffstats
path: root/docs/files
diff options
context:
space:
mode:
authorGildas Lanilis <gildas.lanilis@huawei.com>2018-11-09 10:45:50 -0800
committerGildas Lanilis <gildas.lanilis@huawei.com>2018-11-16 13:38:46 -0800
commitb2c75a1834f30a6e4ed08059aa0efebec8b38e1d (patch)
treedb67cc59ccc1fabd9156849445c1423ce30d6ef5 /docs/files
parent73a3ce10b49dfdf68aa7276629b285f55c8baee9 (diff)
Refactor VNFSDSK ReadTheDocs3.0.0-ONAPcasablanca
To facilite browsing and user experience Change-Id: Ic54d6f8a2779bd45a2765a61b694e17a231c9b07 Issue-ID: DOC-333 Signed-off-by: Gildas Lanilis <gildas.lanilis@huawei.com>
Diffstat (limited to 'docs/files')
-rw-r--r--docs/files/Dovetail.rst16
-rw-r--r--docs/files/VNF SDK - Guide for Bundling VNFs.rst23
-rw-r--r--docs/files/VNFSDK-Marketplace-userguide-vendors.rst2
-rw-r--r--docs/files/marketplace-overview.rst50
-rw-r--r--docs/files/mktplace-install.rst27
-rw-r--r--docs/files/ves-client-guidelines.rst15
-rw-r--r--docs/files/vnf-packaging-model-blueprint.rst30
7 files changed, 119 insertions, 44 deletions
diff --git a/docs/files/Dovetail.rst b/docs/files/Dovetail.rst
index 422832b..2ce0289 100644
--- a/docs/files/Dovetail.rst
+++ b/docs/files/Dovetail.rst
@@ -5,14 +5,14 @@
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
-Welcome to Dovetail Integration's documentation!
-=================================================
+Dovetail Integration
+====================
.. toctree::
:maxdepth: 2
User Stories
-============
+------------
1. An ONAP User wants to ensure that VNFs which appear in the VNF
Marketplace can be on-boarded with the Service Design & Creation tool
@@ -32,7 +32,7 @@ User Stories
develop tests.
OPNFV Dovetail Description
-==========================
+--------------------------
The Open Platform for NFV (OPNFV) is a collaborative project under the
Linux Foundation that is transforming global networks through open
@@ -85,7 +85,7 @@ Figure 1 below illustrates the Dovetail test framework architecture.
Figure 1: OPNFV Dovetail Test Framework Architecture
Implementation Overview
-=======================
+-----------------------
OPNFV Dovetail will be integrated into the ONAP VNF Marketplace. The
ONAP VNF Marketplace is an ONAP application which displays all VNFs that
@@ -180,10 +180,10 @@ Marketplace.
ONAP VNF On Boarding processes.
Implementation Details
-======================
+----------------------
Introduce a new test module under VNFSDK
-----------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
A new test module ‘VnfTest’ will be added as a subproject in VNF-SDK.
@@ -191,7 +191,7 @@ This project will be similar to ‘Yardstick’ in the way it defines and
runs tests.
Dovetail to support new type
-----------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
A new test framework type will be introduced to dovetail –
“VNFTest\ **”.**
diff --git a/docs/files/VNF SDK - Guide for Bundling VNFs.rst b/docs/files/VNF SDK - Guide for Bundling VNFs.rst
index 99f3ccf..8bf2f31 100644
--- a/docs/files/VNF SDK - Guide for Bundling VNFs.rst
+++ b/docs/files/VNF SDK - Guide for Bundling VNFs.rst
@@ -2,12 +2,23 @@
.. http://creativecommons.org/licenses/by/4.0
.. Copyright 2017 Huawei Technologies Co., Ltd.
-VNF SDK - Guide for Bundling VNFs
-=================================
+VNF Package Tools User Guide
+============================
+
+VNF Package Designer, provides VNF product DevOps engineers with a graphical
+tool to define the VNF product model and package content. It is made available
+as part of the VNF Supplier SDK tools.The package designer makes use of the VNF
+SDK command line interfaces (CLIs) and client-side API language bindings in
+order to define the model and the package content. As such, it is functionally
+equivalent to the VNF SDK tools.
+
+VNF SDK - Guide for Bundling VNFs
+---------------------------------
+
Step 1: Requirements
---------------------
+~~~~~~~~~~~~~~~~~~~~
1. Virtual machine images for each of your VDUs (likely in qcow2 format).
2. Scripts for installing and configuring each VDU per the standard TOSCA
@@ -16,14 +27,14 @@ Step 1: Requirements
4. VNF SDK pkgtools
Step 2: Start with the provided VNF blueprint as a template
------------------------------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The VNF SDK comes with a "pingpong.yaml" template.
Copy the file and rename it as is appropriate for your VNF.
Step 3: Edit the VNF blueprint
-------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
You will need a node template for each VDU, which in turn has a "dependency"
requirement on a host (a Compute node template).
@@ -70,7 +81,7 @@ Otherwise, this is a standard TOSCA blueprint using the Simple Profile for NFV,
and you may extend the blueprint as is required.
Step 4: Bundle the VNF
-----------------------
+~~~~~~~~~~~~~~~~~~~~~~
Arrange all your files (the TOSCA template, your scripts, and your virtual
machine images) in the correct directory structure. File references provided in
diff --git a/docs/files/VNFSDK-Marketplace-userguide-vendors.rst b/docs/files/VNFSDK-Marketplace-userguide-vendors.rst
index f6385c0..01d7b4c 100644
--- a/docs/files/VNFSDK-Marketplace-userguide-vendors.rst
+++ b/docs/files/VNFSDK-Marketplace-userguide-vendors.rst
@@ -2,7 +2,7 @@
.. http://creativecommons.org/licenses/by/4.0
.. Copyright 2017 Huawei Technologies Co., Ltd.
-VNF SDK Marketplace User Guide for Vendors
+VNF SDK Marketplace User Guide for VNF Suppliers
==========================================
The VNF SDK Marketplace helps vendors validate VNFs and connect with suppliers.
diff --git a/docs/files/marketplace-overview.rst b/docs/files/marketplace-overview.rst
index 4864777..0f53d78 100644
--- a/docs/files/marketplace-overview.rst
+++ b/docs/files/marketplace-overview.rst
@@ -8,11 +8,11 @@ VNF SDK Marketplace
VNF SDK provides a reference implementation "marketplace" to help vendors
validate and manage VNF packages. It also supports the operator to onboard VNF
into ONAP.The API documentation using swagger can be found at http://hostIP:8702/apidocs
-or :download:`json <swagger.json>` :download:`yaml <swagger.yaml>`
+or :download:`json <../swagger.json>` :download:`yaml <../swagger.yaml>`
|image0|
-.. |image0| image:: files/vnfsdk-marketplace.png
+.. |image0| image:: vnfsdk-marketplace.png
:height: 600px
:width: 800px
@@ -45,3 +45,49 @@ or :download:`json <swagger.json>` :download:`yaml <swagger.yaml>`
Repository backend. It provides seamless download, search, view of the VNF
present in VNF repository. The user can onboard these validated VNF into
the SDC catalogue.
+
+VNF SDK Marketplace Installation Instructions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+1. Download vnfsdk/refrepo from Gerrit
+::
+
+ git clone http://gerrit.onap.org/r/vnfsdk/refrepo
+
+2. Goto vnfmarket-be/deployment/install,
+::
+
+ Delete old docker images of refrepo (if any).
+ Enter command "source .env" to set up few environment variables.
+ Enter command "docker-compose up -d"
+
+This will start two Docker containers:
+
+ a. VNF Repository
+ b. PostgreSQL database.
+
+Once started, access the Marketplace from your web browser.
+
+3. Connect to http://{host}:8702/onapui/vnfmarket to access the user interface
+
+VNF SDK Tools
+~~~~~~~~~~~~~
+
+VNF SDK tools provide VNF product DevOps engineers with command line tools and
+client side API language bindings to define the VNF product model and package
+content. The following tools are included...
+
+• VNF Package Builder - creates a CSAR file based on inputs provided by the VNF
+ product DevOps engineer
+
+• VNF Package Validator - validates the content of the VNF packages to ensure
+ that everything has been built correctly
+
+• VNF Package Extractor - extracts VNF product model and executables from the
+ CSAR file
+
+• VNF Package Parser - translates VNF product blueprint into a format
+ consumable by ONAP components
+
+• VNF Package Dry Run - performs a "dry run" install to ensure that the package
+ can be deployed during instantiation \ No newline at end of file
diff --git a/docs/files/mktplace-install.rst b/docs/files/mktplace-install.rst
deleted file mode 100644
index 5e9fa6d..0000000
--- a/docs/files/mktplace-install.rst
+++ /dev/null
@@ -1,27 +0,0 @@
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-.. http://creativecommons.org/licenses/by/4.0
-.. Copyright 2017-2018 Huawei Technologies Co., Ltd.
-
-VNF SDK Marketplace Installation Instructions
-=============================================
-
-1. Download vnfsdk/refrepo from Gerrit
-::
-
- git clone http://gerrit.onap.org/r/vnfsdk/refrepo
-
-2. Goto vnfmarket-be/deployment/install,
-::
-
- Delete old docker images of refrepo (if any).
- Enter command "source .env" to set up few environment variables.
- Enter command "docker-compose up -d"
-
-This will start two Docker containers:
-
- a. VNF Repository
- b. PostgreSQL database.
-
-Once started, access the Marketplace from your web browser.
-
-3. Connect to http://{host}:8702/onapui/vnfmarket to access the user interface
diff --git a/docs/files/ves-client-guidelines.rst b/docs/files/ves-client-guidelines.rst
new file mode 100644
index 0000000..da22335
--- /dev/null
+++ b/docs/files/ves-client-guidelines.rst
@@ -0,0 +1,15 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright 2017-2018 Huawei Technologies Co., Ltd.
+
+VES Client Guidelines
+=====================
+
+
+.. toctree::
+ :maxdepth: 1
+ :titlesonly:
+
+ VESEventRegistration_3_0.rst
+ VESEventListener_7_0_1.rst
+ :download:`common event format json <files/CommonEventFormat_29.json>`
diff --git a/docs/files/vnf-packaging-model-blueprint.rst b/docs/files/vnf-packaging-model-blueprint.rst
new file mode 100644
index 0000000..b475f25
--- /dev/null
+++ b/docs/files/vnf-packaging-model-blueprint.rst
@@ -0,0 +1,30 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright 2017 Huawei Technologies Co., Ltd.
+
+VNF Packaging Model/Blueprint
+=============================
+
+VNF product model/blueprint provides a declarative way to define deployment,
+operational and functional attributes of a VNF product. The VNF product is
+defined in terms of deployment time requirements and dependencies and exposed
+telemetry indicator definitions.
+
+The deployment time requirements and dependencies define any and all compute
+infrastructure needs of the VNF product, such as specific hardware
+architecture, on-chip features, instruction set availability and hypervisor
+capabilities.
+
+The telemetry indicator definitions define a set of default indicators exposed
+by a given VNF product for use by monitoring and assurance tools. This list
+can be extended and customized once a given VNF product is on-boarded and
+instantiated at run-time.
+
+The VNF product model is specified using the TOSCA NFV simple profile. It is
+persisted, along with the product executables and data, using TOSCA CSAR files.
+
+.. toctree::
+ :maxdepth: 1
+ :titlesonly:
+ :glob:
+ \ No newline at end of file