fix doc config files and doc files + top-level tox.ini 13/135313/2
authorthmsdt <thomas.kulik@telekom.de>
Tue, 4 Jul 2023 11:43:14 +0000 (13:43 +0200)
committerthmsdt <thomas.kulik@telekom.de>
Wed, 5 Jul 2023 15:29:09 +0000 (17:29 +0200)
Issue-ID: DOC-811

Signed-off-by: thmsdt <thomas.kulik@telekom.de>
Change-Id: I67dd9f27a851c4a12f078f28c4f9904959c42393

12 files changed:
.readthedocs.yaml
docs/conf.py
docs/platform/APIs/VNFLCM_API/VNFLCM_API.rst
docs/platform/APIs/VNFMDriver_API/VNFM_Driver_API.rst
docs/platform/cli-userguide/index.rst
docs/platform/installation/installation/vfc-over-oom.rst
docs/platform/installation/user-guide/ns-instantiate-guide.rst
docs/platform/ns-instantiate-guide.rst [deleted file]
docs/release-notes.rst
docs/spelling_wordlist.txt [new file with mode: 0644]
docs/tox.ini
tox.ini

index 3797dc8..f56b3b7 100644 (file)
@@ -3,18 +3,16 @@
 # Read the Docs configuration file
 # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
 # Required
-version: 2
-
-formats:
-  - htmlzip
 
+version: 2
 build:
-  image: latest
+  os: ubuntu-20.04
+  tools:
+    python: "3.8"
 
 python:
-  version: 3.7
   install:
-    - requirements: docs/requirements-docs.txt
+  - requirements: docs/requirements-docs.txt
 
 sphinx:
   configuration: docs/conf.py
index a9c42b6..27af5cb 100644 (file)
@@ -52,5 +52,8 @@ def setup(app):
     app.add_css_file("css/ribbon.css")
 
 linkcheck_ignore = [
-  r'http://localhost:\d+/'
+  r'http://localhost:\d+/',
+  r'http://ClusterIP:*',
+  r'http://172.60.2.39:*',
+  r'http://10.43.21.105:*'
 ]
index cebc637..9f4ab5f 100644 (file)
@@ -47,7 +47,7 @@ Table 2-1 abbreviations
 +---------------------+--------------------------------------------------------------+
 |     If Definition   | Description                                                  |
 +=====================+==============================================================+
-|     URI             | http(s)://[hostname][:port]/api/vnflcm/v1/vnf\_instances   |
+|     URI             | http(s)://[hostname][:port]/api/vnflcm/v1/vnf\_instances     |
 +---------------------+--------------------------------------------------------------+
 |     Operation       | POST                                                         |
 +---------------------+--------------------------------------------------------------+
@@ -102,7 +102,7 @@ Table 2-1 abbreviations
 +---------------------+------------------------------------------------------------------------------+
 |     If Definition   | Description                                                                  |
 +=====================+==============================================================================+
-|     URI             | http(s)://[hostname][:port]/api/vnflcm/v1/vnf\_instances/{vnfInstanceId}   |
+|     URI             | http(s)://[hostname][:port]/api/vnflcm/v1/vnf\_instances/{vnfInstanceId}     |
 +---------------------+------------------------------------------------------------------------------+
 |     Operation       | DELETE                                                                       |
 +---------------------+------------------------------------------------------------------------------+
@@ -143,7 +143,7 @@ Table 2-1 abbreviations
 +---------------------+-------------------------------------------------------------------------------------------+
 |     If Definition   | Description                                                                               |
 +=====================+===========================================================================================+
-|     URI             | http(s)://[hostname][:port]/api/vnflcm/v1/vnf_instances/{vnfInstanceId}/instantiate     |
+|     URI             | http(s)://[hostname][:port]/api/vnflcm/v1/vnf_instances/{vnfInstanceId}/instantiate       |
 +---------------------+-------------------------------------------------------------------------------------------+
 |     Operation       | POST                                                                                      |
 +---------------------+-------------------------------------------------------------------------------------------+
