Hi all-

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

Ansible 2.10.0a9 pulls in the ansible-base-2.10.0 package 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 alpha9.

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

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

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


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

* 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.0a9 release:
  * 
https://github.com/ansible-community/ansible-build-data/blob/2.10.0a9/2.10/ansible-2.10.0a9.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.0a9.deps file has a galaxy page
here at https://galaxy.ansible.com/community/crypto/

* Changelog for ansible-base-2.10.0 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 was not be merged for 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?
-------------------------------------------------------------

At a meeting this week it was decided that the ansible-2.10.0 package
should require ansible-base-2.10.1 so that a few changes to
ansible-base-2.10.1 would be applied when ansible-2.10.0 is released.
The proposed schedule for ansible-base-2.10.1 should allow for this to
fit into the current Ansible release schedule with one minor slip for
the first release candidate of ansible-2.10.0 (rc1 will ship on
September 10th rather than September 8th).  The schedule still places
the final release of ansible-2.10.0 on 22-September-2020.  The
ansible-2.10 roadmap has been updated to reflect the new rc1 date:
https://docs.ansible.com/ansible/devel/roadmap/COLLECTIONS_2_10.html

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

We're working on a unified porting guide for collections which have
opted-in.  You can find that at:
https://github.com/ansible/ansible/blob/devel/docs/docsite/rst/porting_guides/porting_guide_2.10.rst
 It will be updated for ansible-2.10.0a9 shortly (probably early next
week).

If you encounter any bugs, please report them.  We're putting together
a draft document which includes where to report bugs on various parts
of the ansible package:
https://github.com/ansible/community/wiki/User-testing-of-ansible-2.10-pre-releases

If you aren't sure where your bug falls, 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/CAPrnkaSTq0sYOXXOGm%2B45oJXcsKwxjekFTuJZNjbTNBhMc5MXA%40mail.gmail.com.

Reply via email to