Open Stack

We joyfully announce the release of:

keystoneauth1 3.18.0: Authentication Library for OpenStack Identity

This release is part of the ussuri release series.

The source is available from:

    https://opendev.org/openstack/keystoneauth1

Download the package from:

    https://pypi.org/project/keystoneauth1

For more details, please see below.

3.18.0
^^^^^^


New Features
************

* [feature bug 1840235
  (https://bugs.launchpad.net/keystoneauth/+bug/1840235)] Adds
  "connect_retries" to Session.__init__(), that can then be used by
  projects when creating session objects, to set the required number
  of retries for new connection requests. This would specifically help
  avoid a scalability issue that results in number of  ConnectTimeout
  errors when doing endpoint discovery and fetching roles using an
  auth plugin under heavy load. This still allows for it to be
  overridden per service with the adapter interface.


Upgrade Notes
*************

* If keystoneauth and openstacksdk are both in use and keystoneauth
  is upgraded to this release **before** upgrading openstacksdk to
  "0.36.1" or later, creation of ServerGroup objects with policies and
  use of Ansible Inventory could be adversely affected. See
  https://review.opendev.org/#/c/685999/ for more details.


Bug Fixes
*********

* [bug 1838704 (https://bugs.launchpad.net/keystone/+bug/1838704)]
  When consuming keystoneauth1.session.Session, if a requests session
  is not provided one is created. The Session used for requests may
  result in a ResourceWarning being generated if it is not properly
  closed. The code has been updated to close the session correctly
  when the Session object is deleted.

* Retry version discovery with auth token when the initial request
  throws 401 Unauthorized. There are some services that are
  erroneously defaulting to authenticated discovery, and this allows
  discovery to work properly on them.

Changes in keystoneauth1 3.17.1..3.18.0
---------------------------------------

26ad02d Fetch discovery documents with auth when needed
4461358 Make tests pass in 2020
0c34f0f Generate pdf documentation
249d1e9 Follow the PTI for docs
8289f15 Update master for stable/train
b59ef48 Fix misspell word
373cbdb Allow initializing session with connection retries
b2b5ad3 Cleanup session on delete


Diffstat (except docs and test files)
-------------------------------------

keystoneauth1/discover.py                          | 12 ++++-
keystoneauth1/session.py                           | 31 +++++++++--
.../notes/bug-1840235-ef2946d149ac329c.yaml        | 11 ++++
...cleanup-session-on-delete-1ed6177d4c5c1f83.yaml |  9 ++++
...y-authenticated-discovery-19c4354ff983f507.yaml | 14 +++++
releasenotes/source/index.rst                      |  1 +
releasenotes/source/train.rst                      |  6 +++
requirements.txt                                   |  2 +-
tox.ini                                            | 14 ++++-
17 files changed, 214 insertions(+), 30 deletions(-)


Requirements updates
--------------------

diff --git a/requirements.txt b/requirements.txt
index e88d1ff..699e6a8 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -7 +7 @@
-# NOTE(morgan) At no time may any olso library be added to the keystoneauth
+# NOTE(morgan) At no time may any oslo library be added to the keystoneauth