@@ -216,13 +216,13 @@ Table 2-1 abbreviations
 +-----------------+-----------+-------------+--------------+------------------------------------------------------------------------------------------------------------------------------------------+
 | vimId           | M         | 1           | Identifier   | The identifier of the VIM.                                                                                                               |
 +-----------------+-----------+-------------+--------------+------------------------------------------------------------------------------------------------------------------------------------------+
-| interfaceInfo   | M         | 0..N        | KeyValuePair | Information about the interface to the VIM, including VIM provider type, API version and protocol type.                                 |
+| interfaceInfo   | M         | 0..N        | KeyValuePair | Information about the interface to the VIM, including VIM provider type, API version and protocol type.                                  |
 +-----------------+-----------+-------------+--------------+------------------------------------------------------------------------------------------------------------------------------------------+
 | accessInfo      | M         | 0..N        | KeyValuePair | Authentication credentials for accessing the VIM. Examples may include those to support different authentication schemes, e.g., OAuth,   |
-|                 |           |             |              | Token etc.                                                                                                                              |
+|                 |           |             |              | Token etc.                                                                                                                               |
 +-----------------+-----------+-------------+--------------+------------------------------------------------------------------------------------------------------------------------------------------+
 | interface       | M         | 1           | String       | Information about the interface endpoint. An example is a URL.                                                                           |
-| Endpoint        |           |             |              | Token etc.                                                                                                                              |
+| Endpoint        |           |             |              | Token etc.                                                                                                                               |
 +-----------------+-----------+-------------+--------------+------------------------------------------------------------------------------------------------------------------------------------------+
 
     **interfaceInfo:**
@@ -402,7 +402,7 @@ Table 2-1 abbreviations
 +---------------------+-----------------------------------------------------------------------------------------+
 |     If Definition   | Description                                                                             |
 +=====================+=========================================================================================+
-|     URI             | http(s)://[hostname][:port]/api/vnflcm/v1/vnf\_instances/{vnfInstanceId}/term inate   |
+|     URI             | http(s)://[hostname][:port]/api/vnflcm/v1/vnf\_instances/{vnfInstanceId}/term inate     |
 +---------------------+-----------------------------------------------------------------------------------------+
 |     Operation       | POST                                                                                    |
 +---------------------+-----------------------------------------------------------------------------------------+
@@ -485,7 +485,7 @@ Table 2-1 abbreviations
 +---------------------+--------------------------------------------------------------+
 |     If Definition   | Description                                                  |
 +=====================+==============================================================+
-|     URI             | http(s)://[hostname][:port]/api/vnflcm/v1/vnf\_instances   |
+|     URI             | http(s)://[hostname][:port]/api/vnflcm/v1/vnf\_instances     |
 +---------------------+--------------------------------------------------------------+
 |     Operation       | GET                                                          |
 +---------------------+--------------------------------------------------------------+
@@ -933,7 +933,7 @@ Table 2-1 abbreviations
 +---------------------+------------------------------------------------------------------------------+
 |     If Definition   | Description                                                                  |
 +=====================+==============================================================================+
-|     URI             | http(s)://[hostname][:port]/api/vnflcm/v1/vnf_instances/{vnfInstanceId}    |
+|     URI             | http(s)://[hostname][:port]/api/vnflcm/v1/vnf_instances/{vnfInstanceId}      |
 +---------------------+------------------------------------------------------------------------------+
 |     Operation       | GET                                                                          |
 +---------------------+------------------------------------------------------------------------------+
@@ -1143,7 +1143,7 @@ Table 2-1 abbreviations
 +---------------------+-------------------------------------------------------------------------------------------------+
 |     If Definition   | Description                                                                                     |
 +=====================+=================================================================================================+
-|     URI             | http(s)://[hostname][:port]/api/vnflcm/v1/vnf\_lc\_ops/{vnfLcOpId}&response Id={responseId}   |
+|     URI             | http(s)://[hostname][:port]/api/vnflcm/v1/vnf\_lc\_ops/{vnfLcOpId}&response Id={responseId}     |
 +---------------------+-------------------------------------------------------------------------------------------------+
 |     Operation       | GET                                                                                             |
 +---------------------+-------------------------------------------------------------------------------------------------+
index 8644093..f86055b 100644 (file)
@@ -7,9 +7,10 @@
 
 **1.  Scope**
 ==============
