diff --git a/docsite/rst/playbooks_intro.rst b/docsite/rst/playbooks_intro.rst index cc55f282613..4bc3bccf2d8 100644 --- a/docsite/rst/playbooks_intro.rst +++ b/docsite/rst/playbooks_intro.rst @@ -335,25 +335,6 @@ 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 diff --git a/docsite/rst/playbooks_startnstep.rst b/docsite/rst/playbooks_startnstep.rst index 1238a710d8a..c2f0d7514ca 100644 --- a/docsite/rst/playbooks_startnstep.rst +++ b/docsite/rst/playbooks_startnstep.rst @@ -1,12 +1,13 @@ Start and Step ====================== -.. versionadded:: 1.8 .. contents:: Topics This shows a few special ways to run playbooks, very useful for testing and debugging. +.. _start_at_task + Start-at-task ````````````` .. versionadded:: 1.2 @@ -19,6 +20,8 @@ with the ``--start-at`` option:: The above will start executing your playbook at a task named "install packages". +.. _step + Step ```` .. versionadded:: 1.1