Hi all-

For all those wanting to test the next version of Ansible, we're happy
to announce that Ansible 2.10.0 alpha7 is now available on PyPI!

Ansible 2.10.0a7 pulls in the ansible-base package (currently at
version 2.10.0rc4 on PyPI) via a dependency and includes a range of
Ansible Collections. The Ansible 2.10 PyPI packages provide similar
functionality to Ansible 2.9 and earlier versions, but from multiple
sources. The included Ansible Collections are maintained by a host of
open source contributors who want to add to what ansible-base has to offer.

For an overview of "Ansible Collections" and the differences between
`ansible-base` and `ansible`  please see
https://github.com/ansible-collections/overview/blob/master/README.rst

We need your help
-----------------

This new `ansible` package *should* be a drop-in replacement for
Ansible 2.9. The roles and playbooks that you currently use should
work out of the box with ansible-2.10.0 alpha7.

Please let us know if:

* Your playbooks don't work
* There are any installation issues
* Whether the collections are found OK
* If the updated and new modules in the collections work

How to get it
-------------

Due to a limitation in pip, you need to uninstall Ansible 2.9 (or
earlier) before installing the 2.10 version:

$ pip uninstall ansible
$ pip install ansible==2.10.0a7 --user

The tar.gz of the release can be found here:

* Ansible 2.10.0a7
  https://pypi.python.org/packages/source/a/ansible/ansible-2.10.0a7.tar.gz
  SHA256: bbf64f7dbd406baabe9fe8688d4da03afa010a8cc49186e56df00f7af1aef81a


What's new in Ansible 2.10.0a7
------------------------------

There is now a unified changelog for the Ansible-2.10.0 release.
Collections which have opted into being a part of that will have an
entry on this page:
https://github.com/ansible-community/ansible-build-data/blob/main/2.10/CHANGELOG-v2.10.rst

* A collections have been updated this release and the ansible-base
package dependency has been updated to 2.10.0rc4.  Please see the
list of dependent collections in the link below.

* List of collections included in the 2.10.0a7 release:
  * 
https://github.com/ansible-community/ansible-build-data/blob/2.10.0a7/2.10/acd-2.10.0a7.deps
  * You can find more information for those on
https://galaxy.ansible.com/.  For instance, the community.crypto
collection listed in the acd-2.10.0a7.deps file has a galaxy page here
at https://galaxy.ansible.com/community/crypto/

* Changelog for ansible-base-2.10.0rc4 which this release of ansible installs:
  
https://github.com/ansible/ansible/blob/stable-2.10/changelogs/CHANGELOG-v2.10.rst


Caveats and known bugs
----------------------

* The individual collections that make up the ansible-2.10.0 package
can be viewed independently.  However, they aren't currently listed by
ansible-galaxy.  A workaround for this is to explicitly specify where
ansible has installed the collections::

    COLLECTION_INSTALL=$(python -c 'import ansible, os.path ;
print("%s/../ansible_collections" %
os.path.dirname(ansible.__file__))') ansible-galaxy collection list -p
"$COLLECTION_INSTALL"

  * A fix has been proposed but will not be merged before 2.10.0.
This is being tracked in this bug report:
https://github.com/ansible/ansible/issues/70147

* Due to a limitation in pip, you cannot `pip install --upgrade` from
ansible-2.9 or earlier to ansible-2.10 or higher.  Instead, you must
explicitly `pip uninstall ansible` before pip installing the new
version.  The install of the ansible package has been modified to warn
you if you attempt to upgrade via pip with instructions to uninstall
first.


What's the schedule for the rest of the 2.10.0 release cycle?
-------------------------------------------------------------


The Ansible package depends on the Ansible-Base package so we're
planning on releasing it after Ansible-Base final.  The current
schedule for Ansible-Base (subject to change if blocker bugs are
found) places its release on 13-August-2020[1]_.  Based on that, our
current, **tentative** schedule will see the ansible-2.10.0
final release on 22-September-2020.  However, there's still a lot of
room for that to change as we figure out just how much work and
coordination there is to do between ansible-base's 2.10.0 final
release and ansible's 2.10.0 final.

.. [1]: 
https://github.com/ansible/ansible/blob/devel/docs/docsite/rst/roadmap/ROADMAP_2_10.rst


Porting Help
------------

We're working on a unified porting guide for the Ansible 2.10.0 final
release.  Until then, use the ansible-base porting guide to get
familiar with the larger changes:

https://docs.ansible.com/ansible/2.10/porting_guides/porting_guide_2.10.html

If you encounter any bugs, please report them at one of the following places:

* Bugs in ansible-base:  https://github.com/ansible/ansible/issues/new/choose
* Bugs in a module or plugin in a collection should be filed in the
relevant collection repo, normally one of the repos here:
https://github.com/ansible-collections/
* Bugs in the way the new ansible is packaged:
https://github.com/ansible-community/antsibull

If you aren't sure where to file the bug, pick which you feel is
closest and the Community Team will always move it if needed

Thanks!

-Toshio Kuratomi

-- 
You received this message because you are subscribed to the Google Groups 
"Ansible Development" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to ansible-devel+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/ansible-devel/CAPrnkaSwg6F-ohzVxYKSQcWY7kV%2BNvgq0Y68NDmhTgaQWyJkow%40mail.gmail.com.

Reply via email to