-The scope of the present document is to describe the VNFM driver integrated related API specification.
-Some content has been updated, about the API Swagger definition, you can find
-here 'VNFM driver development related API<https://gerrit.onap.org/r/gitweb?p=vfc/nfvo/lcm.git;a=blob;f=lcm/swagger/vfc.vnfdriver.swagger.json;h=fc35adbdc75df1307ca2c43a11bfb472da2a27c6;hb=HEAD>'
+The scope of the present document is to describe the VNFM driver integrated
+related API specification. Some content has been updated, about the API Swagger
+definition, you can find here 'VNFM driver development related
+API<https://gerrit.onap.org/r/gitweb?p=vfc/nfvo/lcm.git;a=blob;f=lcm/swagger/vfc.vnfdriver.swagger.json;h=fc35adbdc75df1307ca2c43a11bfb472da2a27c6;hb=HEAD>'
 
 
 **2.  Terms, Definitions and Abbreviations**
@@ -20,7 +21,7 @@ For the purposes of the present document, the following abbreviations apply:
 +-------------+-----------------------------------------------+
 |Abbreviation |                                               |
 +-------------+-----------------------------------------------+
-|NFVO         |Network Function Virtualization Orchestrator  |
+|NFVO         |Network Function Virtualization Orchestrator   |
 +-------------+-----------------------------------------------+
 |VNFM         |Virtual Network Function Manager               |
 +-------------+-----------------------------------------------+
index d89e211..dbde7df 100644 (file)
@@ -7,14 +7,18 @@ VFC-Test Cli Command Guide
 
 Reference manual:
 
-1. https://onap.readthedocs.io/en/dublin/submodules/cli.git/docs/cmd_help_onap_dublin.html
+.. 1. https://onap.readthedocs.io/en/dublin/submodules/cli.git/docs/cmd_help_onap_dublin.html
 
 2. https://git.onap.org/cli/tree/products/onap-dublin
 
 Note:
 
-1. The config. JSON included in the folder is a data guarantee for the example in the guidance manual, which will be converted into Python recognizable object body through the json. load method. Use "parameters" to receive the converted results. (parameters = json. load (config))
-2. You should go to the pod of the CLI environment in the corresponding test environment to execute the command action steps
+1. The config. JSON included in the folder is a data guarantee for the example
+   in the guidance manual, which will be converted into Python recognizable
+   object body through the json. load method. Use "parameters" to receive the
+   converted results. (parameters = json. load (config))
+2. You should go to the pod of the CLI environment in the corresponding test
+   environment to execute the command action steps
 
 .. contents::
    :depth: 2
@@ -68,7 +72,8 @@ More Cli command defination and reference can be found in the following page:
    create_csar_sdc/index
 
 Create csar file(by local)
-------------------------
+--------------------------
+
 More Cli command defination and reference can be found in the following page:
 
 .. toctree::
@@ -77,10 +82,10 @@ More Cli command defination and reference can be found in the following page:
    create_csar_local/index
 
 VFC part
------------
+--------
 More Cli command defination and reference can be found in the following page:
 
 .. toctree::
    :maxdepth: 1
 
-   VFC_part/index
\ No newline at end of file
+   VFC_part/index
index 09d35b4..8f3a8de 100644 (file)
@@ -100,11 +100,10 @@ For initialization of docker there are 2 deployment options currently used in ON
 
 From Casablanca release, OOM is the recommended way, so here mainly give the steps for OOM based deployment
 
-For OOM deployment you can refer to the below links:
+For OOM deployment you can refer to the OOM section in ONAP documentation.
 
-* https://docs.onap.org/projects/onap-oom/en/latest/oom_user_guide.html#oom-user-guide
-
-* https://docs.onap.org/projects/onap-oom/en/latest/oom_quickstart_guide.html#oom-quickstart-guide
+.. * https://docs.onap.org/projects/onap-oom/en/latest/oom_user_guide.html#oom-user-guide
+.. * https://docs.onap.org/projects/onap-oom/en/latest/oom_quickstart_guide.html#oom-quickstart-guide
 
 1. First ensure VF-C is marked true against field enabled in the oom/kubernetes/onap/values.yaml for successful deployment.
 
