Documentation

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.

Options

parameter required default choices comments
free-form
no
This action allows you to specify the name of the file directly w/o any other options.
Any loops, conditionals and most other keywords will be applied to the included tasks, not to this statement itself.
If you need any of those to apply to this action, use include_tasks instead.

Examples

# include task list in play
- hosts: all
  tasks:
    - debug:
        msg: task1

    - import_tasks: stuff.yml

    - debug:
        msg: task10

# apply conditional to all imported tasks
- hosts: all
  tasks:
    - debug:
        msg: task1

    - import_tasks: stuff.yml
      when: hostvar is defined

Notes

Note

  • This is really not a module, this is a feature of the Ansible Engine, as such it cannot be overridden the same way a module can.

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Maintenance Info

For more information about Red Hat’s this support of this module, please refer to this knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.