Script 'mail_helper' called by obssrc
Hello community,
here is the log from the commit of package ansible-documentation for
openSUSE:Factory checked in at 2025-11-21 16:54:48
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Comparing /work/SRC/openSUSE:Factory/ansible-documentation (Old)
and /work/SRC/openSUSE:Factory/.ansible-documentation.new.2061 (New)
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "ansible-documentation"
Fri Nov 21 16:54:48 2025 rev:31 rq:1318790 version:2.20.0
Changes:
--------
---
/work/SRC/openSUSE:Factory/ansible-documentation/ansible-documentation.changes
2025-11-06 18:13:55.681251773 +0100
+++
/work/SRC/openSUSE:Factory/.ansible-documentation.new.2061/ansible-documentation.changes
2025-11-21 16:55:43.235938754 +0100
@@ -1,0 +2,244 @@
+Fri Nov 07 16:11:43 UTC 2025 - Johannes Kastl
<[email protected]>
+
+- Update to version 2.20.0:
+ * ci: refresh dev dependencies (#3196)
+ * Add the Ansible community 13.0.0a5 porting guide (#3191)
+ (#3192)
+ * ci: refresh dev dependencies (#3180)
+ * Update maximum galaxy artifact size (#3099) (#3178)
+ * Add the Ansible community 13.0.0a4 porting guide (#3174)
+ (#3175)
+ * Bump wntrblm/nox from 2025.05.01 to 2025.10.16 (#3169)
+ * Add 2.20 porting guide (#3138) (#3164)
+ * docs: clarify dict2items usage in loops with group module
+ (follow-up to ansible#85897) (#3124) (#3158)
+ * Update platform_routeros.rst (#3097) (#3162)
+ * fix 2.19 porting guide for correct option (#3102) (#3154)
+ * ci: refresh dev dependencies (#3146)
+ * Add the Ansible community 13.0.0a3 porting guide (#3139)
+ (#3140)
+ * remove old summit banner (#3131) (#3136)
+ * ci: refresh dev dependencies (#3125)
+ * Intersphinx (#3089) (#3123)
+ * minor typo fix (#3117) (#3121)
+ * replace role removed in Ansible 11 (#3118) (#3120)
+ * Add the Ansible community 11.11.0 porting guide (#3108) (#3115)
+ * Add the Ansible community 13.0.0a2 porting guide (#3110)
+ (#3116)
+ * Add the Ansible community 12.1.0 porting guide (#3109) (#3112)
+ * Update WinRM Listener Code (#3101) (#3107)
+ * bump antsibull-docs-parser to fix build issues (#3098)
+ * ci: refresh dev dependencies (#3091)
+ * ci: refresh dev dependencies (#3080)
+ * Add ansible-core 2.20 to maintenance info (#3075) (#3078)
+ * [stable-2.20] Update the stable-2.20 branch (#3072)
+ * Add the Ansible community 13.0.0a1 porting guide (#3076)
+ (#3077)
+ * ci: refresh dev dependencies (#3067)
+ * ci: refresh docs build dependencies (#3070)
+ * Per issue [#3063], removing stable-2.16 session (#3064)
+ * Ansible 13 roadmap (#3000)
+ * ci: refresh dev dependencies (#3061)
+ * ci: refresh docs build dependencies (#3062)
+ * Add deps refresh guidance for maintainers (#3024)
+ * bump latest to 12 in the scheduled docs build (#3053)
+ * add core 2.19 docs to package docs (#3050)
+ * update latest version to Ansible 12 (#2964)
+ * Update the release table for Ansible 12 (#2963)
+ * Bump actions/setup-python from 5 to 6 (#3035)
+ * Add the Ansible community 11.10.0 porting guide (#3043)
+ * Add the Ansible community 12.0.0 porting guide
+ * community/maintainers_workflow.rst: improve wording and
+ formatting (#3008)
+ * ci: refresh dev dependencies (#3030)
+ * ci: refresh docs build dependencies (#3034)
+ * docs: fix typos and clarify wording in community docs (#3023)
+ * Add the Ansible community 12.0.0rc1 porting guide (#3021)
+ * ci: refresh dev dependencies (#3016)
+ * ci: refresh docs build dependencies (#3019)
+ * Add example of unintentional None to 2.19 porting guide (#2982)
+ * Harmonize formatting of group names in
+ docs/docsite/rst/inventory_guide/intro_inventory.rst (#2980)
+ * Bump actions/checkout from 4 to 5 (#3007)
+ * ci: refresh docs build dependencies (#3006)
+ * ci: refresh dev dependencies (#3004)
+ * 2.20 Roadmap (#2997)
+ * Add the Ansible community 12.0.0b4 porting guide (#2998)
+ * 2.19 EOL is 2026 (#2995)
+ * Bump actions/download-artifact from 4 to 5 (#2981)
+ * ci: refresh docs build dependencies (#2993)
+ * ci: refresh dev dependencies (#2988)
+ * [devel] Bump antsibull-docs to 2.21.0; include list of all
+ deprecated collections and modules/plugins (#2979)
+ * Add the Ansible community 11.9.0 porting guide
+ * ci: refresh dev dependencies (#2973)
+ * ci: refresh docs build dependencies (#2978)
+ * ci: refresh docs build dependencies (#2954)
+ * ci: refresh dev dependencies (#2952)
+ * Update supported Python versions. (#2935)
+ * Revert "community/maintainers_workflow.rst: improve wording and
+ formatting (#…" (#2956)
+ * Add the Ansible community 12.0.0b3 porting guide (#2957)
+ * Update EOL banner for clarity (#2942)
+ * missed a few python 3.12 updates (#2936)
+ * update banner to reflect this does not apply to the product
+ (#2895)
+ * ci: refresh docs build dependencies (#2913)
+ * update for control node min. python 3.12 now (#2934)
+ * community/maintainers_workflow.rst: improve wording and
+ formatting (#2799)
+ * Document Windows App Control Feature (#2654)
+ * ci: refresh dev dependencies (#2909)
+ * [devel] ci: refresh docs build dependencies (#2905)
+ * playbook_guide/playbooks_variables.rst: improve style.
+ Assisted-by: AI (#2916)
+ * rst/playbook_guide/playbooks_intro.rst: improve. Assisted-by:
+ AI (#2915)
+ * Add missing comma in introduction.rst (#2914)
+ * Update docs windows_winrm for ansible module (#2904)
+ * Update docs in the readme and maintainers guide (#2766)
+ * add details on some plugin options - AI-assisted (#2813)
+ * Styleguide update for installation_distros.rst - AI-assisted
+ (#2855)
+ * porting guide 2.19: document range() changes (#2832)
+ * update backport instructions (#2886)
+ * release_and_maintenance.rst: reflect that 2.16 is EOL (#2770)
+ * porting guide 2.19: nicer rendering for Ansible output (#2877)
+ * Fix indent for other keys like :Version Added:. (#2880)
+ * Add the Ansible community 12.0.0b1 porting guide (#2876)
+ * Fixed minor grammatical errors (#2867)
+ * dev_guide/style_guide/spelling_word_choice.rst: See vs Refer to
+ (#2868)
+ * Fixes #2830 uses actions/create-github-app-token@v2 (#2831)
+ * Ansible configuration: improve deprecation messages (#2823)
+ * Code block languages: normalize casing of `yaml` and
+ `yaml+jinja`, update list in style guide, add comments to keep
+ lists in sync (#2848)
+ * Update removal/readd processes to refer to the documentation of
+ ansible-build-data (#2821)
+ * core-2.19 prep - update versioning (#2810)
+ * inventory_guide/intro_inventory.rst: improve style. Assisted-by
+ AI (#2834)
+ * porting guide 2.19 - describe lazy complex var eval impact on
+ builtin filters/tests (#2639)
+ * ci: refresh dev dependencies (#2842)
+ * Correct year of contingency date to create ansible-build-data
+ for Ansible 13 (#2846)
+ * [devel] ci: refresh docs build dependencies (#2838)
+ * Add more International Communities (#2833)
+ * Adds Porting Guide for 11.8.0
+ * community/maintainers_guidelines.rst: improve the document.
+ Assisted-by: Gemini (#2808)
+ * Moves boolean table to module docs (#2812)
+ * ci: refresh dev dependencies (#2803)
+ * Use antsibull-docutils 1.2.0 to simplify rst-yamllint checker.
+ (#2745)
+ * Initial (GHA) Workflow for creating the Porting Guide (#121)
+ * Avoid all literal blocks without explicitly set language
+ (#2807)
+ * ci: refresh docs build dependencies (#2806)
+ * fix option for '_ANSIBLE_TEMPLAR_UNTRUSTED_TEMPLATE_BEHAVIOR'
+ (#2687)
+ * Add initial README.md for tests/ requirement files (#2577)
+ * Add more Windows Kerberos delegation info (#2779)
+ * Update 2.19 release date in support matrix (#2744)
+ * community/communication.rst: improve style a bit (#2790)
+ * Adds Porting Guide for 12.0.0a9
+ * ci: refresh dev dependencies (#2784)
+ * ci: refresh docs build dependencies (#2787)
+ * Announce Ansible 11 lifetime extension (#2491)
+ * Move Ansible markup documentation to a separate page (#2753)
+ * ci: refresh dev dependencies (#2774)
+ * ci: refresh docs build dependencies (#2776)
+ * communication.rst: improve wording (#2765)
+ * Update Ansible 12 porting guide for 12.0.0a7 release (#2761)
+ * ci: refresh dev dependencies (#2760)
+ * [devel] ci: refresh docs build dependencies: bump
+ antsibull-docs to 2.18.0 (#2756)
+ * ci: refresh dev dependencies (#2751)
+ * ci: refresh docs build dependencies (#2752)
+ * ci: refresh docs build dependencies (#2742)
+ * ci: refresh dev dependencies (#2736)
+ * Add Ansible 11.7.0 porting guide. (#2732)
+ * Update windows_winrm.rst (#2721)
+ * ci: refresh dev dependencies (#2725)
+ * ci: refresh docs build dependencies (#2729)
+ * Declare that Galaxy artifacts must not be deleted once they
+ appear in Ansible releases. (#2678)
+ * Adjust indentation in sidecar docs (#2714)
+ * Update Ansible 12 porting guide for 12.0.0a6 release (#2715)
+ * Update intro_inventory.rst (#2708)
+ * Fix core banner (#2706)
+ * ci: refresh dev dependencies (#2704)
+ * ci: refresh docs build dependencies (#2705)
+ * ansible-core versioning scheme docs (#2666)
+ * unreachable hosts do not execute the always section either
+ (#2663)
+ * Remove redundant comment filter example (#2674)
+ * update Fest banner for slides coming soon (#2688)
+ * Add porting guide for Ansible 12.0.0a5. (#2685)
+ * [devel] ci: refresh docs build dependencies, bump
+ antsibull-docs to 2.17.0 (#2677)
+ * Adjust Ansible 12's release schedule to ansible-core 2.19's
+ updated schedule (#2664)
+ * Extension for Ansible redirects (#2418)
+ * update 2.19 roadmap for extended beta (#2679)
+ * ci: refresh dev dependencies (#2671)
+ * ci: refresh docs build dependencies (#2672)
+ * ci: refresh docs build dependencies (#2662)
+ * ci: refresh dev dependencies (#2658)
+ * intro_bsd.rs: remove deprecated yaml callback (#2573)
+ * add sphinx nitpick_ignore_regex configuration (#2649)
+ * collection_requirements: add requirements version specification
+ recommendation to avoid conflicts when building EEs (#2585)
+ * Add Ansible 11.6.0 porting guide. (#2646)
+ * ci: refresh docs build dependencies (#2645)
+ * ci: refresh dev dependencies (#2641)
+ * Add banner for templating to devel docs (#2627)
+ * Add extra sentence about testing core first (#2619)
+ * maintainer_guidelines: update (#2632)
+ * Fix inputs in the deploy workflow (#2634)
+ * Add 12.0.0a4 porting guide. (#2630)
+ * Fix a few examples in docs that are not 2.19 compatible (#2581)
+ * add 12 porting guide to the index
+ * ci: refresh docs build dependencies (#2626)
+ * ci: refresh dev dependencies (#2622)
+ * Fix docs build (#2617)
+ * Use correct underlines for subsubsections. (#2615)
+ * Add Ansible 12.0.0a3 porting guide. (#2613)
+ * remove some yaml code-block items to fix CI (#2612)
+ * Update playbooks_filters.rst (#2404)
+ * Update interpreter_discovery for changes made in ansible-core
+ 2.17 (#2438)
+ * Only run pr_labeler on devel or stable-* branches (#2552)
+ * First pass at adding notes requested in #1638 (#2566)
+ * porting guide 2.19: async_status started/finished (#2576)
+ * Update networking guides to be compatible with ansible-core
+ 2.18+. (#2586)
+ * Bump wntrblm/nox from 2025.02.09 to 2025.05.01 (#2593)
+ * ci: refresh dev dependencies (#2588)
+ * ci: refresh docs build dependencies (#2592)
+ * Build and deploy from the devel branch once a week, preferably
+ at the… (#2486)
+ * add EXAMPLE to sample passwords etc (#2574)
+ * Add one sentence per line to the style guide (#2470)
+ * ci: refresh docs build dependencies (#2572)
+ * ci: refresh dev dependencies (#2568)
+ * porting_guide_core_2.19.rst: add clatifications on the required
+ non-string key conversion (#2560)
+ * Update Ansible 12 porting guide for 12.0.0a2 release (#2562)
+ * Update example image from `fedora:39` to `fedora:42` (#2541)
+ * Update developing_modules_documenting.rst (#2551)
+ * Additional porting guide entries (#2531)
+ * Update Ansible 11 porting guide for 11.5.0 release (#2547)
+ * ci: refresh dev dependencies (#2539)
+ * ci: refresh docs build dependencies (#2540)
+ * Apply porting guide fix. (#2532)
+ * Module format and doc: tidy up (#2502)
+ * update devel workflows for stable-2.19 (#2523)
+ * Add porting guide for Ansible 12.0.0a1 (#2527)
+ * Update core support matrix 2.19 (#2524)
+ * WIP 2.19 Porting Guide stub with data tagging (#2429)
+ * add 12 to package docs build workflow (#2525)
+
+-------------------------------------------------------------------
Old:
----
ansible-documentation-2.19.4.obscpio
New:
----
ansible-documentation-2.20.0.obscpio
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Other differences:
------------------
++++++ ansible-documentation.spec ++++++
--- /var/tmp/diff_new_pack.3nIhAy/_old 2025-11-21 16:55:44.367986458 +0100
+++ /var/tmp/diff_new_pack.3nIhAy/_new 2025-11-21 16:55:44.371986627 +0100
@@ -17,7 +17,7 @@
Name: ansible-documentation
-Version: 2.19.4
+Version: 2.20.0
Release: 0
Summary: Ansible community documentation and example files
License: GPL-3.0-only
++++++ _service ++++++
--- /var/tmp/diff_new_pack.3nIhAy/_old 2025-11-21 16:55:44.403987975 +0100
+++ /var/tmp/diff_new_pack.3nIhAy/_new 2025-11-21 16:55:44.407988143 +0100
@@ -3,7 +3,7 @@
<param name="url">https://github.com/ansible/ansible-documentation</param>
<param name="scm">git</param>
<param name="exclude">.git</param>
- <param name="revision">v2.19.4</param>
+ <param name="revision">v2.20.0</param>
<param name="versionformat">@PARENT_TAG@</param>
<param name="versionrewrite-pattern">v(.*)</param>
<param name="changesgenerate">enable</param>
++++++ _servicedata ++++++
--- /var/tmp/diff_new_pack.3nIhAy/_old 2025-11-21 16:55:44.431989155 +0100
+++ /var/tmp/diff_new_pack.3nIhAy/_new 2025-11-21 16:55:44.435989324 +0100
@@ -1,6 +1,6 @@
<servicedata>
<service name="tar_scm">
<param
name="url">https://github.com/ansible/ansible-documentation</param>
- <param
name="changesrevision">e4cca7c5d18391fe5db732286fe9583ff7a4929a</param></service></servicedata>
+ <param
name="changesrevision">99dbb9dcb1e6eb1dde008606c19fea412bfbe28f</param></service></servicedata>
(No newline at EOF)
++++++ ansible-documentation-2.19.4.obscpio ->
ansible-documentation-2.20.0.obscpio ++++++
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/ansible-documentation-2.19.4/.readthedocs.yaml
new/ansible-documentation-2.20.0/.readthedocs.yaml
--- old/ansible-documentation-2.19.4/.readthedocs.yaml 2025-11-03
10:59:30.000000000 +0100
+++ new/ansible-documentation-2.20.0/.readthedocs.yaml 2025-11-03
10:58:52.000000000 +0100
@@ -8,7 +8,7 @@
os: ubuntu-22.04
tools:
python: >-
- 3.11
+ 3.12
# Build with make coredocs
commands:
- python -m venv "${READTHEDOCS_VIRTUALENV_PATH}"
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/ansible-documentation-2.19.4/MAINTAINERS.md
new/ansible-documentation-2.20.0/MAINTAINERS.md
--- old/ansible-documentation-2.19.4/MAINTAINERS.md 2025-11-03
10:59:30.000000000 +0100
+++ new/ansible-documentation-2.20.0/MAINTAINERS.md 2025-11-03
10:58:52.000000000 +0100
@@ -11,7 +11,47 @@
Any modifications to the `DCO` or `COPYING` file must be reviewed and approved
by the Red Hat open-source legal team.
Send an email with the request to `[email protected]` with
`[email protected]` on copy.
-## Branching for new stable versions
+## Reviewing and merging dependency refreshes
+
+At the start of each week the `.github/workflows/pip-compile-*` workflows run.
+These workflows bump dependencies and create pull requests such as [PR
2842](https://github.com/ansible/ansible-documentation/pull/2842).
+
+PRs to bump dependencies should be merged in a timely fashion.
+The documentation repo categorizes dependencies into separate requirements
files.
+The weekly schedule for workflow runs also ensures fewer dependencies are
bumped at a time.
+This granularity and isolation helps us detect incompatibilities and issues
that a new version of a dependency might introduce.
+
+When reviewing PRs to refresh dependencies, look at the files changed and note
the name of the requirements file.
+This corresponds to a check in CI; for example `tests/static.txt` contains the
dependencies for the `nox / Run nox static session` check.
+
+In general, CI check will emit errors or warnings if the dependency refresh
introduces an issue of some kind.
+So basically, during review, expand the CI checks and look for problems in the
output of the relevant steps.
+If there are no errors, warnings or other messages and the step has run
successfully, the dependency bump should be fine to approve and merge.
+
+In most cases, when a dependency refresh causes an issue, you probably need to
adjust something in the appropriate session in `noxfile.py`.
+For example, [PR
1172](https://github.com/ansible/ansible-documentation/pull/1172) bumped the
version of `ruff` which resulted in a warning because the `static` session
included a deprecated command.
+To fix the issue, [PR
1191](https://github.com/ansible/ansible-documentation/pull/1191) updated the
`ruff` command and was merged before [PR
1172](https://github.com/ansible/ansible-documentation/pull/1172).
+
+## Updating scheduled builds for new major Ansible versions
+
+When a new major Ansible version is released, you need to update the latest
version in the scheduled docs build.
+
+1. Open `.github/workflows/build-latest-docs.yaml` for editing.
+2. Modify the `repository-branch` and `ansible-package-version` fields in the
`build-package-docs` and `deploy-package-docs` jobs, for example:
+
+ ```yaml
+ # Values for the Ansible 11 release
+ with:
+ ansible-package-version: '11'
+ repository-branch: 'stable-2.18'
+
+ # Values for the Ansible 12 release
+ with:
+ ansible-package-version: '12'
+ repository-branch: 'stable-2.19'
+ ```
+
+## Branching for new major stable versions
The branching strategy for this repository mirrors the
[`ansible/ansible`](https://github.com/ansible/ansible) repository.
When a new `stable-*` branch is created in the core repository, a
corresponding branch in the `ansible-documentation` repository needs to be
created.
@@ -54,7 +94,7 @@
```bash
# Remove the following workflow files, the tagger script, and tagger
requirements.
-git rm -r .github/workflows/pip-compile-dev.yml
.github/workflows/pip-compile-docs.yml
.github/workflows/reusable-pip-compile.yml .github/workflows/tag.yml
.github/workflows/build-package-docs.yaml hacking/tagger tests/tag.*
+git rm -r .github/workflows/pip-compile-*.yml
.github/workflows/reusable-pip-compile.yml .github/workflows/tag.yml
.github/workflows/build-*-docs.yaml .github/workflows/reusable-*-docs.yaml
hacking/tagger tests/tag.*
```
Next, remove references to the tagger dependencies as follows:
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/ansible-documentation-2.19.4/docs/ansible-core-branch.txt
new/ansible-documentation-2.20.0/docs/ansible-core-branch.txt
--- old/ansible-documentation-2.19.4/docs/ansible-core-branch.txt
2025-11-03 10:59:30.000000000 +0100
+++ new/ansible-documentation-2.20.0/docs/ansible-core-branch.txt
2025-11-03 10:58:52.000000000 +0100
@@ -1 +1 @@
-stable-2.19
+stable-2.20
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/ansible-documentation-2.19.4/docs/docsite/.templates/banner.html
new/ansible-documentation-2.20.0/docs/docsite/.templates/banner.html
--- old/ansible-documentation-2.19.4/docs/docsite/.templates/banner.html
2025-11-03 10:59:30.000000000 +0100
+++ new/ansible-documentation-2.20.0/docs/docsite/.templates/banner.html
2025-11-03 10:58:52.000000000 +0100
@@ -56,6 +56,8 @@
banner += extra_banner;
msg += 'You are reading the <b>devel</b> version of the Ansible
documentation - this version is not guaranteed stable. Use the version
selection to the left if you want the <b>latest</b> (stable) released version.';
+ /* temp - add extra warning about core-2.19.Added to latest and devel
docs */
+ msg += '<br><p><strong>Important:</strong> The ansible-core
2.19/Ansible 12 release has made <b>significant templating changes that might
require you to update playbooks and roles</b>. The templating changes enable
reporting of numerous problematic behaviors that went undetected in previous
releases, with wide-ranging positive effects on security, performance, and user
experience. You should validate your content to ensure compatibility with these
templating changes before upgrading to ansible-core 2.19 or Ansible 12. See the
<a
href="https://docs.ansible.com/ansible/devel/porting_guides/porting_guide_12.html";>porting
guide</a> to understand where you may need to update your playbooks and
roles.';
} else {
msg += 'You are reading an older version of the Ansible documentation.
Use the version selection to the left if you want the <b>latest</b> (stable)
released version.';
/* temp extra banner to advertise something - this is for testing*/
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/ansible-documentation-2.19.4/docs/docsite/rst/collections_guide/collections_downloading.rst
new/ansible-documentation-2.20.0/docs/docsite/rst/collections_guide/collections_downloading.rst
---
old/ansible-documentation-2.19.4/docs/docsite/rst/collections_guide/collections_downloading.rst
2025-11-03 10:59:30.000000000 +0100
+++
new/ansible-documentation-2.20.0/docs/docsite/rst/collections_guide/collections_downloading.rst
2025-11-03 10:58:52.000000000 +0100
@@ -9,8 +9,8 @@
are downloaded by default to the ``./collections`` folder.
Just like the ``install`` command, the collections are sourced based on the
-:ref:`configured galaxy server config <galaxy_server_config>`. Even if a
collection to download was specified by a URL
-or path to a tarball, the collection will be re-downloaded from the configured
Galaxy server.
+:ref:`configured galaxy server config <galaxy_server_config>`.
+Even if a collection to download was specified by a URL or path to a tarball,
the collection will be downloaded again from the configured Galaxy server.
Collections can be specified as one or multiple collections or with a
``requirements.yml`` file just like
``ansible-galaxy collection install``.
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/ansible-documentation-2.19.4/docs/docsite/rst/conf.py
new/ansible-documentation-2.20.0/docs/docsite/rst/conf.py
--- old/ansible-documentation-2.19.4/docs/docsite/rst/conf.py 2025-11-03
10:59:30.000000000 +0100
+++ new/ansible-documentation-2.20.0/docs/docsite/rst/conf.py 2025-11-03
10:58:52.000000000 +0100
@@ -50,9 +50,9 @@
VERSION = (
# Controls branch version for core releases
- '2.19' if tags.has('core_lang') or tags.has('core') else
+ 'devel' if tags.has('core_lang') or tags.has('core') else
# Controls branch version for Ansible package releases
- '12' if tags.has('ansible') or tags.has('all')
+ 'devel' if tags.has('ansible') or tags.has('all')
else '<UNKNOWN>'
)
AUTHOR = 'Ansible, Inc'
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/ansible-documentation-2.19.4/docs/docsite/rst/dev_guide/testing/sanity/compile.rst
new/ansible-documentation-2.20.0/docs/docsite/rst/dev_guide/testing/sanity/compile.rst
---
old/ansible-documentation-2.19.4/docs/docsite/rst/dev_guide/testing/sanity/compile.rst
2025-11-03 10:59:30.000000000 +0100
+++
new/ansible-documentation-2.20.0/docs/docsite/rst/dev_guide/testing/sanity/compile.rst
2025-11-03 10:58:52.000000000 +0100
@@ -13,19 +13,19 @@
Control node code, including plugins in Ansible Collections, must support the
following Python versions:
+- 3.14
- 3.13
- 3.12
-- 3.11
Code which runs on targets (``modules`` and ``module_utils``) must support all
control node supported Python versions,
as well as the additional Python versions supported only on targets:
+- 3.14
- 3.13
- 3.12
- 3.11
- 3.10
- 3.9
-- 3.8
.. note::
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/ansible-documentation-2.19.4/docs/docsite/rst/porting_guides/core_porting_guides.rst
new/ansible-documentation-2.20.0/docs/docsite/rst/porting_guides/core_porting_guides.rst
---
old/ansible-documentation-2.19.4/docs/docsite/rst/porting_guides/core_porting_guides.rst
2025-11-03 10:59:30.000000000 +0100
+++
new/ansible-documentation-2.20.0/docs/docsite/rst/porting_guides/core_porting_guides.rst
2025-11-03 10:58:52.000000000 +0100
@@ -12,6 +12,7 @@
:maxdepth: 1
:glob:
+ porting_guide_core_2.20
porting_guide_core_2.19
porting_guide_core_2.18
porting_guide_core_2.17
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/ansible-documentation-2.19.4/docs/docsite/rst/porting_guides/porting_guide_13.rst
new/ansible-documentation-2.20.0/docs/docsite/rst/porting_guides/porting_guide_13.rst
---
old/ansible-documentation-2.19.4/docs/docsite/rst/porting_guides/porting_guide_13.rst
1970-01-01 01:00:00.000000000 +0100
+++
new/ansible-documentation-2.20.0/docs/docsite/rst/porting_guides/porting_guide_13.rst
2025-11-03 10:58:52.000000000 +0100
@@ -0,0 +1,531 @@
+..
+ THIS DOCUMENT IS AUTOMATICALLY GENERATED BY ANTSIBULL! PLEASE DO NOT EDIT
MANUALLY! (YOU PROBABLY WANT TO EDIT porting_guide_core_2.20.rst)
+
+.. _porting_13_guide:
+
+========================
+Ansible 13 Porting Guide
+========================
+
+.. contents::
+ :depth: 2
+
+
+Ansible 13 is based on Ansible-core 2.20.
+
+We suggest you read this page along with the `Ansible 13 Changelog
<https://github.com/ansible-community/ansible-build-data/blob/main/13/CHANGELOG-v13.md>`_
to understand what updates you may need to make.
+
+.. _2.20_introduction:
+
+Introduction
+============
+
+No notable changes
+
+.. _2.20_playbook:
+
+Playbook
+========
+
+Removed quote stripping in PowerShell operations
+-------------------------------------------------
+
+The PowerShell module utilities no longer attempt to remove quotes from paths
when performing Windows operations like copying and fetching files. This should
not affect normal playbooks unless a value is quoted too many times. If you
have playbooks that rely on this automatic quote removal, you will need to
adjust your path formatting.
+
+.. _2.20_engine:
+
+Engine
+======
+
+No notable changes
+
+.. _2.20_plugin_api:
+
+Plugin API
+==========
+
+Removed Features
+----------------
+
+The following previously deprecated features have been removed:
+
+* The ``DEFAULT_TRANSPORT`` configuration option no longer supports the
``smart`` value that selected the default transport as either ``ssh`` or
``paramiko`` based on the underlying platform configuration.
+* The ``vault`` and ``unvault`` filters no longer accept the deprecated
``vaultid`` parameter.
+* The ``ansible-galaxy`` command no longer supports the v2 Galaxy server API.
Galaxy servers hosting collections must support v3.
+* The ``dnf`` and ``dnf5`` modules no longer support the deprecated
``install_repoquery`` option.
+* The ``encrypt`` module utility no longer includes the deprecated
``passlib_or_crypt`` API.
+* The ``paramiko`` connection plugin no longer supports the
``PARAMIKO_HOST_KEY_AUTO_ADD`` and ``PARAMIKO_LOOK_FOR_KEYS`` configuration
keys, which were previously deprecated.
+* The ``py3compat.environ`` call has been removed.
+* Vars plugins that do not inherit from ``BaseVarsPlugin`` and define a
``get_vars`` method can no longer use the deprecated ``get_host_vars`` or
``get_group_vars`` fallback.
+* The ``yum_repository`` module no longer supports the deprecated
``keepcache`` option.
+
+Behavioral Changes
+------------------
+
+* The ``DataLoader.get_basedir`` method now returns an absolute path instead
of a relative path. Plugin code that relies on relative paths may need
adjustment.
+* Argument spec validation now treats ``None`` values as empty strings for the
``str`` type for better consistency with pre-2.19 templating conversions.
+* When using ``failed_when`` to suppress an error, the ``exception`` key in
the result is now renamed to ``failed_when_suppressed_exception``. This
prevents the error from being displayed by callbacks after being suppressed. If
you have playbooks that check for the exception in the result, update them as
follows:
+
+.. code-block:: yaml+jinja
+
+ # Before
+ - command: /bin/false
+ register: result
+ failed_when: false
+
+ - debug:
+ msg: "Exception was: {{ result.exception }}"
+ when: result.exception is defined
+
+ # After
+ - command: /bin/false
+ register: result
+ failed_when: false
+
+ - debug:
+ msg: "Exception was: {{ result.failed_when_suppressed_exception }}"
+ when: result.failed_when_suppressed_exception is defined
+
+.. _2.20_command_line:
+
+Command Line
+============
+
+* Python 3.11 is no longer a supported control node version. Python 3.12+ is
now required for running Ansible.
+* Python 3.8 is no longer a supported remote version. Python 3.9+ is now
required for target execution.
+
+.. _2.20_deprecated:
+
+Deprecated
+==========
+
+INJECT_FACTS_AS_VARS
+--------------------
+
+The ``INJECT_FACTS_AS_VARS`` configuration currently defaults to ``True``, but
this is now deprecated and it will switch to ``False`` in Ansible 2.24.
+
+When enabled, facts are available both inside the ``ansible_facts`` dictionary
and as individual variables in the main namespace. In the ``ansible_facts``
dictionary, the ``ansible_`` prefix is removed from fact names.
+
+You will receive deprecation warnings if you are accessing 'injected' facts.
To prepare for the future default:
+
+**Update your playbooks to use the ansible_facts dictionary:**
+
+.. code-block:: yaml+jinja
+
+ # Deprecated - will stop working in 2.24
+ - debug:
+ msg: "OS: {{ ansible_os_distribution }}"
+
+ # Recommended - works in all versions
+ - debug:
+ msg: "OS: {{ ansible_facts['distribution'] }}"
+ # Note: 'ansible_' prefix is removed inside ansible_facts
+
+**Or explicitly enable the current behavior in your configuration:**
+
+In your ``ansible.cfg`` file:
+
+.. code-block:: ini
+
+ [defaults]
+ inject_facts_as_vars = True
+
+By exporting an environment variable:
+
+.. code-block:: shell
+
+ export ANSIBLE_INJECT_FACT_VARS=True
+
+Other Deprecations
+------------------
+
+* The ``vars`` internal variable cache will be removed in 2.24. This cache,
once used internally, exposes variables in inconsistent states. The ``vars``
and ``varnames`` lookups should be used instead.
+* Specifying ``ignore_files`` as a string in the ``include_vars`` module is
deprecated. Use a list instead:
+
+.. code-block:: yaml
+
+ # Deprecated
+ - include_vars:
+ dir: vars/
+ ignore_files: ".gitkeep"
+
+ # Correct
+ - include_vars:
+ dir: vars/
+ ignore_files: [".gitkeep"]
+
+.. _2.20_modules:
+
+Modules
+=======
+
+Modules removed
+---------------
+
+The following modules no longer exist:
+
+* No notable changes
+
+Deprecation notices
+-------------------
+
+No notable changes
+
+Noteworthy module changes
+-------------------------
+
+* The ``include_vars`` module now raises an error if the ``extensions``
parameter is not specified as a list. Previously, non-list values were silently
accepted.
+* The ``include_vars`` module now raises an error if the ``ignore_files``
parameter is not specified as a list. Previously, string values were accepted
but are now deprecated.
+* The ``replace`` module now reads and writes files in text-mode as unicode
characters instead of as bytes, and switches regex matching to unicode
characters instead of bytes. This may affect playbooks that rely on byte-level
operations.
+
+Plugins
+=======
+
+Noteworthy plugin changes
+-------------------------
+
+No notable changes
+
+Porting custom scripts
+======================
+
+No notable changes
+
+Networking
+==========
+
+No notable changes
+
+Porting Guide for v13.0.0a5
+===========================
+
+Breaking Changes
+----------------
+
+community.docker
+^^^^^^^^^^^^^^^^
+
+- All doc fragments, module utils, and plugin utils are from now on private.
They can change at any time, and have breaking changes even in bugfix releases
(https://github.com/ansible-collections/community.docker/pull/1144).
+
+Major Changes
+-------------
+
+fortinet.fortios
+^^^^^^^^^^^^^^^^
+
+- Supported default_group feature for the all of the modules.
+
+grafana.grafana
+^^^^^^^^^^^^^^^
+
+- Restore default listen address and port in Mimir by @56quarters in
https://github.com/grafana/grafana-ansible-collection/pull/456
+- fix broken Grafana apt repository addition by @kleini in
https://github.com/grafana/grafana-ansible-collection/pull/454
+
+ieisystem.inmanage
+^^^^^^^^^^^^^^^^^^
+
+- The edit_m6_log_setting.py module has added the 'server_status' attribute;
The edit_network_bond.py module modifies the attribute descriptions; The
edit_snmp.py and edit_snmp_trap.py module modifies the allowable value ranges
for the auth_protocol and priv_protocol attributes.
(https://github.com/ieisystem/ieisystem.inmanage/pull/30).
+
+ngine_io.cloudstack
+^^^^^^^^^^^^^^^^^^^
+
+- Ensuring backwards compatibility and integration tests with CloudStack 4.17
and 4.18.
+- General overhaul (black code style) and renaming of all modules (dropping
``cs_`` prefix)
(https://github.com/ngine-io/ansible-collection-cloudstack/pull/141).
+- Update cs dependency to >=3.4.0.
+
+Removed Features
+----------------
+
+community.docker
+^^^^^^^^^^^^^^^^
+
+- Remove support for Docker SDK for Python version 1.x.y, also known as
``docker-py``. Modules and plugins that use Docker SDK for Python require
version 2.0.0+
(https://github.com/ansible-collections/community.docker/pull/1171).
+- The collection no longer supports Python 3.6 and before. Note that this
coincides with the Python requirements of ansible-core 2.17+
(https://github.com/ansible-collections/community.docker/pull/1123).
+- The collection no longer supports ansible-core 2.15 and 2.16. You need
ansible-core 2.17.0 or newer to use community.docker 5.x.y
(https://github.com/ansible-collections/community.docker/pull/1123).
+
+Deprecated Features
+-------------------
+
+community.hrobot
+^^^^^^^^^^^^^^^^
+
+- storagebox_subaccount - ``password_mode=set-to-random`` is deprecated and
will be removed from community.hrobot 3.0.0. Hetzner's new API does not support
this anyway, it can only be used with the legacy API
(https://github.com/ansible-collections/community.hrobot/pull/183).
+
+Porting Guide for v13.0.0a3
+===========================
+
+Major Changes
+-------------
+
+grafana.grafana
+^^^^^^^^^^^^^^^
+
+- Fallback to empty dict in case grafana_ini is undefined by @root-expert in
https://github.com/grafana/grafana-ansible-collection/pull/403
+- Fix Mimir config file validation task by @Windos in
https://github.com/grafana/grafana-ansible-collection/pull/428
+- Fixes issue by @digiserg in
https://github.com/grafana/grafana-ansible-collection/pull/421
+- Import custom dashboards only when directory exists by @mahendrapaipuri in
https://github.com/grafana/grafana-ansible-collection/pull/430
+- Updated YUM repo urls from `packages.grafana.com` to `rpm.grafana.com` by
@DejfCold in https://github.com/grafana/grafana-ansible-collection/pull/414
+- Use credentials from grafana_ini when importing dashboards by @root-expert
in https://github.com/grafana/grafana-ansible-collection/pull/402
+- do not skip scrape latest github version even in check_mode by @cmehat in
https://github.com/grafana/grafana-ansible-collection/pull/408
+- fix datasource documentation by @jeremad in
https://github.com/grafana/grafana-ansible-collection/pull/437
+- fix mimir_download_url_deb & mimir_download_url_rpm by @germebl in
https://github.com/grafana/grafana-ansible-collection/pull/400
+- update catalog info by @Duologic in
https://github.com/grafana/grafana-ansible-collection/pull/434
+- use deb822 for newer debian versions by @Lukas-Heindl in
https://github.com/grafana/grafana-ansible-collection/pull/440
+
+Deprecated Features
+-------------------
+
+community.hrobot
+^^^^^^^^^^^^^^^^
+
+- storagebox\* modules - membership in the ``community.hrobot.robot`` action
group (module defaults group) is deprecated; the modules will be removed from
the group in community.hrobot 3.0.0. Use ``community.hrobot.api`` instead
(https://github.com/ansible-collections/community.hrobot/pull/178).
+- storagebox\* modules - the ``hetzner_token`` option for these modules will
be required from community.hrobot 3.0.0 on
(https://github.com/ansible-collections/community.hrobot/pull/178).
+- storagebox\* modules - the ``hetzner_user`` and ``hetzner_pass`` options for
these modules are deprecated; support will be removed in community.hrobot
3.0.0. Use ``hetzner_token`` instead
(https://github.com/ansible-collections/community.hrobot/pull/178).
+- storagebox_info - the ``storageboxes[].login``,
``storageboxes[].disk_quota``, ``storageboxes[].disk_usage``,
``storageboxes[].disk_usage_data``, ``storageboxes[].disk_usage_snapshot``,
``storageboxes[].webdav``, ``storageboxes[].samba``, ``storageboxes[].ssh``,
``storageboxes[].external_reachability``, and ``storageboxes[].zfs`` return
values are deprecated and will be removed from community.routeros. Check out
the documentation to find out their new names according to the new API
(https://github.com/ansible-collections/community.hrobot/pull/178).
+- storagebox_snapshot_info - the ``snapshots[].timestamp``,
``snapshots[].size``, ``snapshots[].filesystem_size``,
``snapshots[].automatic``, and ``snapshots[].comment`` return values are
deprecated and will be removed from community.routeros. Check out the
documentation to find out their new names according to the new API
(https://github.com/ansible-collections/community.hrobot/pull/178).
+- storagebox_snapshot_plan - the ``plans[].month`` return value is deprecated,
since it only returns ``null`` with the new API and cannot be set to any other
value (https://github.com/ansible-collections/community.hrobot/pull/178).
+- storagebox_snapshot_plan_info - the ``plans[].month`` return value is
deprecated, since it only returns ``null`` with the new API and cannot be set
to any other value
(https://github.com/ansible-collections/community.hrobot/pull/178).
+- storagebox_subaccount - the ``subaccount.homedirectory``,
``subaccount.samba``, ``subaccount.ssh``, ``subaccount.external_reachability``,
``subaccount.webdav``, ``subaccount.readonly``, ``subaccount.createtime``, and
``subaccount.comment`` return values are deprecated and will be removed from
community.routeros. Check out the documentation to find out their new names
according to the new API
(https://github.com/ansible-collections/community.hrobot/pull/178).
+- storagebox_subaccount_info - the ``subaccounts[].accountid``,
``subaccounts[].homedirectory``, ``subaccounts[].samba``,
``subaccounts[].ssh``, ``subaccounts[].external_reachability``,
``subaccounts[].webdav``, ``subaccounts[].readonly``,
``subaccounts[].createtime``, and ``subaccounts[].comment`` return values are
deprecated and will be removed from community.routeros. Check out the
documentation to find out their new names according to the new API
(https://github.com/ansible-collections/community.hrobot/pull/178).
+
+Porting Guide for v13.0.0a2
+===========================
+
+Added Collections
+-----------------
+
+- hitachivantara.vspone_object (version 1.0.0)
+
+Known Issues
+------------
+
+dellemc.openmanage
+^^^^^^^^^^^^^^^^^^
+
+- Formal qualification of module ome_smart_fabric_info for Ansible Core
version 2.19 is still pending.
+- idrac_diagnostics - This module does not support export of diagnostics file
to HTTP and HTTPS share via SOCKS proxy.
+- idrac_license - Due to API limitation, proxy parameters are ignored during
the import operation.
+- idrac_license - The module will give different error messages for iDRAC9 and
iDRAC10 when user imports license with invalid share name.
+- idrac_os_deployment - The module continues to return a 200 response and
marks the job as completed, even when an outdated date is supplied in the
Expose duration.
+- idrac_redfish_storage_controller - PatrolReadRatePercent attribute cannot be
set in iDRAC10.
+- idrac_server_config_profile - When attempting to revert iDRAC settings using
a previously exported SCP file, the import operation will complete with errors
if a new user was created after the export (Instead of restoring the system to
its previous state, including the removal of newly added users).
+- idrac_system_info - The module will show empty video list despite having
Embedded VIDEO controller.
+- ome_smart_fabric_uplink - The module supported by OpenManage Enterprise
Modular, however it does not allow the creation of multiple uplinks of the same
name. If an uplink is created using the same name as an existing uplink, then
the existing uplink is modified.
+- redfish_storage_volume - Encryption type and block_io_size bytes will be
read only property in iDRAC9 and iDRAC10 and hence the module ignores these
parameters.
+
+Major Changes
+-------------
+
+dellemc.openmanage
+^^^^^^^^^^^^^^^^^^
+
+- The OpenManage Enterprise, OpenManage Enterprise Modular and OpenManage
Enterprise Integration for VMware vCenter modules are now compatible with
Ansible Core version 2.19.
+
+fortinet.fortios
+^^^^^^^^^^^^^^^^
+
+- Supported new versions 7.6.3 and 7.6.4.
+- Supported the authentication method when using username and password in
v7.6.4.
+
+grafana.grafana
+^^^^^^^^^^^^^^^
+
+- Add SUSE support to Alloy role by @pozsa in
https://github.com/grafana/grafana-ansible-collection/pull/423
+- Fixes to foldersFromFilesStructure option by @root-expert in
https://github.com/grafana/grafana-ansible-collection/pull/351
+- Migrate RedHat install to ansible.builtin.package by @r65535 in
https://github.com/grafana/grafana-ansible-collection/pull/431
+- add macOS support to alloy role by @l50 in
https://github.com/grafana/grafana-ansible-collection/pull/418
+- replace None with [] for safe length checks by @voidquark in
https://github.com/grafana/grafana-ansible-collection/pull/426
+
+Removed Features
+----------------
+
+Ansible-core
+^^^^^^^^^^^^
+
+- ansible-galaxy - remove support for resolvelib >= 0.5.3, < 0.8.0.
+
+Deprecated Features
+-------------------
+
+dellemc.powerflex
+^^^^^^^^^^^^^^^^^
+
+- The device, info, protection_domain, snapshot, storagepool and volume
modules are supported only on PowerFlex Gen1. They are replaced by v2 modules
on PowerFlex Gen2.
+- The fault_set, replication_consistency_group, replication_pair,
resource_group and sds modules are not supported on PowerFlex Gen2.
+
+hetzner.hcloud
+^^^^^^^^^^^^^^
+
+- server_type_info - Deprecate Server Type ``deprecation`` property.
+
+Porting Guide for v13.0.0a1
+===========================
+
+Added Collections
+-----------------
+
+- ravendb.ravendb (version 1.0.3)
+
+Known Issues
+------------
+
+Ansible-core
+^^^^^^^^^^^^
+
+- templating - Exceptions raised in a Jinja ``set`` or ``with`` block which
are not accessed by the template are ignored in the same manner as undefined
values.
+- templating - Passing a container created in a Jinja ``set`` or ``with``
block to a method results in a copy of that container. Mutations to that
container which are not returned by the method will be discarded.
+
+dellemc.openmanage
+^^^^^^^^^^^^^^^^^^
+
+- idrac_attributes - The module accepts both the string as well as integer
value for the field "SNMP.1.AgentCommunity" for iDRAC10.
+- idrac_diagnostics - This module does not support export of diagnostics file
to HTTP and HTTPS share via SOCKS proxy.
+- idrac_license - Due to API limitation, proxy parameters are ignored during
the import operation.
+- idrac_license - The module will fail to export license to NFS Share.
+- idrac_license - The module will give different error messages for iDRAC9 and
iDRAC10 when user imports license with invalid share name.
+- idrac_os_deployment - The module continues to return a 200 response and
marks the job as completed, even when an outdated date is supplied in the
Expose duration.
+- idrac_redfish_storage_controller - PatrolReadRatePercent attribute cannot be
set in iDRAC10.
+- idrac_server_config_profile - When attempting to revert iDRAC settings using
a previously exported SCP file, the import operation will complete with errors
if a new user was created after the export (Instead of restoring the system to
its previous state, including the removal of newly added users).
+- idrac_system_info - The module will show empty video list despite having
Embedded VIDEO controller.
+- ome_smart_fabric_uplink - The module supported by OpenManage Enterprise
Modular, however it does not allow the creation of multiple uplinks of the same
name. If an uplink is created using the same name as an existing uplink, then
the existing uplink is modified.
+- redfish_storage_volume - Encryption type and block_io_size bytes will be
read only property in iDRAC 9 and iDRAC 10 and hence the module ignores these
parameters.
+
+Breaking Changes
+----------------
+
+Ansible-core
+^^^^^^^^^^^^
+
+- powershell - Removed code that tried to remote quotes from paths when
performing Windows operations like copying and fetching file. This should not
affect normal playbooks unless a value is quoted too many times.
+
+community.mysql
+^^^^^^^^^^^^^^^
+
+- Since version 4.0.0, the collection accepts code written in Python 3.
Modules aren't tested against Python 2 and might not work in Python 2
environments.
+- collection - stop testing against mysqlclient connector as its support was
deprecated in this collection - use PyMySQL connector instead! It'll stop
working in 5.0.0 when we remove all related code
(https://github.com/ansible-collections/community.mysql/issues/654).
+- mysql_db - the ``pipefail`` argument's default value is set to ``true``. If
your target machines do not use ``bash`` as a default interpreter, set
``pipefail`` to ``false`` explicitly. However, we strongly recommend setting up
``bash`` as a default and ``pipefail=true`` as it will protect you from getting
broken dumps you don't know about
(https://github.com/ansible-collections/community.mysql/issues/407).
+- mysql_info - The ``users_info`` filter does not return the
``plugin_auth_string`` field anymore. Use the `plugin_hash_string` return value
instead (https://github.com/ansible-collections/community.mysql/pull/629).
+- mysql_role - the ``column_case_sensitive`` argument's default value has been
changed to ``true``. If your playbook expected the column to be automatically
uppercased for your users privileges, you should set this to ``false``
explicitly (https://github.com/ansible-collections/community.mysql/issues/578).
+- mysql_user - the ``column_case_sensitive`` argument's default value has been
changed to ``true``. If your playbook expected the column to be automatically
uppercased for your users privileges, you should set this to ``false``
explicitly (https://github.com/ansible-collections/community.mysql/issues/577).
+
+community.vmware
+^^^^^^^^^^^^^^^^
+
+- Removed support for ansible-core < 2.19.0.
+- Removed support for vmware.vmware < 2.0.0.
+- Replace the dependencies on ``pyvmomi``, ``vmware-vcenter`` and
``vmware-vapi-common-client`` with ``vcf-sdk``
(https://github.com/ansible-collections/community.vmware/pull/2457).
+
+ibm.storage_virtualize
+^^^^^^^^^^^^^^^^^^^^^^
+
+- ibm_sv_manage_flashsystem_grid - The flashsystem grid module now uses newer
FlashSystem REST APIs to perform tasks.
+
+Major Changes
+-------------
+
+Ansible-core
+^^^^^^^^^^^^
+
+- ansible - Add support for Python 3.14.
+- ansible - Drop support for Python 3.11 on the controller.
+- ansible - Drop support for Python 3.8 on targets.
+
+community.vmware
+^^^^^^^^^^^^^^^^
+
+- Re-use code from ``vmware.vmware``
(https://github.com/ansible-collections/community.vmware/pull/2459).
+
+containers.podman
+^^^^^^^^^^^^^^^^^
+
+- Add inventory plugins for buildah and podman
+- Add podman system connection modules
+
+dellemc.openmanage
+^^^^^^^^^^^^^^^^^^
+
+- idrac_certificate - This role is enhanced to support iDRAC10.
+- idrac_export_server_config_profile - This role is enhanced to support
iDRAC10.
+- idrac_firmware - This role is enhanced to support iDRAC10.
+- idrac_import_server_config_profile - This role is enhanced to support
iDRAC10.
+- idrac_license - This module is enhanced to support iDRAC10.
+- idrac_os_deployment - This module is enhanced to support iDRAC10.
+- idrac_os_deployment - This role is enhanced to support iDRAC10.
+- idrac_redfish_storage_controller - This module is enhanced to support
iDRAC10.
+- idrac_server_config_profile - This module is enhanced to support iDRAC10.
+- idrac_storage_controller - This role is enhanced to support iDRAC10.
+- idrac_storage_volume - This module is enhanced to support iDRAC10.
+- redfish_firmware - This role is enhanced to support iDRAC10.
+- redfish_firmware_rollback - This module is enhanced to support iDRAC10.
+- redfish_storage_volume - This module is enhanced to support iDRAC10.
+- redfish_storage_volume - This role is enhanced to support iDRAC10.
+
+Removed Collections
+-------------------
+
+- ibm.qradar (previously included version: 4.0.0)
+
+You can still install a removed collection manually with ``ansible-galaxy
collection install <name-of-collection>``.
+
+Removed Features
+----------------
+
+- The deprecated ``ibm.qradar`` collection has been removed
(`https://forum.ansible.com/t/44259 <https://forum.ansible.com/t/44259>`__).
+
+Ansible-core
+^^^^^^^^^^^^
+
+- Removed the option to set the ``DEFAULT_TRANSPORT`` configuration to
``smart`` that selects the default transport as either ``ssh`` or ``paramiko``
based on the underlying platform configuraton.
+- ``vault``/``unvault`` filters - remove the deprecated ``vaultid`` parameter.
+- ansible-doc - role entrypoint attributes are no longer shown
+- ansible-galaxy - removed the v2 Galaxy server API. Galaxy servers hosting
collections must support v3.
+- dnf/dnf5 - remove deprecated ``install_repoquery`` option.
+- encrypt - remove deprecated passlib_or_crypt API.
+- paramiko - Removed the ``PARAMIKO_HOST_KEY_AUTO_ADD`` and
``PARAMIKO_LOOK_FOR_KEYS`` configuration keys, which were previously deprecated.
+- py3compat - remove deprecated ``py3compat.environ`` call.
+- vars plugins - removed the deprecated ``get_host_vars`` or
``get_group_vars`` fallback for vars plugins that do not inherit from
``BaseVarsPlugin`` and define a ``get_vars`` method.
+- yum_repository - remove deprecated ``keepcache`` option.
+
+community.vmware
+^^^^^^^^^^^^^^^^
+
+- vmware_cluster - The deprecated module has been removed. Use
``vmware.vmware.cluster`` instead
(https://github.com/ansible-collections/community.vmware/pull/2455).
+- vmware_cluster_dpm - The deprecated module has been removed. Use
``vmware.vmware.cluster_dpm`` instead
(https://github.com/ansible-collections/community.vmware/pull/2455).
+- vmware_cluster_drs - The deprecated module has been removed. Use
``vmware.vmware.cluster_drs`` instead
(https://github.com/ansible-collections/community.vmware/pull/2455).
+- vmware_cluster_drs_recommendations - The deprecated module has been removed.
Use ``vmware.vmware.cluster_drs_recommendations`` instead
(https://github.com/ansible-collections/community.vmware/pull/2455).
+- vmware_cluster_vcls - The deprecated module has been removed. Use
``vmware.vmware.cluster_vcls`` instead
(https://github.com/ansible-collections/community.vmware/pull/2455).
+
+Deprecated Features
+-------------------
+
+Ansible-core
+^^^^^^^^^^^^
+
+- Deprecated the shell plugin's ``wrap_for_exec`` function. This API is not
used in Ansible or any known collection and is being removed to simplify the
plugin API. Plugin authors should wrap their command to execute within an
explicit shell or other known executable.
+- INJECT_FACTS_AS_VARS configuration currently defaults to ``True``, this is
now deprecated and it will switch to ``False`` by Ansible 2.24. You will only
get notified if you are accessing 'injected' facts (for example,
ansible_os_distribution vs ansible_facts['os_distribution']).
+- hash_params function in roles/__init__ is being deprecated as it is not in
use.
+- include_vars - Specifying 'ignore_files' as a string is deprecated.
+- vars, the internal variable cache will be removed in 2.24. This cache, once
used internally exposes variables in inconsistent states, the 'vars' and
'varnames' lookups should be used instead.
+
+community.general
+^^^^^^^^^^^^^^^^^
+
+- hiera lookup plugin - retrieving data with Hiera has been deprecated a long
time ago; because of that this plugin will be removed from community.general
13.0.0. If you disagree with this deprecation, please create an issue in the
community.general repository
(https://github.com/ansible-collections/community.general/issues/4462,
https://github.com/ansible-collections/community.general/pull/10779).
+- oci_utils module utils - utils is deprecated and will be removed in
community.general 13.0.0
(https://github.com/ansible-collections/community.general/issues/10318,
https://github.com/ansible-collections/community.general/pull/10652).
+- oci_vcn - module is deprecated and will be removed in community.general
13.0.0 (https://github.com/ansible-collections/community.general/issues/10318,
https://github.com/ansible-collections/community.general/pull/10652).
+- oracle* doc fragments - fragments are deprecated and will be removed in
community.general 13.0.0
(https://github.com/ansible-collections/community.general/issues/10318,
https://github.com/ansible-collections/community.general/pull/10652).
+
+community.vmware
+^^^^^^^^^^^^^^^^
+
+- vmware_guest_snapshot - the module has been deprecated and will be removed
in community.vmware 8.0.0
(https://github.com/ansible-collections/community.vmware/pull/2467).
+
+community.zabbix
+^^^^^^^^^^^^^^^^
+
+- zabbix_maintenance module - Depreicated `minutes` argument for `time_periods`
+
+purestorage.flasharray
+^^^^^^^^^^^^^^^^^^^^^^
+
+- purefa_volume_tags - Deprecated due to removal of REST 1.x support. Will be
removed in Collection 2.0.0
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/ansible-documentation-2.19.4/docs/docsite/rst/porting_guides/porting_guide_core_2.20.rst
new/ansible-documentation-2.20.0/docs/docsite/rst/porting_guides/porting_guide_core_2.20.rst
---
old/ansible-documentation-2.19.4/docs/docsite/rst/porting_guides/porting_guide_core_2.20.rst
1970-01-01 01:00:00.000000000 +0100
+++
new/ansible-documentation-2.20.0/docs/docsite/rst/porting_guides/porting_guide_core_2.20.rst
2025-11-03 10:58:52.000000000 +0100
@@ -0,0 +1,201 @@
+
+.. _porting_2.20_guide_core:
+
+*******************************
+Ansible-core 2.20 Porting Guide
+*******************************
+
+This section discusses the behavioral changes between ``ansible-core`` 2.19
and ``ansible-core`` 2.20.
+
+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.
+
+Review this page and the
+`ansible-core Changelog for 2.20
<https://github.com/ansible/ansible/blob/stable-2.20/changelogs/CHANGELOG-v2.20.rst>`_
+to understand necessary changes.
+
+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
+
+.. _2.20_introduction:
+
+Introduction
+============
+
+No notable changes
+
+.. _2.20_playbook:
+
+Playbook
+========
+
+Removed quote stripping in PowerShell operations
+-------------------------------------------------
+
+The PowerShell module utilities no longer attempt to remove quotes from paths
when performing Windows operations like copying and fetching files. This should
not affect normal playbooks unless a value is quoted too many times. If you
have playbooks that rely on this automatic quote removal, you will need to
adjust your path formatting.
+
+.. _2.20_engine:
+
+Engine
+======
+
+No notable changes
+
+.. _2.20_plugin_api:
+
+Plugin API
+==========
+
+Removed Features
+----------------
+
+The following previously deprecated features have been removed:
+
+* The ``DEFAULT_TRANSPORT`` configuration option no longer supports the
``smart`` value that selected the default transport as either ``ssh`` or
``paramiko`` based on the underlying platform configuration.
+* The ``vault`` and ``unvault`` filters no longer accept the deprecated
``vaultid`` parameter.
+* The ``ansible-galaxy`` command no longer supports the v2 Galaxy server API.
Galaxy servers hosting collections must support v3.
+* The ``dnf`` and ``dnf5`` modules no longer support the deprecated
``install_repoquery`` option.
+* The ``encrypt`` module utility no longer includes the deprecated
``passlib_or_crypt`` API.
+* The ``paramiko`` connection plugin no longer supports the
``PARAMIKO_HOST_KEY_AUTO_ADD`` and ``PARAMIKO_LOOK_FOR_KEYS`` configuration
keys, which were previously deprecated.
+* The ``py3compat.environ`` call has been removed.
+* Vars plugins that do not inherit from ``BaseVarsPlugin`` and define a
``get_vars`` method can no longer use the deprecated ``get_host_vars`` or
``get_group_vars`` fallback.
+* The ``yum_repository`` module no longer supports the deprecated
``keepcache`` option.
+
+Behavioral Changes
+------------------
+
+* The ``DataLoader.get_basedir`` method now returns an absolute path instead
of a relative path. Plugin code that relies on relative paths may need
adjustment.
+* Argument spec validation now treats ``None`` values as empty strings for the
``str`` type for better consistency with pre-2.19 templating conversions.
+* When using ``failed_when`` to suppress an error, the ``exception`` key in
the result is now renamed to ``failed_when_suppressed_exception``. This
prevents the error from being displayed by callbacks after being suppressed. If
you have playbooks that check for the exception in the result, update them as
follows:
+
+.. code-block:: yaml+jinja
+
+ # Before
+ - command: /bin/false
+ register: result
+ failed_when: false
+
+ - debug:
+ msg: "Exception was: {{ result.exception }}"
+ when: result.exception is defined
+
+ # After
+ - command: /bin/false
+ register: result
+ failed_when: false
+
+ - debug:
+ msg: "Exception was: {{ result.failed_when_suppressed_exception }}"
+ when: result.failed_when_suppressed_exception is defined
+
+.. _2.20_command_line:
+
+Command Line
+============
+
+* Python 3.11 is no longer a supported control node version. Python 3.12+ is
now required for running Ansible.
+* Python 3.8 is no longer a supported remote version. Python 3.9+ is now
required for target execution.
+
+.. _2.20_deprecated:
+
+Deprecated
+==========
+
+INJECT_FACTS_AS_VARS
+--------------------
+
+The ``INJECT_FACTS_AS_VARS`` configuration currently defaults to ``True``, but
this is now deprecated and it will switch to ``False`` in Ansible 2.24.
+
+When enabled, facts are available both inside the ``ansible_facts`` dictionary
and as individual variables in the main namespace. In the ``ansible_facts``
dictionary, the ``ansible_`` prefix is removed from fact names.
+
+You will receive deprecation warnings if you are accessing 'injected' facts.
To prepare for the future default:
+
+**Update your playbooks to use the ansible_facts dictionary:**
+
+.. code-block:: yaml+jinja
+
+ # Deprecated - will stop working in 2.24
+ - debug:
+ msg: "OS: {{ ansible_os_distribution }}"
+
+ # Recommended - works in all versions
+ - debug:
+ msg: "OS: {{ ansible_facts['distribution'] }}"
+ # Note: 'ansible_' prefix is removed inside ansible_facts
+
+**Or explicitly enable the current behavior in your configuration:**
+
+In your ``ansible.cfg`` file:
+
+.. code-block:: ini
+
+ [defaults]
+ inject_facts_as_vars = True
+
+By exporting an environment variable:
+
+.. code-block:: shell
+
+ export ANSIBLE_INJECT_FACT_VARS=True
+
+Other Deprecations
+------------------
+
+* The ``vars`` internal variable cache will be removed in 2.24. This cache,
once used internally, exposes variables in inconsistent states. The ``vars``
and ``varnames`` lookups should be used instead.
+* Specifying ``ignore_files`` as a string in the ``include_vars`` module is
deprecated. Use a list instead:
+
+.. code-block:: yaml
+
+ # Deprecated
+ - include_vars:
+ dir: vars/
+ ignore_files: ".gitkeep"
+
+ # Correct
+ - include_vars:
+ dir: vars/
+ ignore_files: [".gitkeep"]
+
+.. _2.20_modules:
+
+Modules
+=======
+
+Modules removed
+---------------
+
+The following modules no longer exist:
+
+* No notable changes
+
+Deprecation notices
+-------------------
+
+No notable changes
+
+Noteworthy module changes
+-------------------------
+
+* The ``include_vars`` module now raises an error if the ``extensions``
parameter is not specified as a list. Previously, non-list values were silently
accepted.
+* The ``include_vars`` module now raises an error if the ``ignore_files``
parameter is not specified as a list. Previously, string values were accepted
but are now deprecated.
+* The ``replace`` module now reads and writes files in text-mode as unicode
characters instead of as bytes, and switches regex matching to unicode
characters instead of bytes. This may affect playbooks that rely on byte-level
operations.
+
+Plugins
+=======
+
+Noteworthy plugin changes
+-------------------------
+
+No notable changes
+
+Porting custom scripts
+======================
+
+No notable changes
+
+Networking
+==========
+
+No notable changes
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/ansible-documentation-2.19.4/docs/docsite/rst/reference_appendices/interpreter_discovery.rst
new/ansible-documentation-2.20.0/docs/docsite/rst/reference_appendices/interpreter_discovery.rst
---
old/ansible-documentation-2.19.4/docs/docsite/rst/reference_appendices/interpreter_discovery.rst
2025-11-03 10:59:30.000000000 +0100
+++
new/ansible-documentation-2.20.0/docs/docsite/rst/reference_appendices/interpreter_discovery.rst
2025-11-03 10:58:52.000000000 +0100
@@ -13,39 +13,19 @@
* 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_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 (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_silent
- Same as ``auto_legacy``, but does not issue warnings.
+auto_legacy :
+ Deprecated alias for ``auto``.
-auto_silent
+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``.
+
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/ansible-documentation-2.19.4/docs/docsite/rst/reference_appendices/release_and_maintenance.rst
new/ansible-documentation-2.20.0/docs/docsite/rst/reference_appendices/release_and_maintenance.rst
---
old/ansible-documentation-2.19.4/docs/docsite/rst/reference_appendices/release_and_maintenance.rst
2025-11-03 10:59:30.000000000 +0100
+++
new/ansible-documentation-2.20.0/docs/docsite/rst/reference_appendices/release_and_maintenance.rst
2025-11-03 10:58:52.000000000 +0100
@@ -168,6 +168,14 @@
- End Of Life
- Control Node Python
- Target Python / PowerShell
+ * - `2.20`_
+ - | GA: 03 Nov 2025
+ | Critical: 18 May 2026
+ | Security: 02 Nov 2026
+ - May 2027
+ - | Python 3.12 - 3.14
+ - | Python 3.9 - 3.14
+ | PowerShell 5.1
* - `2.19`_
- | GA: 21 July 2025
| Critical: 03 Nov 2025
@@ -275,14 +283,6 @@
- | Python 2.6 - 2.7
| Python 3.5 - 3.8
| PowerShell 3 - 5.1
-.. * - 2.20
-.. - Nov 2025
-.. - May 2026
-.. - Nov 2026
-.. - May 2027
-.. - | Python 3.12 - 3.14
-.. - | Python 3.9 - 3.14
-.. | PowerShell 5.1
.. * - 2.21
.. - May 2026
.. - Nov 2026
@@ -336,6 +336,7 @@
.. _2.17:
https://github.com/ansible/ansible/blob/stable-2.17/changelogs/CHANGELOG-v2.17.rst
.. _2.18:
https://github.com/ansible/ansible/blob/stable-2.18/changelogs/CHANGELOG-v2.18.rst
.. _2.19:
https://github.com/ansible/ansible/blob/stable-2.19/changelogs/CHANGELOG-v2.19.rst
+.. _2.20:
https://github.com/ansible/ansible/blob/stable-2.20/changelogs/CHANGELOG-v2.20.rst
.. _ansible_core_versioning:
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/ansible-documentation-2.19.4/docs/docsite/rst/roadmap/COLLECTIONS_13.rst
new/ansible-documentation-2.20.0/docs/docsite/rst/roadmap/COLLECTIONS_13.rst
---
old/ansible-documentation-2.19.4/docs/docsite/rst/roadmap/COLLECTIONS_13.rst
1970-01-01 01:00:00.000000000 +0100
+++
new/ansible-documentation-2.20.0/docs/docsite/rst/roadmap/COLLECTIONS_13.rst
2025-11-03 10:58:52.000000000 +0100
@@ -0,0 +1,81 @@
+..
+ THIS DOCUMENT IS OWNED BY THE ANSIBLE COMMUNITY STEERING COMMITTEE. ALL
CHANGES MUST BE APPROVED BY THE STEERING COMMITTEE!
+ For small changes (fixing typos, language errors, etc.) create a PR and
ping @ansible/steering-committee.
+ For other changes, create a discussion as described in
https://docs.ansible.com/ansible/devel/community/steering/community_topics_workflow.html#creating-a-topic
+ to discuss the changes.
+ (Creating a draft PR for this file and mentioning it in the community topic
is also OK.)
+
+.. _ansible_13_roadmap:
+
+====================
+Ansible project 13.0
+====================
+
+This release schedule includes dates for the `ansible
<https://pypi.org/project/ansible/>`_ package, with a few dates for the
`ansible-core <https://pypi.org/project/ansible-core/>`_ package as well. All
dates are subject to change. See the :ref:`ansible-core 2.20 Roadmap
<core_roadmap_2.20>` for the most recent updates on ``ansible-core``.
+
+.. contents::
+ :local:
+
+
+Release schedule
+=================
+
+The schedule has been updated to match the :ref:`ansible-core 2.20 release
schedule <core_roadmap_2.20>`. If that one gets modified again, the Ansible 12
pre-release and release dates will be shifted accordingly, and potentially more
pre-releases will be inserted.
+
+:2025-09-15: ansible-core feature freeze.
+:2025-09-22: Start of ansible-core 2.20 betas.
+:2025-09-23: Ansible-13.0.0 alpha1; there will be more alpha releases usually
following additional ansible-core 2.20 betas.
+:2025-10-13: First ansible-core 2.20 release candidate.
+:2025-10-14: Ansible-13.0.0 alphaX; there might be more alpha releases
following additional ansible-core 2.19 release candidates.
+:2025-11-03: Ansible-core-2.20.0 released.
+:2025-11-03: Last day for collections to make backwards incompatible releases
that will be accepted into Ansible-13. This includes adding new collections to
Ansible 13.0.0; from now on new collections have to wait for 13.1.0 or later.
+:2025-11-04: Ansible-13.0.0 beta1 -- feature freeze [2]_ (collection owners
and interested users should test for bugs).
+:2025-11-11: Ansible-13.0.0 rc1 [3]_ [4]_ (weekly release candidates as
needed; test and alert us to any blocker bugs). Blocker bugs will slip release.
+:2025-11-14: Last day to trigger an Ansible-13.0.0rc2 release because of major
defects in Ansible-13.0.0rc1.
+:2025-11-18: Ansible-13.0.0rc2 when necessary, otherwise Ansible-13.0.0
release.
+:2025-11-25: Ansible-13.0.0 release when Ansible-13.0.0rc2 was necessary.
+:2025-11-18 or 2025-11-25: Create the ansible-build-data directory and files
for Ansible-14.
+:2025-12-01: Release of ansible-core 2.20.1.
+:2025-12-02: Release of Ansible-13.1.0 (bugfix + compatible features: every
four weeks.)
+
+.. [2] No new modules or major features accepted after this date. In practice,
this means we will freeze the semver collection versions to compatible release
versions. For example, if the version of community.crypto on this date was
community.crypto 3.3.0; Ansible-13.0.0 could ship with community.crypto 3.3.1.
It would not ship with community.crypto 3.4.0.
+
+.. [3] After this date only changes blocking a release are accepted. Accepted
changes require creating a new release candidate and may slip the final release
date.
+
+.. [4] Collections will be updated to a new version only if a blocker is
approved. Collection owners should discuss any blockers at a community meeting
(before this freeze) to decide whether to bump the version of the collection
for a fix. See the :ref:`creating an Ansible Community Topic workflow
<creating_community_topic>`.
+
+.. note::
+
+ Breaking changes will be introduced in Ansible 13.0.0. We encourage the use
of deprecation periods that give advance notice of breaking changes at least
one Ansible release before they are introduced. However, deprecation notices
are not guaranteed to take place.
+
+.. note::
+
+ In general, it is in the discretion of the release manager to delay a
release by 1-2 days for reasons such as personal (schedule) problems, technical
problems (CI/infrastructure breakdown), and so on.
+ However, in case two releases are planned for the same day, a release of the
latest stable version takes precedence. This means that if a stable Ansible 13
release collides with a pre-release of Ansible 14, the latter will be delayed.
+ If an Ansible 13 release collides with a stable Ansible 14 release,
including 14.0.0, the Ansible 13 release will be delayed.
+
+
+Ansible minor releases
+=======================
+
+Ansible 13.x follows ansible-core-2.20.x releases, so releases will occur
approximately every four weeks. If ansible-core delays a release for whatever
reason, the next Ansible 13.x minor release will usually (but not always) be
delayed accordingly.
+
+Ansible 13.x minor releases may contain new features (including new
collections) but not backwards incompatibilities. In practice, this means we
will include new collection versions where either the patch or the minor
version number has changed but not when the major number has changed. For
example, if Ansible-13.0.0 ships with community.crypto 3.3.0, Ansible-13.1.0
could ship with community.crypto 3.4.0 but not community.crypto 4.0.0.
+
+
+.. note::
+
+ Minor and patch releases will stop when Ansible-14 is released. See the
:ref:`Release and Maintenance Page <release_and_maintenance>` for more
information.
+
+.. note::
+
+ We will not provide bugfixes or security fixes for collections that do not
+ provide updates for their major release cycle included in Ansible 13.
+
+
+Communication
+=============
+
+You can submit feedback on the current roadmap by creating a :ref:`community
topic<creating_community_topic>`.
+
+Visit the :ref:`Ansible communication guide<communication>` for details on how
to join and use Ansible communication platforms.
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/ansible-documentation-2.19.4/docs/docsite/rst/roadmap/ROADMAP_2_20.rst
new/ansible-documentation-2.20.0/docs/docsite/rst/roadmap/ROADMAP_2_20.rst
--- old/ansible-documentation-2.19.4/docs/docsite/rst/roadmap/ROADMAP_2_20.rst
1970-01-01 01:00:00.000000000 +0100
+++ new/ansible-documentation-2.20.0/docs/docsite/rst/roadmap/ROADMAP_2_20.rst
2025-11-03 10:58:52.000000000 +0100
@@ -0,0 +1,65 @@
+.. _core_roadmap_2.20:
+
+*****************
+Ansible-core 2.20
+*****************
+
+.. contents::
+ :local:
+
+Release Schedule
+================
+
+Expected
+--------
+
+PRs must be raised sufficiently in advance of the following dates to have a
chance of inclusion in this ansible-core release.
+
+.. note:: Dates are subject to change.
+
+Development Phase
+^^^^^^^^^^^^^^^^^
+
+The ``milestone`` branch will be advanced at the start date of each
development phase and the beta 1 release.
+
+- 2025-08-18 Development Phase 5
+- 2025-09-22 Beta 1
+
+Release Phase
+^^^^^^^^^^^^^
+
+- 2025-09-15 Feature Freeze
+
+- 2025-09-22 Beta 1
+
+- 2025-10-13 Release Candidate 1
+
+- 2025-11-03 Release
+
+.. note:: The beta and release candidate schedules allow for up to 3 releases
on a weekly schedule depending on the necessity of creating a release.
+
+Release Manager
+===============
+
+Ansible Core Team
+
+Planned work
+============
+
+* Drop Python 3.11 and add Python 3.14 for controller code
+* Drop Python 3.8 and add Python 3.14 for target code
+* Tech preview of Play argument specs
+* Support for 3rd party fact injection plugins
+* Register Projections
+* Remove deprecated functionality
+* Add controller type hinting for discrete areas of the code
+* Decrease testing sanity ignores
+* Update ansible-test container images and VMs
+* Update ansible-test dependencies
+
+Delayed work
+============
+
+The following work has been delayed and retargeted for a future release:
+
+* TBD
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/ansible-documentation-2.19.4/docs/docsite/rst/roadmap/ansible_core_roadmap_index.rst
new/ansible-documentation-2.20.0/docs/docsite/rst/roadmap/ansible_core_roadmap_index.rst
---
old/ansible-documentation-2.19.4/docs/docsite/rst/roadmap/ansible_core_roadmap_index.rst
2025-11-03 10:59:30.000000000 +0100
+++
new/ansible-documentation-2.20.0/docs/docsite/rst/roadmap/ansible_core_roadmap_index.rst
2025-11-03 10:58:52.000000000 +0100
@@ -18,6 +18,7 @@
:glob:
:caption: ansible-core Roadmaps
+ ROADMAP_2_20
ROADMAP_2_19
ROADMAP_2_18
ROADMAP_2_17
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/ansible-documentation-2.19.4/docs/docsite/rst/roadmap/ansible_roadmap_index.rst
new/ansible-documentation-2.20.0/docs/docsite/rst/roadmap/ansible_roadmap_index.rst
---
old/ansible-documentation-2.19.4/docs/docsite/rst/roadmap/ansible_roadmap_index.rst
2025-11-03 10:59:30.000000000 +0100
+++
new/ansible-documentation-2.20.0/docs/docsite/rst/roadmap/ansible_roadmap_index.rst
2025-11-03 10:58:52.000000000 +0100
@@ -20,6 +20,7 @@
:glob:
:caption: Ansible Release Roadmaps
+ COLLECTIONS_13
COLLECTIONS_12
COLLECTIONS_11
COLLECTIONS_10
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/ansible-documentation-2.19.4/noxfile.py
new/ansible-documentation-2.20.0/noxfile.py
--- old/ansible-documentation-2.19.4/noxfile.py 2025-11-03 10:59:30.000000000
+0100
+++ new/ansible-documentation-2.20.0/noxfile.py 2025-11-03 10:58:52.000000000
+0100
@@ -154,7 +154,7 @@
)
[email protected](name="pip-compile", python="3.11")
[email protected](name="pip-compile", python="3.12")
@nox.parametrize(["req"], requirements_files, requirements_files)
def pip_compile(session: nox.Session, req: str):
"""
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/ansible-documentation-2.19.4/tests/README.md
new/ansible-documentation-2.20.0/tests/README.md
--- old/ansible-documentation-2.19.4/tests/README.md 1970-01-01
01:00:00.000000000 +0100
+++ new/ansible-documentation-2.20.0/tests/README.md 2025-11-03
10:58:52.000000000 +0100
@@ -0,0 +1,15 @@
+# Descriptions of requirements files
+
+The following table explains the purpose of the `.in` and `.txt` files in the
`tests/` directory of this repository:
+
+| File | Purpose
| Pip Constraints file (when relevant) |
+| ---- | -------
| ------------------------------------ |
+|constraints.in | Pins/version bounds for sphinx and antsibull-docs for
known issues | -- |
+|formatters.in | List of Formatters required
| formatters.txt |
+|pr_labeler.in | Dependencies for the labeler workflow
| pr_labeler.txt |
+|requirements.in | Dependencies for the Sphinx docs builds
| requirements.txt |
+|pip-compile.in | Dependencies for the `pip-compile` nox session
| pip-compile.txt |
+|spelling.in | Dependencies for the `spelling` nox session
| spelling.txt |
+|static.in | Dependencies for the `static` nox session
| static.txt |
+|tag.in | Dependencies for the `tag` nox session
| tag.txt |
+|typing.in | Dependencies for the `typing` nox session
| typing.txt |
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/ansible-documentation-2.19.4/tests/pip-compile.txt
new/ansible-documentation-2.20.0/tests/pip-compile.txt
--- old/ansible-documentation-2.19.4/tests/pip-compile.txt 2025-11-03
10:59:30.000000000 +0100
+++ new/ansible-documentation-2.20.0/tests/pip-compile.txt 2025-11-03
10:58:52.000000000 +0100
@@ -1,4 +1,4 @@
# This file was autogenerated by uv via the following command:
# uv pip compile --universal --output-file tests/pip-compile.txt
tests/pip-compile.in
-uv==0.6.14
+uv==0.8.19
# via -r tests/pip-compile.in
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/ansible-documentation-2.19.4/tests/requirements.txt
new/ansible-documentation-2.20.0/tests/requirements.txt
--- old/ansible-documentation-2.19.4/tests/requirements.txt 2025-11-03
10:59:30.000000000 +0100
+++ new/ansible-documentation-2.20.0/tests/requirements.txt 2025-11-03
10:58:52.000000000 +0100
@@ -6,7 +6,7 @@
# antsibull-fileutils
aiohappyeyeballs==2.6.1
# via aiohttp
-aiohttp==3.12.14
+aiohttp==3.12.15
# via
# antsibull-core
# antsibull-docs
@@ -50,22 +50,22 @@
# via
# sphinx
# sphinx-intl
-build==1.2.2.post1
+build==1.3.0
# via antsibull-core
-certifi==2025.7.14
+certifi==2025.8.3
# via requests
-cffi==1.17.1 ; platform_python_implementation != 'PyPy'
+cffi==2.0.0 ; platform_python_implementation != 'PyPy'
# via cryptography
-charset-normalizer==3.4.2
+charset-normalizer==3.4.3
# via requests
-click==8.2.1
+click==8.3.0
# via sphinx-intl
colorama==0.4.6 ; os_name == 'nt' or sys_platform == 'win32'
# via
# build
# click
# sphinx
-cryptography==45.0.5
+cryptography==46.0.1
# via -r tests/requirements.in
docutils==0.18.1
# via
@@ -93,7 +93,7 @@
# sphinx
markupsafe==3.0.2
# via jinja2
-multidict==6.6.3
+multidict==6.6.4
# via
# aiohttp
# yarl
@@ -113,9 +113,9 @@
# via
# aiohttp
# yarl
-pycparser==2.22 ; platform_python_implementation != 'PyPy'
+pycparser==2.23 ; implementation_name != 'PyPy' and
platform_python_implementation != 'PyPy'
# via cffi
-pydantic==2.11.7
+pydantic==2.11.9
# via
# antsibull-changelog
# antsibull-core
@@ -135,7 +135,7 @@
# antsibull-docs
# antsibull-fileutils
# yamllint
-requests==2.32.4
+requests==2.32.5
# via sphinx
resolvelib==1.2.0
# via
@@ -152,8 +152,6 @@
# antsibull-changelog
# antsibull-core
# antsibull-docs
-setuptools==80.9.0
- # via sphinx-intl
six==1.17.0
# via twiggy
snowballstemmer==3.0.1
@@ -174,7 +172,7 @@
# via -r tests/requirements.in
sphinx-copybutton==0.5.2
# via -r tests/requirements.in
-sphinx-intl==2.3.1
+sphinx-intl==2.3.2
# via -r tests/requirements.in
sphinx-notfound-page==1.1.0
# via -r tests/requirements.in
@@ -205,7 +203,7 @@
# antsibull-docs
types-docutils==0.18.3
# via rstcheck
-typing-extensions==4.14.1
+typing-extensions==4.15.0
# via
# aiosignal
# pydantic
++++++ ansible-documentation.obsinfo ++++++
--- /var/tmp/diff_new_pack.3nIhAy/_old 2025-11-21 16:55:45.764045287 +0100
+++ /var/tmp/diff_new_pack.3nIhAy/_new 2025-11-21 16:55:45.768045455 +0100
@@ -1,5 +1,5 @@
name: ansible-documentation
-version: 2.19.4
-mtime: 1762163970
-commit: e4cca7c5d18391fe5db732286fe9583ff7a4929a
+version: 2.20.0
+mtime: 1762163932
+commit: 99dbb9dcb1e6eb1dde008606c19fea412bfbe28f
