summaryrefslogtreecommitdiffstats
path: root/docs/dovetailtool/dovetail.tool.cli.rst
diff options
context:
space:
mode:
authorChristopherPrice <christopher.price@ericsson.com>2017-04-26 15:25:55 +0200
committerChristopher Price <christopher.price@ericsson.com>2017-04-27 10:04:23 +0000
commitb8722fae5e61ca71a43f3d69d1d093906b140bbe (patch)
tree40584e9f72f3b38cd98f3064df0d6b5a476dfa7a /docs/dovetailtool/dovetail.tool.cli.rst
parentacee332cda9fab1315ee1147ab12bc4003f05990 (diff)
Setting the document directory structure according to the Plugfest outcome.
Implemented a directory and file structure that supports the requirements defined in the plugfest etherpad: https://etherpad.opnfv.org/p/cvp_tooling_sketch Change-Id: Icb7d2db4b0132f2039c680883e173ff5d7fc0120 Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
Diffstat (limited to 'docs/dovetailtool/dovetail.tool.cli.rst')
-rw-r--r--docs/dovetailtool/dovetail.tool.cli.rst173
1 files changed, 0 insertions, 173 deletions
diff --git a/docs/dovetailtool/dovetail.tool.cli.rst b/docs/dovetailtool/dovetail.tool.cli.rst
deleted file mode 100644
index f13bc289..00000000
--- a/docs/dovetailtool/dovetail.tool.cli.rst
+++ /dev/null
@@ -1,173 +0,0 @@
-.. This work is licensed under a Creative Commons Attribution 4.0 International
-.. License.
-.. http://creativecommons.org/licenses/by/4.0
-.. (c) OPNFV, Huawei Technologies Co.,Ltd and others.
-
-================================
-Dovetail Command-line Interface
-================================
-
-
-Command Line Introduction
-==========================
-
-The Dovetail command-line interface provides a method for interacting with
-Dovetail from the console. For help on the ``dovetail`` command, enter:
-
-::
-
- dovetail --help
-
-**dovetail** optional arguments:
-
-::
-
- --version
- show program's version number and exit
- list <testsuite_name>
- list the testsuite details
- show <testcase_name>
- show the testcase details
- run <arguments>
- run the testcases
-
-For **dovetail list**, if the ``<testsuite_name>`` is omitted,
-all the testsuites defined under ``/dovetail/compliance`` directory
-and related testcases will be listed, otherwise,
-the test area and test cases defined in ``<testsuite_name>`` are listed.
-
-For **dovetail show**, the ``<testcase_name>`` is required, the contents defined
-in ``<testcase_name>.yml`` is shown.
-
-For **dovetail run**, by running ``dovetail run --help``, the ``dovetail run``
-usage is shown as:
-
-+------------------------+-----------------------------------------------------+
-|Options | |
-+========================+=====================================================+
-| -t, --SUT_TYPE |Installer type of the system under test (SUT). |
-+------------------------+-----------------------------------------------------+
-| --creds |Openstack credential file location |
-+------------------------+-----------------------------------------------------+
-| -i, --SUT_IP |IP of the system under test (SUT). |
-+------------------------+-----------------------------------------------------+
-| -d, --debug |True for showing debug log on screen. |
-+------------------------+-----------------------------------------------------+
-| -f, --func_tag |Overwrite tag for functest docker container (e.g. |
-| |stable or latest) |
-+------------------------+-----------------------------------------------------+
-| -y, --yard_tag |Overwrite tag for yardstick docker container (e.g. |
-| |stable or latest) |
-+------------------------+-----------------------------------------------------+
-| --testarea |compliance testarea within testsuite |
-+------------------------+-----------------------------------------------------+
-| --testsuite |compliance testsuite. |
-+------------------------+-----------------------------------------------------+
-| -h, --help |Show this message and exit. |
-+------------------------+-----------------------------------------------------+
-
-
-If no arguments are given, the default testsuite will be performed, i.e., the ``compliance_set``
-testsuite with default configurations.
-
-For more information about **dovetail** command-line interface, please refer to the wiki page [3]_
-
-Parameters definition with config file
-======================================
-
-The default **dovetail run** parameters can be modified in
-``dovetail/dovetail/conf/cmd_config.yml``, which is shown as:
-
-::
-
- cli:
- arguments:
- config:
- # This is a simple example of arguments.
- # Dovetail has no need of this kind of parameters currently.
- # The arguments must be given orderly at the run-time.
- #
- # docker_tag:
- # flags: 'docker_tag'
- # path:
- # - 'functest/docker_tag'
- # - 'yardstick/docker_tag'
- control:
-
- options:
- config:
- SUT_TYPE:
- flags:
- - '--SUT_TYPE'
- - '-t'
- path:
- - 'functest/envs'
- - 'yardstick/envs'
- help: 'Installer type of the system under test (SUT).'
- yard_tag:
- flags:
- - '--yard_tag'
- - '-y'
- path:
- - 'yardstick/docker_tag'
- help: 'Overwrite tag for yardstick docker container (e.g. stable or latest)'
- func_tag:
- flags:
- - '--func_tag'
- - '-f'
- path:
- - 'functest/docker_tag'
- help: 'Overwrite tag for functest docker container (e.g. stable or latest)'
- control:
- testsuite:
- flags:
- - '--testsuite'
- default: 'compliance_set'
- help: 'compliance testsuite.'
- testarea:
- flags:
- - '--testarea'
- default: 'full'
- help: 'compliance testarea within testsuite'
-
-The Click module is used to parse parameters defined in the above config file,
-two subsections are included in this file, ``arguments`` and ``options``,
-which corresponds to two types of parameters in Click.
-
-Arguments and Options
-+++++++++++++++++++++
-Only ``options`` is used currently, which means parameters can be given (or not) without
-sequence restriction.
-
-Config and control
-++++++++++++++++++
-
-All options/arguments are divided into two parts: **config** and **control**.
-The config ones are used for updating functest or yardstick config files according
-to the **path** given. For example, functest's config file is
-``dovetail/dovetail/conf/functest_config.yml``, following is a simple example:
-
-::
-
- docker_tag: latest
- envs: '-e INSTALLER_TYPE=compass -e INSTALLER_IP=192.168.200.2
- -e NODE_NAME=dovetail-pod -e DEPLOY_SCENARIO=ha_nosdn
- -e BUILD_TAG=dovetail -e CI_DEBUG=true -e DEPLOY_TYPE=baremetal'
-
-If running with the command ``python run.py --SUT_TYPE fuel -f stable``, then
-the configs will be changed into
-
-::
-
- docker_tag: stable
- envs: '-e INSTALLER_TYPE=fuel -e INSTALLER_IP=192.168.200.2
- -e NODE_NAME=dovetail-pod -e DEPLOY_SCENARIO=ha_nosdn
- -e BUILD_TAG=dovetail -e CI_DEBUG=true -e DEPLOY_TYPE=baremetal'
-
-The config options/arguments can be added or deleted by modifying
-``cmd_config.yml`` rather than changing the source code. However, for control
-command, besides adding it into ``cmd_config.yml``, some other operations about
-the source code are also needed.
-
-
-. [3] https://wiki.opnfv.org/display/dovetail/Dovetail+Command+Line