index cd1bc0e..9d77c00 100644 (file)
@@ -34,9 +34,10 @@ Steps
 
 If you want to  try VF-C,  the small project set should include: VF-C , Multicloud, MSB, A&AI.
 
-VF-C components need to register to MSB when starting, so MSB components should be installed first,you can refer the following link to install MSB.
+VF-C components need to register to MSB when starting, so MSB components should be installed first.
 
-http://onap.readthedocs.io/en/latest/submodules/msb/apigateway.git/docs/platform/installation.html
+.. ,you can refer the following link to install MSB.
+.. http://onap.readthedocs.io/en/latest/submodules/msb/apigateway.git/docs/platform/installation.html
 
 Note: In the following steps, we use ${MSB_IP} as the IP of msb_apigateway component.
 
diff --git a/docs/platform/ns-instantiate-guide.rst b/docs/platform/ns-instantiate-guide.rst
deleted file mode 100644 (file)
index bdbd590..0000000
+++ /dev/null
@@ -1,294 +0,0 @@
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-.. http://creativecommons.org/licenses/by/4.0
-
-NS LCM Guide Using VF-C
------------------------
-
-VF-C supports vCPE use case in R3, all VNFs are deployed through VF-C GVNFM .
-This page describe how to use VF-C to instantiate NS
-
-Before you try, please prepare two csar file: 
-* VNF csar
-* NS csar
-
-If you don't have any csar, you can download the simple csar from https://wiki.onap.org/display/DW/VF-C+User+Guide 
-
-
-Environment
-+++++++++++
-VF-C components can run as docker, docker service should be installed before installing VF-C components.
-
-The following scripts show the docker service install commands in centos 7.
-
-::
-
-  yum install docker
-  systemctl enable docker.service
-  systemctl start docker.service
-
-Steps
-+++++
-
-
-
-If you want to  try VF-C, the small project set should include: VF-C , Multicloud, MSB and A&AI.
-
-VF-C components need to register to MSB when starting, so MSB components should be installed first,you can refer the following link to install MSB.
-
-http://onap.readthedocs.io/en/latest/submodules/msb/apigateway.git/docs/platform/installation.html
-
-Note: In the following steps, we use ${MSB_IP} as the IP of msb_apigateway component.
-
-
-1. Install vfc-nfvo-lcm component.
-
-::
-
-  docker run -d -p 8403:8403 --name vfc-nslcm -e MSB_ADDR=${MSB_IP}:80 -e MYSQL_ADDR=${VFC_DB_IP}:3306
-  nexus3.onap.org:10001/onap/vfc/nslcm
-
-2. Install modeling-etsicatalog component.
-
-::
-
-  docker run -d -p 8806:8806 --name modeling-etsicatalog -e MSB_ADDR=${MSB_IP}:80 -e MYSQL_ADDR=${VFC_DB_IP}:3306 nexus3.onap.org:10001/onap/modeling/etsicatalog
-
-3. Install vfc-nfvo-gvnfmdriver component.
-
-::
-
-  docker run -d -p 8484:8484 --name vfc-gvnfmdriver -e MSB_ADDR=${MSB_IP}:80 nexus3.onap.org:10001/onap/vfc/gvnfmdriver
-
-4. Install vfc-gvnfm-vnflcm component.
-
-::
-
-  docker run -d -p 8801:8801 --name vfc-vnflcm -e MSB_ADDR=${MSB_IP}:80 -e MYSQL_ADDR=${VFC_DB_IP}:3306 nexus3.onap.org:10001/onap/vfc/vnflcm
-
-
-ESR Registration
-++++++++++++++++
-
-
-Before we instantiate a service, we need to register vim and vnfm which is used to deploy vnfs.
-  1.VIM Registration
-
-  |image1|
-
-  .. |image1| image:: vim.png
-   :width: 1000px
-   :height: 600px
-
-
-  2. GVNFM Registration
-
-  For VF-C, because we use GVNFM to deploy vnfs , so you can register GVNFM in esr gui as follows:
-
-  |image2|
-
-  .. |image2| image:: gvnfm.png
-   :width: 1000px
-   :height: 600px
-
-
-Note: type should be gvnfmdriver which is the same with gvnfmdriver microservice
-url is the msb-iag NodeIp:port 
-vim corresponds to cloudowner_cloudregionid which registered in step1
-
-Package Onboarding
-++++++++++++++++++
-
-
-VF-C R3 support VNF/PNF/NS csar package upload from local csar file. VNF/PNF csar package should be uploaded first, then NS csar package can be uploaded.
-Before onboarding a package,  should create one record first. 
-
-
-1. Create VNF package record in etsicatalog DB
-
-::
-
-  curl -X POST \
-
-  http://172.30.3.104:30280/api/vnfpkgm/v1/vnf_packages \
-
-  -H 'Postman-Token: f9c45dea-b7bb-4acd-89e1-b9b1c3d70d8a' \
-  -H 'accept: application/json' \
-  -H 'cache-control: no-cache' \
-  -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
-  -F 'userDefinedData= "key2": "value2"'
-
-Note:  
-  a. 172.30.3.104:30280 is the node IP and exposed port where the msb-iag pod is located. 
-  b. userDefinedData is the key value pair which defined for the vnf package we created
-
-2. Upload VNF package to modeling etsicatalog
-
-::
-
-  curl -X PUT \
-  http://172.30.3.104:30280/api/vnfpkgm/v1/vnf_packages/38037a12-a0d4-4aa4-ac50-cd6b05ce0b24/package_content \
-  -H 'Postman-Token: 88ada218-86fd-4cd7-a06e-cc462f5df651' \
-  -H 'cache-control: no-cache'
-  -H 'accept: application/json' \
-  -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
-  -F 'file=@C:\ONAP\Integration\R3\vCPE\vnf-vsn.csar'
-
-Note:
-  a.  38037a12-a0d4-4aa4-ac50-cd6b05ce0b24  is the vnf_pkg_id which we get from the first step.
-  b.  -F is used to specify the local vnf package file
-
-3. Create NS package record in etsicatalog DB
-
-::
-
-  curl -X POST \
-
-  http://172.30.3.104:30280/api/nsd/v1/ns_descriptors \
-  -H 'Postman-Token: 71b11910-1708-471c-84bb-5b0dd8d214a2' \
-  -H 'accept: application/json' \
-  -H 'cache-control: no-cache' \
-  -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
-  -F 'userDefinedData= "key1": "value1"'
-
-Note:
-  a. userDefinedData is the key value pair which defined for the ns package we created
-
-4. Upload NS package to modeling etsicatalog
-
-::
-
-  curl -X PUT \
-  http://172.30.3.104:30280/api/nsd/v1/ns_descriptors/79ca81ec-10e0-44e4-bc85-ba968f345711/nsd_content \
-  -H 'Postman-Token: f16e4a54-a514-4878-b307-9b80c630166e' \
-  -H 'cache-control: no-cache'
-  -H 'accept: application/json' \
-  -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
-  -F 'file=@C:\ONAP\Integration\R3\vCPE\ns.csar'
-
-Note:
-  a.  -F is used to specify the local ns package file
-
-
-NS Life Cycle Management
-++++++++++++++++++++++++
-
-
-Currently VF-C GVNFM support NS create/Instantiate/terminate/delete/heal.
-
-VF-C R3 healing only suport restart a vm of an VNF. 
-
-1. NS Create 
-
-::
-
-  curl -X POST \
-  http://172.30.3.104:30280/api/nslcm/v1/ns \
-  -H 'Postman-Token: 27e2c576-2d9b-4753-a6b0-6262a4a7ec86' \
-  -H 'accept: application/json' \
-  -H 'cache-control: no-cache' \
-  -H 'content-type: application/json' \
-  -d '{
-       "context": {
-                "globalCustomerId": "global-customer-id-test1",
-                "serviceType": "service-type-test1"
-        },
-        "csarId": "79ca81ec-10e0-44e4-bc85-ba968f345711",
-        "nsName": "ns_vsn",
-        "description": "description"
-        }'
-
-Note:
-  a.  globalCustomerId  and serviceType is defined in A&AI.
-  b. csar Id is the NS package id  which is consistent with the etsicatalog ns package id.
-  c. nsName is the NS name 
-
-2. NS Instantiate
-
-::
-
-   curl -X POST \
-  http://172.30.3.104:30280/api/nslcm/v1/ns/f0b4c09f-c653-438a-b091-5218b0f806ec/instantiate \
-  -H 'Postman-Token: 2a9542b2-3364-4a40-8513-45e10b8ca2ce' \
-  -H 'accept: application/json' \
-  -H 'cache-control: no-cache' \
-  -H 'content-type: application/json' \
-    -d '{
-         "additionalParamForNs": {
-                "sdnControllerId": "2"
-         },
-         "locationConstraints": [{
-                "vnfProfileId": "45711f40-3f43-415b-bb45-46e5c6940735",
-                "locationConstraints": {
-                      "vimId": "CPE-DC_RegionOne"
-                }
-                }]
-         }'
-
-Note:
-  a.  f0b4c09f-c653-438a-b091-5218b0f806ec is the ns instance id which create in step 1 : NS create.
-  b.  locationConstraints  is an array which contains all the vnfs included under NS locationConstraints is used to define the VIM( cloudOwner_cloudRegionId)  that the VNF will be deployed vnfProfileId is the vnf descriptor id which defined in NS template  under  node_templates . 
-
-
- |image3|
-
-  .. |image3| image:: image2018-12-10_12-1-36.png
-   :width: 5.97047in
-   :height: 2.63208in
-
-  c.   before instantiate, you should create one volumntype which is called root.
-
-3. NS Heal
-
-::
-
-  curl -X PUT \
-   http://172.30.3.104:30280/api/nslcm/v1/ns/f0b4c09f-c653-438a-b091-5218b0f806ec/heal \
-  -H 'Content-Type: application/json' \
-  -H 'Postman-Token: f18754b8-ed68-43b0-ae55-b8b8780e5c6a' \
-  -H 'accept: application/json' \
-  -H 'cache-control: no-cache' \
-  -d '{   "vnfInstanceId": "044b705c-e44d-4733-ab64-987f46d9b567", 
-                    "cause": "restartvm",  
-                    "additionalParams": {    
-                                                        "action": "restartvm",  
-                                                         "actionvminfo": {   
-                                                         "vmid": "1623cd25-ae6f-4880-8132-15914367e47b",
-                                                         "vduid": "",    
-                                                          "vmname": "1623cd25-ae6f-4880-8132-15914367e47b"  
-        }}  
-        }'
-
-Note:
-  a.  f0b4c09f-c653-438a-b091-5218b0f806ec  is the ns instance id which create in step 1 : NS create.
-  b.   "vnfInstanceId": "044b705c-e44d-4733-ab64-987f46d9b567" is the VNF instanceId, we can get this from A&AI or VF-C DB.
-  c.  action only support restartvm  in Casablanca release.
-  d.  actionvminfo only supports to include one vm , vmid is the vmid which is the same with the vmid in cloud. 
-
-4. NS Terminate
-
-::
-
-  curl -X POST \
-  http://172.30.3.104:30280/api/nslcm/v1/ns/f0b4c09f-c653-438a-b091-5218b0f806ec/terminate \
-  -H 'Postman-Token: 5190e46f-f612-432a-90d8-161ea67778b2' \
-  -H 'accept: application/json' \
-  -H 'cache-control: no-cache' \
-  -H 'content-type: application/json' \
-  -d 'gracefulTerminationTimeout: 600,
-  \terminationType: FORCEFUL'
-
-Note:
-  a.  f0b4c09f-c653-438a-b091-5218b0f806ec  is the ns instance id which create in step 1 : NS create.
-  b.  terminateType supports FORCEFUL and GRACEFULLc.  gracefulTerminationTimeout is the wait time before execute terminate.
-
-5. NS delete
-
-::
-
-  curl -X DELETE \
-  http://172.30.3.104:30280/api/nslcm/v1/ns/f0b4c09f-c653-438a-b091-5218b0f806ec \
-  -H 'Postman-Token: 62b35de6-1785-40ed-8026-06d73f9770d8' \
-  -H 'cache-control: no-cache'
-
-Note:
-  a.  f0b4c09f-c653-438a-b091-5218b0f806ec is the ns instance id which create in step 1 : NS create
index ddd9197..ee47827 100644 (file)
@@ -245,9 +245,10 @@ GVNFM
 
 Quick Links:
 
