You are reading an unmaintained version of the Ansible documentation. Unmaintained Ansible versions can contain unfixed security vulnerabilities (CVE). Please upgrade to a maintained version. See the latest Ansible documentation.

import_tasks - Import a task list¶

New in version 2.4.

Synopsis
Options
Examples
Notes
- Status
- Maintenance Info

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			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.

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

Notes ¶

Note

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

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.