From: Zac Dover Date: Wed, 24 Feb 2021 13:58:50 +0000 (+1000) Subject: doc/dev: rewrite t8y "re-running tests" X-Git-Tag: v17.1.0~2832^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=04fbd85e420b3345b267415e66050e440c5b74cc;p=ceph.git doc/dev: rewrite t8y "re-running tests" This PR rewrites the "re-running tests" section so that its elegance and readability are improved. Signed-off-by: Zac Dover --- diff --git a/doc/dev/developer_guide/testing_integration_tests/tests-integration-testing-teuthology-workflow.rst b/doc/dev/developer_guide/testing_integration_tests/tests-integration-testing-teuthology-workflow.rst index 801b4ef07b8c..92c8bc568f56 100644 --- a/doc/dev/developer_guide/testing_integration_tests/tests-integration-testing-teuthology-workflow.rst +++ b/doc/dev/developer_guide/testing_integration_tests/tests-integration-testing-teuthology-workflow.rst @@ -238,10 +238,13 @@ example, for the above test ID, the link is - http://pulpito.front.sepia.ceph.co Re-running Tests ---------------- -You can pass ``--rerun`` option, with test ID as an argument to it, to -``teuthology-suite`` command. Generally, this is useful in cases where teuthology test -batch has some failed/dead jobs that we might want to retrigger. We can trigger -jobs based on their status using:: + +The ``teuthology-suite`` command has a ``--rerun`` option, which allows you to +re-run tests. This is handy when your test has failed or is dead. The +``--rerun`` option takes the name of a teuthology run as an argument, as you +can see in the example below: + +.. prompt:: bash $ teuthology-suite -v \ -m smithi \ @@ -251,8 +254,8 @@ jobs based on their status using:: -R fail,dead,queued,running \ -e $CEPH_QA_MAIL -The meaning of the rest the options is already covered in `Triggering Tests`_ -section. +The meaning and function of the other options is covered in the table in the +`Triggering Tests`_ section. Naming the ceph-ci branch -------------------------