-- `VFC project page <https://wiki.onap.org/display/DW/Virtual+Function+Controller+Project>`_
-- `Passing Badge information for VFC <https://bestpractices.coreinfrastructure.org/en/projects/1608>`_
-- `CLI command about VFC operation <https://onap.readthedocs.io/en/latest/submodules/vfc/nfvo/lcm.git/docs/platform/cli-userguide/index.html#vfc-part>`_
+- `VFC project page <https://wiki.onap.org/display/DW/Virtual+Function+Controller+Project>`__
+- `Passing Badge information for VFC <https://bestpractices.coreinfrastructure.org/en/projects/1608>`__
+
+.. - `CLI command about VFC operation <https://onap.readthedocs.io/en/latest/submodules/vfc/nfvo/lcm.git/docs/platform/cli-userguide/index.html#vfc-part>`__
 
 **Upgrade Notes**
     NA
@@ -317,9 +318,9 @@ of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=68542814>`_.
 
 Quick Links:
 
-- `VFC project page <https://wiki.onap.org/display/DW/Virtual+Function+Controller+Project>`_
-- `Passing Badge information for VFC <https://bestpractices.coreinfrastructure.org/en/projects/1608>`_
-- `Project Vulnerability Review Table for VFC <https://wiki.onap.org/pages/viewpage.action?pageId=68542814>`_
+- `VFC project page <https://wiki.onap.org/display/DW/Virtual+Function+Controller+Project>`__
+- `Passing Badge information for VFC <https://bestpractices.coreinfrastructure.org/en/projects/1608>`__
+- `Project Vulnerability Review Table for VFC <https://wiki.onap.org/pages/viewpage.action?pageId=68542814>`__
 
 **Upgrade Notes**
     NA
