From a3adf07306490e9d0e88229c165630124376c86f Mon Sep 17 00:00:00 2001 From: Chris Donley Date: Thu, 9 Nov 2017 15:17:45 -0800 Subject: Documentation clean-up Cleaned up documentation per: (1) Docs project feedback (2) License cleanup (3) other typos, etc. Issue-ID: VNFSDK-129 Change-Id: If125784b3b0656128ca897e82ad0e5d9873a7e07 Signed-off-by: Chris Donley --- docs/files/pkgtool.rst | 35 +++++++++++++++++++++++++---------- 1 file changed, 25 insertions(+), 10 deletions(-) (limited to 'docs/files/pkgtool.rst') diff --git a/docs/files/pkgtool.rst b/docs/files/pkgtool.rst index 36e582e..9325da9 100644 --- a/docs/files/pkgtool.rst +++ b/docs/files/pkgtool.rst @@ -1,16 +1,27 @@ +.. 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 Package Tool ================ Provided tools -------------- -* 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 - -The tools are provided in a form of a shared library (Python module) that can be used in other projects. A CLI is also provided out-of-the box for DevOps to use the library with their scripts and autoamtion framework. +* 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 + +The tools are provided in a form of a shared library (Python module) that can +be used in other projects. A CLI is also provided out-of-the box for DevOps to +use the library with their scripts and autoamtion framework. Repository Name: vnfsdk/pkgtools @@ -18,7 +29,9 @@ Clone command: git clone http://gerrit.onap.org/r/vnfsdk/pkgtools Installation ------------ -Python module with CLI is installed by Python pip command. It is possible to install into a virtual environment (virtualenv). +Python module with CLI is installed by Python pip command. It is possible to +install into a virtual environment (virtualenv). + The following commands are executed in the cloned repository directory: 1. pip install -r requirements.txt @@ -34,7 +47,8 @@ Install VNF SDK tools package Usage * Create CSAR by specifying a directory - vnfsdk csar-create -d DESTINATION [--manifest MANIFEST] [--history HISTORY] [--tests TESTS] [--licenses LICENSES] source entry + vnfsdk csar-create -d DESTINATION [--manifest MANIFEST] [--history HISTORY] + [--tests TESTS] [--licenses LICENSES] source entry * Extract CSAR content vnfsdk csar-open -d DESTINATION source @@ -43,4 +57,5 @@ Usage vnfsdk csar-validate source -All commands have -h switch which displays help and description of all paramaters. +All commands have -h switch which displays help and description of all +paramaters. -- cgit 1.2.3-korg