Skip to content

Commit

Permalink
Add core 2.19 porting guide
Browse files Browse the repository at this point in the history
  • Loading branch information
sivel committed Jan 22, 2025
1 parent 1b91cd7 commit c837149
Show file tree
Hide file tree
Showing 2 changed files with 101 additions and 0 deletions.
1 change: 1 addition & 0 deletions docs/docsite/rst/porting_guides/core_porting_guides.rst
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ Please note that this is not a complete list. If you believe any extra informati
:maxdepth: 1
:glob:

porting_guide_core_2.19
porting_guide_core_2.18
porting_guide_core_2.17
porting_guide_core_2.16
Expand Down
100 changes: 100 additions & 0 deletions docs/docsite/rst/porting_guides/porting_guide_core_2.19.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,100 @@

.. _porting_2.19_guide_core:

*******************************
Ansible-core 2.19 Porting Guide
*******************************

This section discusses the behavioral changes between ``ansible-core`` 2.18 and ``ansible-core`` 2.19.

It is intended to assist in updating your playbooks, plugins and other parts of your Ansible infrastructure so they will work with this version of Ansible.

We suggest you read this page along with `ansible-core Changelog for 2.19 <https://github.com/ansible/ansible/blob/stable-2.19/changelogs/CHANGELOG-v2.19.rst>`_ to understand what updates you may need to make.

This document is part of a collection on porting. The complete list of porting guides can be found at :ref:`porting guides <porting_guides>`.

.. contents:: Topics


Playbook
========

No notable changes


Command Line
============

No notable changes


Deprecated
==========

No notable changes


Modules
=======

No notable changes


Modules removed
---------------

The following modules no longer exist:

* No notable changes


Deprecation notices
-------------------

No notable changes


Noteworthy module changes
-------------------------

No notable changes


Plugins
=======

* The ``ssh`` connection plugin now supports using ``SSH_ASKPASS`` to supply passwords
for authentication as an alternative to the ``sshpass`` program. The default is to use
``SSH_ASKPASS`` instead of ``sshpass``. This is controlled by the ``password_mechanism``
configuration for the ``ssh`` connection plugin. To switch back to using ``sshpass``
making one of the following changes:

To your ``ansible.cfg`` file:

.. code-block:: ini
[ssh_connection]
password_mechanism = sshpass
By exporting an environment variable:

.. code-block:: shell
export ANSIBLE_SSH_PASSWORD_MECHANISM=sshpass
By setting the following variable:

.. code-block:: yaml
ansible_ssh_password_mechanism: sshpass
Porting custom scripts
======================

No notable changes


Networking
==========

No notable changes

0 comments on commit c837149

Please sign in to comment.