@@ -392,13 +393,13 @@ VFC code has been formally scanned during build time using NexusIQ and all Criti
 vulnerabilities have been addressed, items that remain open have been assessed
 for risk and determined to be false positive. The VFC open Critical security
 vulnerabilities and their risk assessment have been documented as part
-of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=51282550>`_.
+of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=51282550>`__.
 
 Quick Links:
 
-- `VFC project page <https://wiki.onap.org/display/DW/Virtual+Function+Controller+Project>`_
-- `Passing Badge information for VFC <https://bestpractices.coreinfrastructure.org/en/projects/1608>`_
-- `Project Vulnerability Review Table for VFC <https://wiki.onap.org/pages/viewpage.action?pageId=51282550>`_
+- `VFC project page <https://wiki.onap.org/display/DW/Virtual+Function+Controller+Project>`__
+- `Passing Badge information for VFC <https://bestpractices.coreinfrastructure.org/en/projects/1608>`__
+- `Project Vulnerability Review Table for VFC <https://wiki.onap.org/pages/viewpage.action?pageId=51282550>`__
 
 **Upgrade Notes**
        NA
@@ -459,13 +460,13 @@ VFC code has been formally scanned during build time using NexusIQ and all Criti
 vulnerabilities have been addressed, items that remain open have been assessed
 for risk and determined to be false positive. The VFC open Critical security
 vulnerabilities and their risk assessment have been documented as part
