summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSandra McCann <samccann@redhat.com>2022-09-15 15:40:55 -0400
committerGitHub <noreply@github.com>2022-09-15 14:40:55 -0500
commite69c1812c91cae6c7a6e50d1874f11a427d23fa6 (patch)
tree936ab6b5696faab22b79b2c71b9006307660e18d
parent811d05e1ba7af83b6a8ffa4ab30327adc0a180ed (diff)
downloadansible-e69c1812c91cae6c7a6e50d1874f11a427d23fa6.tar.gz
Backportapalooza 9 15 (#78787)
* add galaxy docs back to core' (#78764) (cherry picked from commit df6a564abd9a63e1bff0ad14f9b800ceccc2da31) * Ansible 6.4.0: Porting Guide (#78775) (cherry picked from commit d4407ca68822b1f12254957ec9918f94c23d374f) * Documented connection parameters required to enable scp (OpenSSH >=9.0) (#78745) (cherry picked from commit 952ee88f33de4d49ff5f7bd4bec3431a4b0fdc78) * Fix Issue #78564 (#78741) (cherry picked from commit f50ff1c2dbb2eee88b2ac9e50e9f13d942e41f12) * faq legacy vs builtin (#78769) (cherry picked from commit db33ca8e1a8b9805eb0a074eee86aaa2237065cd) * Removed repeated introduction paragraph (#78691) (cherry picked from commit e276770ee9efac3a98c3f1116d9cd9c992ca8c9e) Co-authored-by: Ompragash Viswanathan <21008429+Ompragash@users.noreply.github.com> Co-authored-by: wnjuguna <jbworldus@gmail.com> Co-authored-by: Ronan <ronandoudies@gmail.com> Co-authored-by: Brian Coca <bcoca@users.noreply.github.com>
-rw-r--r--docs/docsite/rst/core_index.rst6
-rw-r--r--docs/docsite/rst/dev_guide/testing.rst10
-rw-r--r--docs/docsite/rst/porting_guides/porting_guide_6.rst17
-rw-r--r--docs/docsite/rst/reference_appendices/faq.rst29
-rw-r--r--docs/docsite/sphinx_conf/core_conf.py1
-rw-r--r--docs/docsite/sphinx_conf/core_lang_conf.py1
-rw-r--r--lib/ansible/modules/unarchive.py3
-rw-r--r--lib/ansible/plugins/connection/ssh.py2
8 files changed, 56 insertions, 13 deletions
diff --git a/docs/docsite/rst/core_index.rst b/docs/docsite/rst/core_index.rst
index 82bfdca977..b4cce2dae2 100644
--- a/docs/docsite/rst/core_index.rst
+++ b/docs/docsite/rst/core_index.rst
@@ -65,6 +65,12 @@ This documentation covers the version of ``ansible-core`` noted in the upper lef
dev_guide/index
+.. toctree::
+ :maxdepth: 2
+ :caption: Ansible Galaxy
+
+ galaxy/user_guide.rst
+ galaxy/dev_guide.rst
.. toctree::
:maxdepth: 1
diff --git a/docs/docsite/rst/dev_guide/testing.rst b/docs/docsite/rst/dev_guide/testing.rst
index d111973616..b065f69e8a 100644
--- a/docs/docsite/rst/dev_guide/testing.rst
+++ b/docs/docsite/rst/dev_guide/testing.rst
@@ -41,16 +41,6 @@ At a high level we have the following classifications of tests:
* Tests directly against individual parts of the code base.
-If you're a developer, one of the most valuable things you can do is look at the GitHub
-issues list and help fix bugs. We almost always prioritize bug fixing over feature
-development.
-
-Even for non developers, helping to test pull requests for bug fixes and features is still
-immensely valuable. Ansible users who understand writing playbooks and roles should be
-able to add integration tests and so GitHub pull requests with integration tests that show
-bugs in action will also be a great way to help.
-
-
Testing within GitHub & Azure Pipelines
=======================================
diff --git a/docs/docsite/rst/porting_guides/porting_guide_6.rst b/docs/docsite/rst/porting_guides/porting_guide_6.rst
index 42c972fb47..518b50acef 100644
--- a/docs/docsite/rst/porting_guides/porting_guide_6.rst
+++ b/docs/docsite/rst/porting_guides/porting_guide_6.rst
@@ -99,6 +99,23 @@ Networking
No notable changes
+Porting Guide for v6.4.0
+========================
+
+Added Collections
+-----------------
+
+- inspur.ispim (version 1.0.1)
+- vultr.cloud (version 1.1.0)
+
+Deprecated Features
+-------------------
+
+community.general
+~~~~~~~~~~~~~~~~~
+
+- proxmox - deprecated the current ``unprivileged`` default value, will be changed to ``true`` in community.general 7.0.0 (https://github.com/pull/5224).
+
Porting Guide for v6.3.0
========================
diff --git a/docs/docsite/rst/reference_appendices/faq.rst b/docs/docsite/rst/reference_appendices/faq.rst
index 486fb5f09a..feeb99bdac 100644
--- a/docs/docsite/rst/reference_appendices/faq.rst
+++ b/docs/docsite/rst/reference_appendices/faq.rst
@@ -845,6 +845,35 @@ How do I submit a change to the documentation?
Documentation for Ansible is kept in the main project git repository, and complete instructions
for contributing can be found in the docs README `viewable on GitHub <https://github.com/ansible/ansible/blob/devel/docs/docsite/README.md>`_. Thanks!
+
+.. _legacy_vs_builtin:
+
+What is the difference between ``ansible.legacy`` and ``ansible.builtin`` collections?
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+Neither is a real collection. They are virtually constructed by the core engine (synthetic collections).
+
+The ``ansible.builtin`` collection only refers to plugins that ship with ``ansible-core``.
+
+The ``ansible.legacy`` collection is a superset of ``ansible.builtin`` (you can reference the plugins from builtin through ``ansible.legacy``). You also get the ability to
+add 'custom' plugins in the :ref:`configured paths and adjacent directories <ansible_search_path>`, with the ability to override the builtin plugins that have the same name.
+
+Also, ``ansible.legacy`` is what you get by default when you do not specify an FQCN.
+So this:
+
+ .. code-block:: yaml
+
+ - shell: echo hi
+
+Is really equivalent to:
+
+ .. code-block:: yaml
+
+ - ansible.legacy.shell: echo hi
+
+Though, if you do not override the ``shell`` module, you can also just write it as ``ansible.builtin.shell``, since legacy will resolve to the builtin collection.
+
+
.. _i_dont_see_my_question:
I don't see my question here
diff --git a/docs/docsite/sphinx_conf/core_conf.py b/docs/docsite/sphinx_conf/core_conf.py
index f135eca791..5b34a45cac 100644
--- a/docs/docsite/sphinx_conf/core_conf.py
+++ b/docs/docsite/sphinx_conf/core_conf.py
@@ -94,7 +94,6 @@ exclude_patterns = [
'2.10_index.rst',
'ansible_index.rst',
'core_index.rst',
- 'galaxy',
'network',
'scenario_guides',
'community/collection_contributors/test_index.rst',
diff --git a/docs/docsite/sphinx_conf/core_lang_conf.py b/docs/docsite/sphinx_conf/core_lang_conf.py
index a164dd67aa..7e01eda358 100644
--- a/docs/docsite/sphinx_conf/core_lang_conf.py
+++ b/docs/docsite/sphinx_conf/core_lang_conf.py
@@ -94,7 +94,6 @@ exclude_patterns = [
'2.10_index.rst',
'ansible_index.rst',
'core_index.rst',
- 'galaxy',
'network',
'scenario_guides',
'community/collection_contributors/test_index.rst',
diff --git a/lib/ansible/modules/unarchive.py b/lib/ansible/modules/unarchive.py
index c5da961573..7ac19fc7d9 100644
--- a/lib/ansible/modules/unarchive.py
+++ b/lib/ansible/modules/unarchive.py
@@ -123,7 +123,8 @@ attributes:
bypass_host_loop:
support: none
check_mode:
- support: full
+ support: partial
+ details: Not supported for gzipped tar files.
diff_mode:
support: partial
details: Uses gtar's C(--diff) arg to calculate if changed or not. If this C(arg) is not supported, it will always unpack the archive.
diff --git a/lib/ansible/plugins/connection/ssh.py b/lib/ansible/plugins/connection/ssh.py
index e3b7cec68c..b9d1f1052a 100644
--- a/lib/ansible/plugins/connection/ssh.py
+++ b/lib/ansible/plugins/connection/ssh.py
@@ -292,6 +292,7 @@ DOCUMENTATION = '''
description:
- "Preferred method to use when transferring files over ssh"
- Setting to 'smart' (default) will try them in order, until one succeeds or they all fail
+ - For OpenSSH >=9.0 you must add an additional option to enable scp (scp_extra_args="-O")
- Using 'piped' creates an ssh pipe with C(dd) on either side to copy the data
choices: ['sftp', 'scp', 'piped', 'smart']
env: [{name: ANSIBLE_SSH_TRANSFER_METHOD}]
@@ -310,6 +311,7 @@ DOCUMENTATION = '''
- "Preferred method to use when transferring files over SSH."
- When set to I(smart), Ansible will try them until one succeeds or they all fail.
- If set to I(True), it will force 'scp', if I(False) it will use 'sftp'.
+ - For OpenSSH >=9.0 you must add an additional option to enable scp (scp_extra_args="-O")
- This setting will overridden by ssh_transfer_method if set.
env: [{name: ANSIBLE_SCP_IF_SSH}]
ini: