mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
undeprecate include
defering deprecation until we are comfortable that the new actions cover most of the ground users need.
This commit is contained in:
parent
dcd1c40e66
commit
4dcc5588f6
1 changed files with 4 additions and 5 deletions
|
@ -19,10 +19,6 @@ DOCUMENTATION = '''
|
|||
author: Ansible Core Team (@ansible)
|
||||
module: include
|
||||
short_description: Include a play or task list
|
||||
deprecated:
|
||||
removed_in: "2.8"
|
||||
why: The include action was too confusing, dealing with both plays and tasks, being both dynamic and static. This module will be removed in version 2.8.
|
||||
alternative: Use M(include_tasks), M(import_playbook), M(import_tasks).
|
||||
description:
|
||||
- Includes a file with a list of plays or tasks to be executed in the current playbook.
|
||||
- Files with a list of plays can only be included at the top level. Lists of tasks can only be included where tasks
|
||||
|
@ -41,7 +37,10 @@ options:
|
|||
- This module allows you to specify the name of the file directly without any other options.
|
||||
notes:
|
||||
- This is a core feature of Ansible, rather than a module, and cannot be overridden like a module.
|
||||
- This module is also supported for Windows targets.
|
||||
- Include has some unintuitive behaviours depending on if it is running in a static or dynamic in play or in playbook context,
|
||||
in an effort to clarify behaviours we are moving to a new set modules (M(include_tasks), M(include_role), M(import_playbook), M(import_tasks))
|
||||
that have well established and clear behaviours.
|
||||
This module will still be supported for some time but we are looking at deprecating it in the near future.
|
||||
'''
|
||||
|
||||
EXAMPLES = """
|
Loading…
Reference in a new issue