-of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=45298878>`_.
+of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=45298878>`__.
 
 Quick Links:
 
-- `VFC project page <https://wiki.onap.org/display/DW/Virtual+Function+Controller+Project>`_
-- `Passing Badge information for VFC <https://bestpractices.coreinfrastructure.org/en/projects/1608>`_
-- `Project Vulnerability Review Table for VFC <https://wiki.onap.org/pages/viewpage.action?pageId=45298878>`_
+- `VFC project page <https://wiki.onap.org/display/DW/Virtual+Function+Controller+Project>`__
+- `Passing Badge information for VFC <https://bestpractices.coreinfrastructure.org/en/projects/1608>`__
+- `Project Vulnerability Review Table for VFC <https://wiki.onap.org/pages/viewpage.action?pageId=45298878>`__
 
 **Upgrade Notes**
        NA
@@ -526,13 +527,13 @@ VFC code has been formally scanned during build time using NexusIQ and all Criti
 vulnerabilities have been addressed, items that remain open have been assessed
 for risk and determined to be false positive. The VFC open Critical security
 vulnerabilities and their risk assessment have been documented as part
-of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=25437810>`_.
+of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=25437810>`__.
 
 Quick Links:
 
-- `VFC project page <https://wiki.onap.org/display/DW/Virtual+Function+Controller+Project>`_
-- `Passing Badge information for VFC <https://bestpractices.coreinfrastructure.org/en/projects/1608>`_
-- `Project Vulnerability Review Table for VFC <https://wiki.onap.org/pages/viewpage.action?pageId=25437810>`_
+- `VFC project page <https://wiki.onap.org/display/DW/Virtual+Function+Controller+Project>`__
+- `Passing Badge information for VFC <https://bestpractices.coreinfrastructure.org/en/projects/1608>`__
+- `Project Vulnerability Review Table for VFC <https://wiki.onap.org/pages/viewpage.action?pageId=25437810>`__
 
 **Upgrade Notes**
        NA
