From dc4b0600d83c0ce6893543e86807faced6f6686e Mon Sep 17 00:00:00 2001 From: Tomas Kopecek Date: May 17 2023 07:55:22 +0000 Subject: Koji 1.33 release notes Related: https://pagure.io/koji/issue/3821 --- diff --git a/docs/source/migrations/migrating_to_1.33.rst b/docs/source/migrations/migrating_to_1.33.rst new file mode 100644 index 0000000..eeaa452 --- /dev/null +++ b/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` diff --git a/docs/source/migrations/migrations.rst b/docs/source/migrations/migrations.rst index 8ccc4cd..7b4ba9c 100644 --- a/docs/source/migrations/migrations.rst +++ b/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 diff --git a/docs/source/release_notes/release_notes.rst b/docs/source/release_notes/release_notes.rst index 92a9946..aeeb9eb 100644 --- a/docs/source/release_notes/release_notes.rst +++ b/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 diff --git a/docs/source/release_notes/release_notes_1.33.rst b/docs/source/release_notes/release_notes_1.33.rst new file mode 100644 index 0000000..2b3ec76 --- /dev/null +++ b/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 `_. +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. diff --git a/koji.spec b/koji.spec index bda4d29..b0be4f0 100644 --- a/koji.spec +++ b/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 - 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 - 1.32.0-1 - PR#3530: use_fast_upload=True as default everywhere - PR#3562: rpmdiff: replace deprecated rpm call diff --git a/koji/_version.py b/koji/_version.py index fa5596d..23c9cf0 100644 --- a/koji/_version.py +++ b/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__])