PR#3822: Koji 1.33 release notes

Merges #3822
https://pagure.io/koji/pull-request/3822

Fixes: #3821
https://pagure.io/koji/issue/3821
1.33 release notes

docs/source/migrations/migrating_to_1.33.rst

@@ -0,0 +1,22 @@
+Migrating to Koji 1.33
+======================
+
+You should consider the following changes when migrating to 1.33:
+
+DB Updates
+----------
+
+There is a simple schema change adding new index.
+
+As in previous releases, we provide a migration script that updates the database.
+
+::
+
+    # psql koji koji < /usr/share/doc/koji/docs/schema-upgrade-1.32-1.33.sql
+
+
+Other changes
+-------------
+
+There are numerous other changes in 1.33 that should not have a direct impact on migration. For
+details see: :doc:`../release_notes/release_notes_1.33`

docs/source/migrations/migrations.rst

@@ -5,6 +5,7 @@ Migrations
 .. toctree::
     :maxdepth: 1
 
+    migrating_to_1.33
     migrating_to_1.32
     migrating_to_1.31
     migrating_to_1.30

docs/source/release_notes/release_notes.rst

@@ -5,6 +5,7 @@ Release Notes
 .. toctree::
     :maxdepth: 1
 
+    release_notes_1.33
     release_notes_1.32.1
     release_notes_1.32
     release_notes_1.31.1

docs/source/release_notes/release_notes_1.33.rst