diff --git a/docs/spelling_wordlist.txt b/docs/spelling_wordlist.txt
new file mode 100644 (file)
index 0000000..e69de29
index f6438ba..ce836cb 100644 (file)
@@ -1,6 +1,6 @@
 [tox]
 minversion = 1.6
-envlist = docs,
+envlist = docs,docs-linkcheck,docs-spellcheck
 skipsdist = true
 
 [testenv:docs]
@@ -8,22 +8,18 @@ basepython = python3.8
 deps =
     -r{toxinidir}/requirements-docs.txt
     -chttps://raw.githubusercontent.com/openstack/requirements/stable/yoga/upper-constraints.txt
-    -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt
+    -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=master
 commands =
-    sphinx-build -b html -n -d {envtmpdir}/doctrees ./ {toxinidir}/_build/html
-    echo "Generated docs available in {toxinidir}/_build/html"
-whitelist_externals =
-    echo
-    git
-    sh
+    sphinx-build -W -q -b html -n -d {envtmpdir}/doctrees {toxinidir} {toxinidir}/_build/html
 
 [testenv:docs-linkcheck]
 basepython = python3.8
-#deps = -r{toxinidir}/requirements-docs.txt
-commands = echo "Link Checking not enforced"
-#commands = sphinx-build -b linkcheck -d {envtmpdir}/doctrees ./ {toxinidir}/_build/linkcheck
-whitelist_externals = echo
-
+deps =
+    -r{toxinidir}/requirements-docs.txt
+    -chttps://raw.githubusercontent.com/openstack/requirements/stable/yoga/upper-constraints.txt
+    -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=master
+commands =
+    sphinx-build -W -q -b linkcheck -d {envtmpdir}/doctrees {toxinidir} {toxinidir}/_build/linkcheck
 
 [testenv:docs-spellcheck]
 basepython = python3.8
@@ -32,6 +28,4 @@ deps =
     -chttps://raw.githubusercontent.com/openstack/requirements/stable/yoga/upper-constraints.txt
     -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=master
 commands =
-    sphinx-build -W -q -b spelling -d {envtmpdir}/doctrees {toxinidir} {toxinidir}/_build/spellcheck
-
-
+    sphinx-build -q -b spelling -d {envtmpdir}/doctrees {toxinidir} {toxinidir}/_build/spellcheck
diff --git a/tox.ini b/tox.ini
index 51b5b81..9797c9b 100644 (file)
--- a/tox.ini
+++ b/tox.ini
@@ -22,6 +22,6 @@ commands = flake8
 commands =
   {[testenv]commands}
 
-[testenv:cov]
-deps = coverage==4.2
-commands = coverage xml --omit="*test_*,*__init__.py,*site-packages*"
+#[testenv:cov]
+#deps = coverage==4.2
+#commands = coverage xml --omit="*test_*,*__init__.py,*site-packages*"