From: Andrew Schoen Date: Wed, 14 Jan 2015 22:39:26 +0000 (-0600) Subject: Additional information about the interative task in the README X-Git-Tag: 1.1.0~1044^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=cb272410053c2d0357dedb31cf4845d16e5753ff;p=teuthology.git Additional information about the interative task in the README Signed-off-by: Andrew Schoen --- diff --git a/README.rst b/README.rst index d25a7ede3..4b05529d9 100644 --- a/README.rst +++ b/README.rst @@ -289,9 +289,22 @@ Interactive task facilities The ``interactive`` task presents a prompt for you to interact with the teuthology configuration. The ``ctx`` variable is available to explore, and a ``pprint.PrettyPrinter().pprint`` object is added for convenience as -'pp', so you can do things like pp(dict-of-interest) to see a formatted +``pp``, so you can do things like pp(dict-of-interest) to see a formatted view of the dict. +This is also useful to pause the execution of the test between two tasks, +either to perform ad hoc operations, or to examine the state of the cluster. +Hit ``control-D`` to continue when done. + +You need to nest ``interactive`` underneath of ``tasks`` in your config. You +can have has many ``interactive`` tasks as needed in your task list. + +An example:: + + tasks: + - ceph: + - interactive: + Test Sandbox Directory ======================