@@ -0,0 +1,254 @@
+
+Koji 1.32.0 Release notes
+=========================
+
+All changes can be found in `the roadmap <https://pagure.io/koji/roadmap/1.32/>`_.
+Most important changes are listed here.
+
+Migrating from Koji 1.31/1.31.1
+-------------------------------
+
+For details on migrating see :doc:`../migrations/migrating_to_1.32`
+
+Security Fixes
+--------------
+
+None
+
+Client Changes
+--------------
+**Let "--principal=" works for users using multiple TGT's**
+
+| PR: https://pagure.io/koji/pull-request/3686
+
+CLI now allows specifying ``--principal`` even if keytab is not used for
+authentication.
+
+**Add repoID in listBuildroots and create repoinfo command**
+
+| PR: https://pagure.io/koji/pull-request/3707
+
+New ``repoinfo`` command is available which will display information previously
+available only via combination of API calls.
+
+**Add component/built archives in list-buildroot**
+
+| PR: https://pagure.io/koji/pull-request/3769
+
+Only RPMs were dislayed before while web UI listed also additional types. This
+is now on par.
+
+**list-tagged: Only check for build dir when --sigs is given**
+
+| PR: https://pagure.io/koji/pull-request/3720
+
+With ``--paths`` and without ``--sigs`` it should be possible to list paths
+even without real access to koji storage.
+
+**download-build: Preserve build artefacts last modification time**
+
+| PR: https://pagure.io/koji/pull-request/3712
+| PR: https://pagure.io/koji/pull-request/3727
+
+When files are downloaded mtime is set to corresponding mtime on koji storage.
+
+**Cancel error msg**
+
+| PR: https://pagure.io/koji/pull-request/3716
+| PR: https://pagure.io/koji/pull-request/3746
+
+More informative messages when ``cancel`` is used. E.g. when it is called
+against non-existent build it will raise an error instead of just returning
+``False``.
+
+API Changes
+-----------
+**tagNotification: user_id is int when get_user is used**
+
+| PR: https://pagure.io/koji/pull-request/3780
+
+``tagNotification`` now uses "nicer" variant when it passes only ``user_id``
+instead of full userinfo dictionary.
+
+**Remove Host.getTask method**
+
+| PR: https://pagure.io/koji/pull-request/3784
+
+Final removal of deprecated and unused builder-only method.
+
+System Changes
+--------------
+**Only pad header lengths for signature headers**
+
+| PR: https://pagure.io/koji/pull-request/3690
+
+In some cases incorrect signature header lengths were reported. There is no
+impact on koji functions but anyone using the library could have seen these
+distorted values.
+
+**Avoid noisy chained tracebacks when converting Faults**
+
+| PR: https://pagure.io/koji/pull-request/3800
+
+Python 3 added chained tracebacks which can be really noisy. We're now
+displaying just relevant part.
+
+**createTag raises error when perm ID isn't exists**
+
+| PR: https://pagure.io/koji/pull-request/3803
+
+Postgres error replaced with more standard koji exception.
+
+**Add renewal session timeout**
+
+| PR: https://pagure.io/koji/pull-request/3760
+
+It is a followup of behaviour added in previous release. Sessions could expire
+if they exist too long. Anyway, first patch implemented the behaviour itself,
+now we're adding also hub option ``SessionRenewalTimeout``. After this timeout
+session holder needs to reauthenticate (0 could be set for disabling this).
+
+**Unify behavior when result is empty in get_maven/image/win/build**
+
+| PR: https://pagure.io/koji/pull-request/3754
+
+Error is raised in all cases now.
+
+**RawHeader improvements**
+
+| PR: https://pagure.io/koji/pull-request/3703
+
+For users of koji library there are some more improvements to ``RawHeader``
+which can now e.g. display signature headers better.
+
+**Build image from uploaded kickstart**
+
+| PR: https://pagure.io/koji/pull-request/3729
+
+Previously, only scratch builds were allowed to be built from local kickstarts.
+Anyway, as this file is stored in the build, it is safe to do it also for
+non-scratch content. As a side-effect ``build_rpm`` policy is now consulted for
+image builds.
+
+**Add more logging to rmtree**
+
+| PR: https://pagure.io/koji/pull-request/3756
+
+Additional logging was added to library function to better debug garbage
+collector issues.
+
+**New scheduler work**
+
+| PR: https://pagure.io/koji/pull-request/3678
+| PR: https://pagure.io/koji/pull-request/3819
+| PR: https://pagure.io/koji/pull-request/3820
+
+During next release or two we're bringing first phase of new scheduler (moving
+scheduling logic from builders to hub). Some support functions can be already
+merged.
+
+ * ``db/auth.py`` was moved to kojihub module as it is hub only code.
+ * We're now tracking builder update time in host table
+ * ``db_lock()`` "silent" nowait locking to not flood hub logs
+
+Kojira
+------
+**Prioritize awaited repos**
+
+| PR: https://pagure.io/koji/pull-request/3798
+
+Any tag which has corresponding ``waitrepo`` task is given slightly higher
+priority. It is useful mainly for MBS, but also chainbuilds should be a bit
+faster.
+
+Plugins
+-------
+**Kiwi: Import koji archive types**
+
+| PR: https://pagure.io/koji/pull-request/3775
+
+For new users it was confusing to manually add required archive types, so they
+are now prepopulated.
+
+**Sidetag: Editing extra and allowed list for rpm macros**
+
+| PR: https://pagure.io/koji/pull-request/3674
+| PR: https://pagure.io/koji/pull-request/3701
+
+New ``extra`` options ``sidetag_debuginfo_allowed`` and ``sidetag_rpm_macros_allowed`` could be set up in parent tags. Sidetags derived from such tags can alter these extra settings.
+
+VM
+--
+**vm: Retry libvirt connection**
+
+| PR: https://pagure.io/koji/pull-request/3679
+
+In case libvirt dies or is restarted, ``kojivmd`` will pick the new connection
+without restart needed.
+
+Content Generators
+------------------
+**Allow reimports into failed/cancelled builds**
+
+| PR: https://pagure.io/koji/pull-request/3777
+
+Similarly to regular builds, CGs now can reuse failed or cancelled builds.
+
+**Save task_id correctly also in CGInitBuild**
+
+| PR: https://pagure.io/koji/pull-request/3751
+
+Last release introduced CG's ability to store relevant ``task_id`` in
+buildinfo. Nevertheless, there was not consistent behaviour with and without
+using build reservations. This is now fixed.
+
+Utilities
+---------
+**koji-gc: fail on additional arguments**
+
+| PR: https://pagure.io/koji/pull-request/3687
+
+Simple update to fail if some unrecognized options are supplied.
+
+Documentation
+-------------
+**kiwi: Remove tech-preview warning**
+
+| PR: https://pagure.io/koji/pull-request/3816
+
+Kiwi is production-ready now and interface shouldn't change in near future.
+
+**Emphasize new build_from_scm hub policy**
+
+| PR: https://pagure.io/koji/pull-request/3778
+
+**Fix doc links**
+
+| PR: https://pagure.io/koji/pull-request/3691
+
+Devtools and tests
+------------------
+
+**Tests**
+
+| PR: https://pagure.io/koji/pull-request/3722
+| PR: https://pagure.io/koji/pull-request/3738
+| PR: https://pagure.io/koji/pull-request/3747
+| PR: https://pagure.io/koji/pull-request/3752
+| PR: https://pagure.io/koji/pull-request/3771
+| PR: https://pagure.io/koji/pull-request/3773
+| PR: https://pagure.io/koji/pull-request/3781
+| PR: https://pagure.io/koji/pull-request/3791
+| PR: https://pagure.io/koji/pull-request/3799
+
+**Use fakehub as a user**
+
+| PR: https://pagure.io/koji/pull-request/3804
+
+``--user`` option for ``fakehub``
+
+**fakehub --pdb option**
+
+| PR: https://pagure.io/koji/pull-request/3783
+
+Drop into debugger on error.

