Document follow changes

Add the file, blockinfile, and replace changes to the follow parameter
to the porting guide

(cherry picked from commit 1885883a88)
pull/39703/head
Toshio Kuratomi 7 years ago
parent aa6c60ea80
commit 4d9895ad93

@ -167,6 +167,19 @@ and ``checksum_algorithm: md5`` can still be used if an MD5 checksum is
desired. desired.
* ``osx_say`` module was renamed into :ref:`say <say_module>`. * ``osx_say`` module was renamed into :ref:`say <say_module>`.
* Several modules which could deal with symlinks had the default value of their ``follow`` option
changed as part of a feature to `standardize the behavior of follow
<https://github.com/ansible/proposals/issues/69>`_:
* The :ref:`file module <file_module>` changed from ``follow=False`` to ``follow=True`` because
its purpose is to modify the attributes of a file and most systems do not allow attributes to be
applied to symlinks, only to real files.
* The :ref:`replace module <replace_module>` had its ``follow`` parameter removed because it
inherently modifies the content of an existing file so it makes no sense to operate on the link
itself.
* The :ref:`blockinfile module <blockinfile_module>` had its ``follow`` parameter removed because
it inherently modifies the content of an existing file so it makes no sense to operate on the
link itself.
Plugins Plugins
======= =======
@ -180,7 +193,7 @@ Inventory plugins have been fine tuned, and we have started to add some common f
* The ability to use a cache plugin to avoid costly API/DB queries is disabled by default. * The ability to use a cache plugin to avoid costly API/DB queries is disabled by default.
If using inventory scripts, some may already support a cache, but it is outside of Ansible's knowledge and control. If using inventory scripts, some may already support a cache, but it is outside of Ansible's knowledge and control.
Moving to the interal cache will allow you to use Ansible's existing cache refresh/invalidation mechanisms. Moving to the internal cache will allow you to use Ansible's existing cache refresh/invalidation mechanisms.
* A new 'auto' plugin, enabled by default, that can automatically detect the correct plugin to use IF that plugin is using our 'common YAML configuration format'. * A new 'auto' plugin, enabled by default, that can automatically detect the correct plugin to use IF that plugin is using our 'common YAML configuration format'.
The previous host_list, script, yaml and ini plugins still work as they did, the auto plugin is now the last one we attempt to use. The previous host_list, script, yaml and ini plugins still work as they did, the auto plugin is now the last one we attempt to use.

Loading…
Cancel
Save