import_tasks – Import a task list

From Get docs
Ansible/docs/2.7/modules/import tasks module


import_tasks – Import a task list

New in version 2.4.


Synopsis

  • Imports a list of tasks to be added to the current playbook for subsequent execution.

Parameters

Parameter Choices/Defaults Comments

free-form

-

The name of the imported file is specified directly without any other option.

Most keywords, including loops and conditionals, only applied to the imported tasks, not to this statement itself. If you need any of those to apply, use include_tasks instead.



Notes

Note

  • This is a core feature of Ansible, rather than a module, and cannot be overridden like a module.


Examples

- hosts: all
  tasks:
    - debug:
        msg: task1

    - name: Include task list in play
      import_tasks: stuff.yaml

    - debug:
        msg: task10

- hosts: all
  tasks:
    - debug:
        msg: task1

    - name: Apply conditional to all imported tasks
      import_tasks: stuff.yaml
      when: hostvar is defined

Status

Red Hat Support

More information about Red Hat’s support of this module is available from this Red Hat Knowledge Base article.

Authors

  • Ansible Core Team (@ansible)

Hint

If you notice any issues in this documentation you can edit this document to improve it.


© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/import_tasks_module.html