From 9e5f60855feca325c95070f4d371a75bc91bca0b Mon Sep 17 00:00:00 2001 From: Abhijeet Kasurde Date: Fri, 19 Jul 2024 10:35:04 -0700 Subject: [PATCH] Add a note for --start-at-task add a note stating what --start-at-task can and cannot address Signed-off-by: Abhijeet Kasurde --- docs/docsite/rst/playbook_guide/playbooks_startnstep.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/docsite/rst/playbook_guide/playbooks_startnstep.rst b/docs/docsite/rst/playbook_guide/playbooks_startnstep.rst index 22fade9760e..77593ab1d94 100644 --- a/docs/docsite/rst/playbook_guide/playbooks_startnstep.rst +++ b/docs/docsite/rst/playbook_guide/playbooks_startnstep.rst @@ -19,6 +19,14 @@ To start executing your playbook at a particular task (usually the task that fai In this example, Ansible starts executing your playbook at a task named "install packages". This feature does not work with tasks inside dynamically re-used roles or tasks (``include_*``), see :ref:`dynamic_vs_static`. +.. note:: + + Moreover, ``--start-at-task`` + - can target tasks **within** static includes + - cannot target tasks **within** dynamic includes + - can target the dynamic include task itself + - cannot target the static include task itself + .. _step: Step mode