Documents the --step and --start-at options to ansible-playbook. Fixes #9041.

This commit is contained in:
Stephen Jahl 2014-10-03 19:45:35 -04:00
parent 94db7365b9
commit 1d05be82f0

View file

@ -335,6 +335,25 @@ Let's run a playbook using a parallelism level of 10::
ansible-playbook playbook.yml -f 10
Playbooks can also be executed interactively with ``--step``::
ansible-playbook playbook.yml --step
This will cause ansible to stop on each task, and ask if it should execute that task.
Say you had a task called "configure ssh", the playbook run will stop and ask::
Perform task: configure ssh (y/n/c):
Answering "y" will execute the task, answering "n" will skip the task, and answering "c"
will continue executing all the remaining tasks without asking.
If you want to start executing your playbook at a particular task, you can do so
with the ``--start-at`` option::
ansible-playbook playbook.yml --start-at="install packages"
The above will start executing your playbook at a task named "install packages".
.. _ansible-pull:
Ansible-Pull