Latest revision as of 05:21, 7 July 2021

Internal

All import_* statements are pre-processed at the time the playbook is parsed. Import is static.

All include_* statements are processed as they are encountered at runtime during the playbook execution. Include is dynamic.

Import should be used when dealing with logical "units". For example, include a separate long list of tasks into subtask files:

main.yml:

- import_tasks: prepare_filesystem.yml
- import_tasks: install_prerequisites.yml
- import_tasks: install_application.yml

Include should be used to deal with different workflows and take decisions based on dynamically gathered facts:

- include_tasks: prerequisites_{{ ansible_os_family | lower }}.yml

or

- include_tasks: some-tasks.yml
  when: something == "something else"

@@ Line 1: / Line 1: @@
 =Internal=
 * [[Ansible_Module_include_tasks#Difference_between_include_tasks_and_import_tasks|include_tasks]]
+* [[Ansible_Module_import_tasks#Difference_between_include_tasks_and_import_tasks|import_tasks]]
+=Overview=
+All <code>import_*</code> statements are pre-processed at the time the playbook is parsed. Import is static.
+All <code>include_*</code> statements are processed as they are encountered at runtime during the playbook execution. Include is dynamic.
+Import should be used when dealing with logical "units". For example, include a separate long list of tasks into subtask files:
+main.yml:
+<syntaxhighlight lang='yaml'>
+- import_tasks: prepare_filesystem.yml
+- import_tasks: install_prerequisites.yml
+- import_tasks: install_application.yml
+</syntaxhighlight>
+Include should be used to deal with different workflows and take decisions based on dynamically gathered facts:
+<syntaxhighlight lang='yaml'>
+- include_tasks: prerequisites_{{ ansible_os_family | lower }}.yml
+</syntaxhighlight>
+or
+<syntaxhighlight lang='yaml'>
+- include_tasks: some-tasks.yml
+  when: something == "something else"
+</syntaxhighlight>