koji.spec

@@ -83,7 +83,7 @@
 %define release %{baserelease}
 %endif
 Name: koji
-Version: 1.32.1
+Version: 1.33.0
 Release: %{release}%{?dist}
 License: LGPL-2.1-only and GPL-2.0-or-later
 # the included arch lib from yum's rpmUtils is GPLv2+
@@ -648,6 +648,54 @@ rm -rf $RPM_BUILD_ROOT
 %endif
 
 %changelog
+* Tue May 16 2023  Tomas Kopecek <tkopecek at redhat.com> - 1.33.0-1
+- PR#3775: Import koji archive types
+- PR#3816: kiwi: remove tech-preview warning
+- PR#3800: avoid noisy chained tracebacks when converting Faults
+- PR#3782: Fix typo
+- PR#3803: createTag raises error when perm ID isn't exists
+- PR#3799: Increase sidetag CLI tests
+- PR#3804: use fakehub as a user
+- PR#3769: Add component/built archives in list-buildroot
+- PR#3760: Add renewal session timeout
+- PR#3798: kojira: prioritize awaited repos
+- PR#3777: CG: allow reimports into failed/cancelled builds
+- PR#3791: Increase hub unit tests
+- PR#3788: fix syntax for tox 4.4.8
+- PR#3741: vm: ignore B113: request_without_timeout
+- PR#3784: remove Host.getTask method
+- PR#3783: fakehub --pdb option
+- PR#3780: tagNotification: user_id is int when get_user is used
+- PR#3781: Set COLUMNS for tests to handle different terminals
+- PR#3778: docs: Emphasize new build_from_scm hub policy
+- PR#3773: Fix prune-signed-copies unit tests
+- PR#3751: Save task_id correctly also in CGInitBuild
+- PR#3763: Update deprecated policy comments
+- PR#3771: prune-signed-copies unit tests
+- PR#3754: Unify behavior when result is empty in get_maven/image/win/build
+- PR#3746: Fix backward compatibility
+- PR#3707: Add repoID in listBuildroots and create repoinfo command
+- PR#3752: Increase hub unit tests 03-02
+- PR#3747: Fix editSidetag fstring variable formats and fix test unit tests
+- PR#3722: Increate sidetag hub unit tests
+- PR#3745: Fix pkglist_add when extra_arches is None
+- PR#3703: RawHeader improvements
+- PR#3738: Increase CLI uni tests
+- PR#3720: list-tagged: only check for build dir when --sigs is given
+- PR#3727: Fix mtime logic for py2.x
+- PR#3690: only pad header lengths for signature headers
+- PR#3679: vm: Retry libvirt connection
+- PR#3687: koji-gc: fail on additional arguments
+- PR#3674: sidetag: allowed list for rpm macros
+- PR#3712:  download-build: preserve build artefacts last modification time
+- PR#3716: CLI: cancel error msg
+- PR#3699: Set daemon = true instead of call deaprecated setDaemon
+- PR#3686: Let "--principal=" works for users using multiple TGT's
+- PR#3678: Move db/auth to kojihub module
+- PR#3701: Editing extra in sidetags
+- PR#3695: remove debug print
+- PR#3691: fix doc links
+
 * Fri Feb  3 2023  Tomas Kopecek <tkopecek at redhat.com> - 1.32.0-1
 - PR#3530: use_fast_upload=True as default everywhere
 - PR#3562: rpmdiff: replace deprecated rpm call

koji/_version.py

@@ -1,2 +1,2 @@
-__version_info__ = (1, 32, 1)
+__version_info__ = (1, 33, 0)
 __version__ = '.'.join([str(x) for x in __version_info__])