From 0406f0dcf2c9eda2c4bd2331376db27171067c7b Mon Sep 17 00:00:00 2001 From: "Karl O. Pinc" Date: Wed, 25 Dec 2024 12:20:25 -0600 Subject: [PATCH] Included handlers can be notified, but only by the included code The old text can easily be (mis)read as: "Cannot trigger handlers (from) within includes". --- .../rst/playbook_guide/playbooks_reuse.rst | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/docsite/rst/playbook_guide/playbooks_reuse.rst b/docs/docsite/rst/playbook_guide/playbooks_reuse.rst index c4c5966d54c..5c818733757 100644 --- a/docs/docsite/rst/playbook_guide/playbooks_reuse.rst +++ b/docs/docsite/rst/playbook_guide/playbooks_reuse.rst @@ -116,34 +116,34 @@ Each approach to re-using distributed Ansible artifacts has advantages and limit .. table:: :class: documentation-table - ========================= ======================================== ======================================== - .. Include_* Import_* - ========================= ======================================== ======================================== - Type of reuse Dynamic Static + ========================= ================================================== ======================================== + .. Include_* Import_* + ========================= ================================================== ======================================== + Type of reuse Dynamic Static - When processed At runtime, when encountered Pre-processed during playbook parsing + When processed At runtime, when encountered Pre-processed during playbook parsing - Task or play All includes are tasks ``import_playbook`` cannot be a task + Task or play All includes are tasks ``import_playbook`` cannot be a task - Task options Apply only to include task itself Apply to all child tasks in import + Task options Apply only to include task itself Apply to all child tasks in import - Calling from loops Executed once for each loop item Cannot be used in a loop + Calling from loops Executed once for each loop item Cannot be used in a loop - Using ``--list-tags`` Tags within includes not listed All tags appear with ``--list-tags`` + Using ``--list-tags`` Tags within includes not listed All tags appear with ``--list-tags`` - Using ``--list-tasks`` Tasks within includes not listed All tasks appear with ``--list-tasks`` + Using ``--list-tasks`` Tasks within includes not listed All tasks appear with ``--list-tasks`` - Notifying handlers Cannot trigger handlers within includes Can trigger individual imported handlers + Notifying handlers Including code cannot trigger included handlers Can trigger individual imported handlers - Using ``--start-at-task`` Cannot start at tasks within includes Can start at imported tasks + Using ``--start-at-task`` Cannot start at tasks within includes Can start at imported tasks - Using inventory variables Can ``include_*: {{ inventory_var }}`` Cannot ``import_*: {{ inventory_var }}`` + Using inventory variables Can ``include_*: {{ inventory_var }}`` Cannot ``import_*: {{ inventory_var }}`` - With playbooks No ``include_playbook`` Can import full playbooks + With playbooks No ``include_playbook`` Can import full playbooks - With variables files Can include variables files Use ``vars_files:`` to import variables + With variables files Can include variables files Use ``vars_files:`` to import variables - ========================= ======================================== ======================================== + ========================= ================================================== ======================================== .. note::