import_playbook - Import a playbook¶

New in version 2.4.

Synopsis
Parameters
Notes
Examples
Status
Maintenance
- Support
- Author

Synopsis ¶

Includes a file with a list of plays to be executed.
Files with a list of plays can only be included at the top level. You cannot use this action inside a play.

Parameters ¶

Parameter	Choices/Defaults	Comments
free-form		The name of the imported playbook is specified directly without any other option.

Notes ¶

Note

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

Examples ¶

- hosts: localhost
  tasks:
    - debug:
        msg: play1

- name: Include a play after another play
  import_playbook: otherplays.yaml


- name: This DOES NOT WORK
  hosts: all
  tasks:
    - debug:
        msg: task1

    - name: This fails because I'm inside a play already
      import_playbook: stuff.yaml

Status ¶

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

Maintenance ¶

This module is flagged as core which means that it is maintained by the Ansible Core Team. See Module Maintenance & Support for more info.

For a list of other modules that are also maintained by the Ansible Core Team, see here.

Support ¶

For more information about Red Hat’s support of this module, please refer to this Knowledge Base article

Author ¶

Ansible Core Team (@ansible)

Hint

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