From 57935babd878abec0bb4c8f38c881b1ed8c420e6 Mon Sep 17 00:00:00 2001 From: Harm te Hennepe Date: Tue, 6 May 2025 18:32:17 +0200 Subject: [PATCH] Update interpreter_discovery for changes made in ansible-core 2.17 (#2438) * Update interpreter_discovery for changes made in ansible-core 2.17 * Mention the list searched * Minor wording improvement * Remove unnecessary note * Revert realignment * Remove trailing space * Apply suggestions from code review Co-authored-by: Sloane Hertel <19572925+s-hertel@users.noreply.github.com> --------- Co-authored-by: Sloane Hertel <19572925+s-hertel@users.noreply.github.com> (cherry picked from commit 02282b8d6d26ce584a85472526586ca8b65a81c4) --- .../interpreter_discovery.rst | 44 +++++-------------- 1 file changed, 12 insertions(+), 32 deletions(-) diff --git a/docs/docsite/rst/reference_appendices/interpreter_discovery.rst b/docs/docsite/rst/reference_appendices/interpreter_discovery.rst index 23d1d970929..1440d7c0ae4 100644 --- a/docs/docsite/rst/reference_appendices/interpreter_discovery.rst +++ b/docs/docsite/rst/reference_appendices/interpreter_discovery.rst @@ -13,39 +13,19 @@ To control the discovery behavior: * for individual hosts and groups, use the ``ansible_python_interpreter`` inventory variable * globally, use the ``interpreter_python`` key in the ``[defaults]`` section of ``ansible.cfg`` -Use one of the following values: +Configure a path to a specific Python interpreter, or one of the following values: + +auto (default) : + Searches the configurable list of common Python interpreter paths + (see :ref:`INTERPRETER_PYTHON_FALLBACK`) and issues a warning that + future installation of another Python interpreter could alter the one chosen. auto_legacy : - Detects the target OS platform, distribution, and version, then consults a - table listing the correct Python interpreter and path for each - platform/distribution/version. If an entry is found, and ``/usr/bin/python`` is absent, uses the discovered interpreter (and path). If an entry - is found, and ``/usr/bin/python`` is present, uses ``/usr/bin/python`` - and issues a warning. - This exception provides temporary compatibility with previous versions of - Ansible that always defaulted to ``/usr/bin/python``, so if you have - installed Python and other dependencies at ``/usr/bin/python`` on some hosts, - Ansible will find and use them with this setting. - If no entry is found, or the listed Python is not present on the - target host, searches a list of common Python interpreter - paths and uses the first one found; also issues a warning that future - installation of another Python interpreter could alter the one chosen. - -auto : (default in 2.12) - Detects the target OS platform, distribution, and version, then consults a - table listing the correct Python interpreter and path for each - platform/distribution/version. If an entry is found, uses the discovered - interpreter. - If no entry is found, or the listed Python is not present on the - target host, searches a list of common Python interpreter - paths and uses the first one found; also issues a warning that future - installation of another Python interpreter could alter the one chosen. - -auto_legacy_silent - Same as ``auto_legacy``, but does not issue warnings. - -auto_silent + Deprecated alias for ``auto``. + +auto_silent : Same as ``auto``, but does not issue warnings. -You can still set ``ansible_python_interpreter`` to a specific path at any -variable level (for example, in host_vars, in vars files, in playbooks, and so on). -Setting a specific path completely disables automatic interpreter discovery; Ansible always uses the path specified. +auto_legacy_silent : + Deprecated alias for ``auto_silent``. +