mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
Update porting_guide_2.5.rst (#37927)
The example regarding `include_*` is a bit unclear. First it seems like the v2.4 and v2.5 examples are the same. So I attempted to make the relevant change in the examples more obvious. label: docsite_pr
This commit is contained in:
parent
1f54775581
commit
55fd3d62fb
1 changed files with 14 additions and 2 deletions
|
@ -27,8 +27,7 @@ static ``import_*`` would be inherited by the tasks within.
|
||||||
|
|
||||||
This separation was only partially implemented in Ansible version 2.4. As of Ansible version 2.5, this work is complete and the separation now behaves as designed; attributes applied to an ``include_*`` task will not be inherited by the tasks within.
|
This separation was only partially implemented in Ansible version 2.4. As of Ansible version 2.5, this work is complete and the separation now behaves as designed; attributes applied to an ``include_*`` task will not be inherited by the tasks within.
|
||||||
|
|
||||||
To achieve an outcome similar to how Ansible worked prior to version 2.5, playbooks
|
To achieve an outcome similar to how Ansible worked prior to version 2.5, playbooks should use an explicit application of the attribute on the needed tasks, or use blocks to apply the attribute to many tasks. Another option is to use a static ``import_*`` when possible instead of a dynamic task.
|
||||||
should use an explicit application of the attribute on the needed tasks, or use blocks to apply the attribute to many tasks. Another option is to use a static ``import_*`` when possible instead of a dynamic task.
|
|
||||||
|
|
||||||
**OLD** In Ansible 2.4:
|
**OLD** In Ansible 2.4:
|
||||||
|
|
||||||
|
@ -38,6 +37,17 @@ should use an explicit application of the attribute on the needed tasks, or use
|
||||||
tags:
|
tags:
|
||||||
- distro_include
|
- distro_include
|
||||||
|
|
||||||
|
Included file:
|
||||||
|
|
||||||
|
.. code-block:: yaml
|
||||||
|
|
||||||
|
- block:
|
||||||
|
- debug:
|
||||||
|
msg: "In included file"
|
||||||
|
|
||||||
|
- apt:
|
||||||
|
name: nginx
|
||||||
|
state: latest
|
||||||
|
|
||||||
**NEW** In Ansible 2.5:
|
**NEW** In Ansible 2.5:
|
||||||
|
|
||||||
|
@ -63,6 +73,8 @@ Included file:
|
||||||
tags:
|
tags:
|
||||||
- distro_include
|
- distro_include
|
||||||
|
|
||||||
|
The relevant change in those examples is, that in Ansible 2.5, the included file defines the tag ``distro_include`` again. The tag is not inherited automatically.
|
||||||
|
|
||||||
Deprecated
|
Deprecated
|
||||||
==========
|
==========
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue