some migrations notes changes

This commit is contained in:
Mike McLean 2020-07-23 13:45:13 -04:00 committed by Yuming Zhu
parent bad5cf0649
commit cd21cba7d8

View file

@ -6,13 +6,13 @@ You should consider the following changes when migrating to 1.22:
DB Updates
----------
There are no big database schema changes in this release.
There are two minor schema changes in this release.
We've updated all ``timestamp`` fields to ``timestamptz`` with the return value of
``get_event_time()`` function to avoid unexpected time offset caused by PostgreSQL timezone setting
(`PR#2237 <https://pagure.io/koji/pull-request/2237>`_) and regenerate
``sessions_active_and_recent`` index for ``session`` table for better performance (`PR#2334
<https://pagure.io/koji/pull-request/2334>`_)
* we've updated all ``timestamp`` fields to ``timestamptz`` with the return value of
``get_event_time()`` function to avoid unexpected time offset caused by PostgreSQL timezone
setting (`PR#2237 <https://pagure.io/koji/pull-request/2237>`_).
* we've updated the ``sessions_active_and_recent`` index for the ``session`` table for better
performance (`PR#2334 <https://pagure.io/koji/pull-request/2334>`_)
As in previous releases, we provide a migration script that updates the database.
@ -24,19 +24,26 @@ As in previous releases, we provide a migration script that updates the database
Dropped python2 support of hub and web
--------------------------------------
As Python2 has retired since Jan 1, 2020, we are now only providing python3 hub and web since koji
1.22. CLI, builder, and utils are not impacted. (`PR#2218
<https://pagure.io/koji/pull-request/2218>`_)
Python 2 was `sunset <https://www.python.org/doc/sunset-python-2/>`_ on January 1, 2020.
Starting with Koji 1.22, hub and web will only support Python 3.
The CLI, builder, and utils retain Python 2 support for now.
For more information see: `PR#2218 <https://pagure.io/koji/pull-request/2218>`_
Dropped krbV authentication support
-----------------------------------
As python-krbV is for python2 only, we dropped all the code related to krbV, and are now only
providing GSSAPI auth. For ``ClientSession`` object, ``krb_login()`` is redirected to
``gssapi_login()`` now, and you'd better change your client code to call the latter directly. Making
sure you have ``python-requests-kerberos`` installed on old client with koji 1.22 hub. (`PR#2244
<https://pagure.io/koji/pull-request/2244>`_)
We have dropped all the code related to the old python-krbV library, and are now only
providing GSSAPI auth.
For ``ClientSession`` objects, ``krb_login()`` is redirected to
``gssapi_login()`` with a printed warning.
Any code still calling ``krb_login()`` directly should be updated.
The newer gssapi authentication mechanism requires either ``python-requests-kerberos`` or
``python-requests-gssapi``.
For more information see: `PR#2244 <https://pagure.io/koji/pull-request/2244>`_ and
`PR#2280 <https://pagure.io/koji/pull-request/2280>`_
Other changes