From fad3b8faebb29f79a6d6603ae21ccb5bf462574f Mon Sep 17 00:00:00 2001 From: xudan Date: Thu, 12 Oct 2017 06:34:06 -0400 Subject: Add dovetail tool CLI document According to the wiki page, add the CLI document. https://wiki.opnfv.org/display/dovetail/Dovetail+Command+Line JIRA: DOVETAIL-509 Change-Id: I6a32446cd4c1bcad83465b1f2e12d5c1487e954e Signed-off-by: xudan --- docs/testing/user/userguide/cli_reference.rst | 203 ++++++++++++++++++++++++++ docs/testing/user/userguide/index.rst | 1 + docs/testing/user/userguide/testing_guide.rst | 2 +- 3 files changed, 205 insertions(+), 1 deletion(-) (limited to 'docs') diff --git a/docs/testing/user/userguide/cli_reference.rst b/docs/testing/user/userguide/cli_reference.rst index 719a991f..35915bcc 100644 --- a/docs/testing/user/userguide/cli_reference.rst +++ b/docs/testing/user/userguide/cli_reference.rst @@ -2,8 +2,211 @@ .. http://creativecommons.org/licenses/by/4.0 .. (c) OPNFV +.. _cli-reference: + ========================================= Dovetail Command Line Interface Reference ========================================= +Dovetail command line is to have a simple command line interface in Dovetail to +make easier for users to handle the functions that dovetail framework provides. + +Commands List +============= + ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| Commands | Action | +| | | ++========================================================================+===================================================================================================+ +| dovetail --help | -h | Show usage of command "dovetail" | +| | | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| dovetail --version | Show version number | +| | | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| **Dovetail List Commands** | +| | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| dovetail list --help | -h | Show usage of command "dovetail list" | +| | | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| dovetail list | List all available test suites and all test cases within each test suite | +| | | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| dovetail list | List all available test areas within test suite | +| | | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| **Dovetail Show Commands** | +| | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| dovetail show --help | -h | Show usage of command "dovetail show" | +| | | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| dovetail show | Show the details of one test case | +| | | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| **Dovetail Run Commands** | +| | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| dovetail run --help | -h | Show usage of command "dovetail run" | +| | | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| dovetail run | Run Dovetail with all test areas within default test suite "compliance_set" | +| | | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| dovetail run --testsuite | Run Dovetail with all test areas within test suite | +| | | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| dovetail run --testsuite --testarea | Run Dovetail with test area within test suite . | +| | Test area can be chosen from (mandatory, optional, osinterop, ha, vping, ipv6, tempest, sdnvpn). | +| | Repeat option to set multiple test areas. | +| | | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| dovetail run --debug | -d | Run Dovetail with a debug mode and show all debug logs | +| | | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| dovetail run --offline | Run Dovetail offline, use local docker images and will not update them | +| | | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| dovetail run --report | -r | Push results to local or official DB | +| | | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| dovetail run --yard_tag | -y | Specify yardstick's docker image tag, default is danube.3.2 | +| | | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| dovetail run --func_tag | -f | Specify functest's docker image tag, default is cvp.0.5.0 | +| | | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ +| dovetail run --bott_tag | -b | Specify bottlenecks' docker image tag, default is cvp.0.4.0 | +| | | ++------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------+ + +Commands Examples +================= + +Dovetail Commands +----------------- + +.. code-block:: bash + + root@1f230e719e44:~/dovetail/dovetail# dovetail --help + Usage: dovetail [OPTIONS] COMMAND [ARGS]... + + Options: + --version Show the version and exit. + -h, --help Show this message and exit. + + Commands: + list list the testsuite details + run run the testcases + show show the testcases details + +.. code-block:: bash + + root@1f230e719e44:~/dovetail/dovetail# dovetail --version + dovetail, version 0.7.0 + +Dovetail List Commands +---------------------- + +.. code-block:: bash + + root@1f230e719e44:~/dovetail/dovetail# dovetail list --help + Usage: dovetail list [OPTIONS] [TESTSUITE] + + list the testsuite details + + Options: + -h, --help Show this message and exit. + +.. code-block:: bash + + root@1f230e719e44:~/dovetail/dovetail# dovetail list debug + - example + dovetail.example.tc002 + - osinterop + dovetail.osinterop.tc001 + - vping + dovetail.vping.tc001 + dovetail.vping.tc002 + +Dovetail Show Commands +---------------------- + +.. code-block:: bash + + root@1f230e719e44:~/dovetail/dovetail# dovetail show --help + Usage: dovetail show [OPTIONS] TESTCASE + + show the testcases details + + Options: + -h, --help Show this message and exit. + +.. code-block:: bash + + root@1f230e719e44:~/dovetail/dovetail# dovetail show dovetail.vping.tc001 + --- + dovetail.vping.tc001: + name: dovetail.vping.tc001 + objective: testing for vping using userdata + validate: + type: functest + testcase: vping_userdata + report: + sub_testcase_list: + +.. code-block:: bash + + root@1f230e719e44:~/dovetail/dovetail# dovetail show ipv6.tc001 + --- + dovetail.ipv6.tc001: + name: dovetail.ipv6.tc001 + objective: Bulk creation and deletion of IPv6 networks, ports and subnets + validate: + type: functest + testcase: tempest_custom + pre_condition: + - 'cp /home/opnfv/userconfig/pre_config/tempest_conf.yaml /usr/local/lib/python2.7/dist-packages/functest/opnfv_tests/openstack/tempest/custom_tests/tempest_conf.yaml' + pre_copy: + src_file: tempest_custom.txt + dest_path: /usr/local/lib/python2.7/dist-packages/functest/opnfv_tests/openstack/tempest/custom_tests/test_list.txt + report: + sub_testcase_list: + - tempest.api.network.test_networks.BulkNetworkOpsIpV6Test.test_bulk_create_delete_network[id-d4f9024d-1e28-4fc1-a6b1-25dbc6fa11e2,smoke] + - tempest.api.network.test_networks.BulkNetworkOpsIpV6Test.test_bulk_create_delete_port[id-48037ff2-e889-4c3b-b86a-8e3f34d2d060,smoke] + - tempest.api.network.test_networks.BulkNetworkOpsIpV6Test.test_bulk_create_delete_subnet[id-8936533b-c0aa-4f29-8e53-6cc873aec489,smoke] + +Dovetail Run Commands +---------------------- + +.. code-block:: bash + + root@1f230e719e44:~/dovetail/dovetail# dovetail run --help + Usage: run.py [OPTIONS] + + Dovetail compliance test entry! + + Options: + -b, --bott_tag TEXT Overwrite tag for bottlenecks docker container (e.g. cvp.0.4.0) + -f, --func_tag TEXT Overwrite tag for functest docker container (e.g. cvp.0.5.0) + -y, --yard_tag TEXT Overwrite tag for yardstick docker container (e.g. danube.3.2) + --testarea TEXT compliance testarea within testsuite + --offline run in offline method, which means not to update the docker upstream images, functest, yardstick, etc. + -r, --report TEXT push results to DB (e.g. --report http://192.168.135.2:8000/api/v1/results) + --testsuite TEXT compliance testsuite. + -d, --debug Flag for showing debug log on screen. + -h, --help Show this message and exit. + +.. code-block:: bash + root@1f230e719e44:~/dovetail/dovetail# dovetail run --testsuite proposed_tests --testarea vping --offline -r http://192.168.135.2:8000/api/v1/results + 2017-10-12 14:57:51,278 - run - INFO - ================================================ + 2017-10-12 14:57:51,278 - run - INFO - Dovetail compliance: proposed_tests! + 2017-10-12 14:57:51,278 - run - INFO - ================================================ + 2017-10-12 14:57:51,278 - run - INFO - Build tag: daily-master-b80bca76-af5d-11e7-879a-0242ac110002 + 2017-10-12 14:57:51,336 - run - WARNING - There is no hosts file /home/jenkins/opnfv/slave_root/workspace/dovetail-compass-huawei-pod7-proposed_tests-danube/cvp/pre_config/hosts.yaml, may be some issues with domain name resolution. + 2017-10-12 14:57:51,517 - run - INFO - >>[testcase]: dovetail.vping.tc001 + 2017-10-12 14:58:21,325 - run - INFO - Results have been pushed to database and stored with local file /home/dovetail/results/results.json. + 2017-10-12 14:58:21,337 - run - INFO - >>[testcase]: dovetail.vping.tc002 + 2017-10-12 14:58:48,862 - run - INFO - Results have been pushed to database and stored with local file /home/dovetail/results/results.json. diff --git a/docs/testing/user/userguide/index.rst b/docs/testing/user/userguide/index.rst index aec3e861..c2dd32a7 100644 --- a/docs/testing/user/userguide/index.rst +++ b/docs/testing/user/userguide/index.rst @@ -10,3 +10,4 @@ Compliance Verification Program Testing User Guide :maxdepth: 2 testing_guide.rst + cli_reference.rst diff --git a/docs/testing/user/userguide/testing_guide.rst b/docs/testing/user/userguide/testing_guide.rst index d73ee206..2e91b14c 100644 --- a/docs/testing/user/userguide/testing_guide.rst +++ b/docs/testing/user/userguide/testing_guide.rst @@ -397,7 +397,7 @@ Now you should be in the Dovetail container's prompt and ready to execute test suites. The Dovetail client CLI allows the tester to specify which test suite to run. -You can refer to `Dovetail CLI wiki page `_ +You can refer to :ref:`cli-reference`. for the details of the CLI. By default the results are stored in a local file ``$DOVETAIL_HOME/results``. -- cgit 1.2.3-korg