Hi all-

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

Ansible 2.10.0a8 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 alpha8.

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.0a8 --user

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

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


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

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

* For other collections, consult the list of included collections in
the link below and check their entry on https://galaxy.ansible.com for
information about their changes.

* List of collections included in the 2.10.0a8 release:
  * 
https://github.com/ansible-community/ansible-build-data/blob/2.10.0a8/2.10/ansible-2.10.0a8.deps
  * You can find more information for those on
https://galaxy.ansible.com/.  For instance, the community.crypto
collection listed in the ansible-2.10.0a8.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[2]_.  However, there's still room
for that to change so take it with a small grain of salt.

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

.. [2]: https://docs.ansible.com/ansible/devel/roadmap/COLLECTIONS_2_10.html

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/CAPrnkaTCHbiZR8_B3rrQLsftHMrcj%2B_EFpbTyK-qCwAxgdOQNw%40mail.gmail.com.

Reply via email to