From 36121aeee7812e7f37dd49a64c0dbf9cf741878f Mon Sep 17 00:00:00 2001 From: David Moreau Simard Date: Tue, 22 Feb 2022 13:03:42 -0500 Subject: [PATCH] docs: Update porting guide for ansible 5.4.0 (#77107) --- .../rst/porting_guides/porting_guide_5.rst | 38 ++++++++++++++++++- 1 file changed, 37 insertions(+), 1 deletion(-) diff --git a/docs/docsite/rst/porting_guides/porting_guide_5.rst b/docs/docsite/rst/porting_guides/porting_guide_5.rst index 667a2d51bf9..14a2ea425bc 100644 --- a/docs/docsite/rst/porting_guides/porting_guide_5.rst +++ b/docs/docsite/rst/porting_guides/porting_guide_5.rst @@ -1,5 +1,5 @@ .. - THIS DOCUMENT IS AUTOMATICALLY GENERATED BY ANTSIBULL! PLEASE DO NOT EDIT MANUALLY! (YOU PROBABLY WANT TO EDIT porting_guide_base_2.12.rst) + THIS DOCUMENT IS AUTOMATICALLY GENERATED BY ANTSIBULL! PLEASE DO NOT EDIT MANUALLY! (YOU PROBABLY WANT TO EDIT porting_guide_core_2.12.rst) .. _porting_5_guide: @@ -12,6 +12,9 @@ Ansible 5 Porting Guide :depth: 2 +Ansible 5 is based on Ansible-core 2.12. + + We suggest you read this page along with the `Ansible 5 Changelog `_ to understand what updates you may need to make. @@ -31,6 +34,15 @@ Playbook vars: ansible_async_dir: /path/to/my/custom/dir +* The ``undef()`` function is added to the templating environment for creating undefined variables directly in a template. Optionally, a hint may be provided for variables which are intended to be overridden. + +.. code-block:: yaml + + vars: + old: "{{ undef }}" + new: "{{ undef() }}" + new_with_hint: "{{ undef(hint='You must override this variable') }}" + Python Interpreter Discovery ============================ @@ -115,6 +127,30 @@ Networking No notable changes +Porting Guide for v5.4.0 +======================== + +Major Changes +------------- + +chocolatey.chocolatey +~~~~~~~~~~~~~~~~~~~~~ + +- win_chocolatey - Added choco_args option to pass additional arguments directly to Chocolatey. + +vyos.vyos +~~~~~~~~~ + +- Add 'pool' as value to server key in ntp_global. + +Deprecated Features +------------------- + +cisco.ios +~~~~~~~~~ + +- `ios_acls` - Deprecated fragment attribute added boolean alternate as enable_fragment. + Porting Guide for v5.3.0 ========================