#2685 Release notes 1.24
Merged 3 years ago by tkopecek. Opened 3 years ago by tkopecek.
tkopecek/koji issue2684  into  master

@@ -0,0 +1,26 @@ 

+ Migrating to Koji 1.24

+ ======================

+ 

+ You should consider the following changes when migrating to 1.24:

+ 

+ DB Updates

+ ----------

+ 

+ This release includes one minor schema change.

+ 

+ As we now can have architectures defined for individual external repos, we need

+ to reflect it in db. (see `PR#2564

+ <https://pagure.io/koji/pull-request/2564>`_).

+ 

+ As in previous releases, we provide a migration script that updates the database.

+ 

+ ::

+ 

+     # psql koji koji < /usr/share/doc/koji/docs/schema-upgrade-1.23-1.24.sql

+ 

+ 

+ Other changes

+ -------------

+ 

+ There are numerous other changes in 1.24 that should not have a direct impact on migration. For

+ details see: :doc:`../release_notes/release_notes_1.24`

@@ -5,6 +5,7 @@ 

  .. toctree::

      :maxdepth: 1

  

+     migrating_to_1.24

      migrating_to_1.23

      migrating_to_1.22

      migrating_to_1.21

@@ -5,6 +5,7 @@ 

  .. toctree::

      :maxdepth: 1

  

+     release_notes_1.24

      release_notes_1.23.1

      release_notes_1.23

      release_notes_1.22.1

@@ -0,0 +1,284 @@ 

+ Koji 1.24.0 Release notes

+ =========================

+ 

+ All changes can be found at `pagure <https://pagure.io/koji/roadmap/1.24/>`_.

+ Most important changes are listed here.

+ 

+ 

+ Migrating from Koji 1.23/1.23.1

+ -------------------------------

+ 

+ For details on migrating see :doc:`../migrations/migrating_to_1.24`

+ 

+ 

+ Security Fixes

+ --------------

+ 

+ None

+ 

+ 

+ Client Changes

+ --------------

+ 

+ **support download-build \\-\\-type=remote-sources**

+ 

+ | PR: https://pagure.io/koji/pull-request/2608

+ 

+ This wasn't possible via CLI before. The command has been extended for

+ downloading this additional artifact type.

+ 

+ **hide import-sig \\-\\-write option**

+ 

+ | PR: https://pagure.io/koji/pull-request/2654

+ 

+ This option is not used anymore. We're hiding it from the user.

+ 

+ **return error if add/remove-tag-inheritance can't be applied**

+ 

+ Previously only a warning was printed but return code implied no problems. Now

+ it is returning an error-code so it has better problem visibility in scripts.

+ 

+ | PR: https://pagure.io/koji/pull-request/2605

+ 

+ **raise NotImplementedError with btype name**

+ 

+ | PR: https://pagure.io/koji/pull-request/2610

+ 

+ More verbose error when downloading unsupported archives.

+ 

+ **list-tasks \\-\\-after/\\-\\-before/\\-\\-all**

+ 

+ | PR: https://pagure.io/koji/pull-request/2566

+ 

+ New options for list-tasks. Formerly only running tasks could be

+ displayed. Now closed tasks can also be displayed with ``--all`` and

+ ``--after``/``--before`` options. Use it wisely -- querying all tasks

+ can hurt the hub's performance.

+ 

+ **list-hosts can display description/comment**

+ 

+ | PR: https://pagure.io/koji/pull-request/2562

+ 

+ The new ``--comment`` and ``--description`` options can be used to display

+ additional info in host list.

+ 

+ **allow removal of unused external repo even with \\-\\-alltags**

+ 

+ | PR: https://pagure.io/koji/pull-request/2560

+ 

+ Fixed confusing behaviour for ``koji remove-external-repo --alltags``

+ when the given external repo is not associated with any tags.

+ 

+ **history query by extra key**

+ 

+ | PR: https://pagure.io/koji/pull-request/2589

+ 

+ The additional filter option ``--xkey`` for list-history limits the results to

+ history records that affected the given extra key for some tag.

+ 

+ 

+ Library Changes

+ ---------------

+ **better print with debug_xmlrpc**

+ 

+ | PR: https://pagure.io/koji/pull-request/2598

+ 

+ This fixes an unfortunate display bug introduced by the python3 migration.

+ The ``--debug-xmlrpc`` feature shows details of the xmlrpc calls to the hub,

+ but most of the data was shown base64-encoded, regardless of whether it was

+ printable. Now the client will only result to base64 when it is necessary.

+ 

+ API Changes

+ -----------

+ **readFullInheritance stops/jumps deprecation**

+ 

+ | PR: https://pagure.io/koji/pull-request/2655

+ 

+ Deprecation of unused options.

+ 

+ **fix nightly getNextRelease format**

+ 

+ | PR: https://pagure.io/koji/pull-request/2630

+ 

+ Additional format allowed for ``getNextRelease`` - ``{str}.{str}.{id}``.

+ 

+ **[listBuilds] add nvr glob pattern support**

+ 

+ | PR: https://pagure.io/koji/pull-request/2555

+ 

+ The ``list-builds`` command now accepts a ``--pattern`` option that

+ filters the NVRs using the given glob pattern.

+ 

+ The underlying ``listBuilds`` api call on the hub now accepts a ``pattern``

+ argument that applies the filtration.

+ 

+ Builder Changes

+ ---------------

+ **Add option to use repos from kickstart for livemedia builds**

+ 

+ | PR: https://pagure.io/koji/pull-request/2571

+ 

+ The new ``--ksrepo`` option tells the builder to not override the repos

+ given in the kickstart files for livemedia builds.

+ 

+ **Add nomacboot option for spin-livemedia**

+ 

+ | PR: https://pagure.io/koji/pull-request/2540

+ 

+ The new ``--nomacboot`` option is passed through to livemedia-creator.

+ 

+ System Changes

+ --------------

+ 

+ **make policy test thread safe**

+ 

+ | PR: https://pagure.io/koji/pull-request/2651

+ 

+ 

+ **spec: pythonic provides**

+ 

+ | PR: https://pagure.io/koji/pull-request/2667

+ 

+ Spec file now provides python3dist(koji) provides.

+ 

+ **requires python[23]-requests-gssapi for rhel[78]**

+ 

+ | PR: https://pagure.io/koji/pull-request/2664

+ 

+ **explicit encoding for text file operations**

+ 

+ | PR: https://pagure.io/koji/pull-request/2647

+ 

+ In some mod_wsgi configurations, the hub can raise an error because of non-default

+ encoding when opening text files. The code has been modified to force UTF-8

+ everywhere.

+ 

+ **Lower default multicall batch values**

+ 

+ | PR: https://pagure.io/koji/pull-request/2644

+ 

+ In high-load environments long-running transactions can lead even to db

+ deadlocks. We suggest using lower batches for multicalls and have lowered the

+ default batch sizes we currently have in the code.

+ 

+ If individual multicalls are running longer than a minute or two, we recommend

+ splitting them into smaller batches.

+ 

+ **require gssapi-requests 1.22**

+ 

+ | PR: https://pagure.io/koji/pull-request/2584

+ 

+ Older versions of library have a bug which breaks the gsaapi login for builders.

+ Upgrading to this version solves the problem.

+ 

+ **limit CGImport to allow only one CG per import**

+ 

+ | PR: https://pagure.io/koji/pull-request/2574

+ 

+ We've found that nobody is using the option to include multiple CGs output in

+ one CG import. It makes things easier if we limit it directly to one CG per

+ import. In such case we know which CG generated which build and policies can

+ work with this value, etc.

+ 

+ **external repos can have specified arch list**

+ 

+ | PR: https://pagure.io/koji/pull-request/2564

+ | PR: https://pagure.io/koji/pull-request/2682

+ 

+ Some external repositories can have split architectures (e.g. primary

+ architectures in one repo and secondary in the second). On the other hand tags

+ expect that external repo has all the architectures as the tag has.

+ We've added a new option to tell Koji that an external repo only contains a

+ subset of tag's architectures.

+ Multiple external repos with different architectures can then be attached to the

+ tag. This behaviour can be tuned by ``--arches`` option in ``add-external-repo``

+ and ``edit-external-repo`` commands.

+ 

+ **remove deprecated \\-\\-ca option**

+ 

+ | PR: https://pagure.io/koji/pull-request/2529

+ 

+ Formerly deprecated ``--ca`` option is finally removed for all executables.

+ 

+ Web

+ ---

+ 

+ **return correct content-length**

+ 

+ | PR: https://pagure.io/koji/pull-request/2639

+ 

+ Regressions for py3 code - ``Content-Length`` header was erroneously computed so

+ some browsers fetched incomplete page. It is not visible in most cases (as final

+ html tags are corrupted and added by the browser) but in some cases it could

+ led to broken web page.

+ 

+ **order methods by name in select box**

+ 

+ | PR: https://pagure.io/koji/pull-request/2559

+ 

+ With growing number of task types it makes more sense to order them

+ alphabetically these days compared to previous *importance* ordering.

+ 

+ **more accessible task colors/icons**

+ 

+ | PR: https://pagure.io/koji/pull-request/2653

+ 

+ For higher accessibility we've slightly changed the colors corresponding to task and

+ build states. We've also added more informative icons to the taskinfo page.

+ 

+ **display VCS/DistURL rpm tags**

+ 

+ | PR: https://pagure.io/koji/pull-request/2683

+ 

+ The buildinfo and rpminfo pages now display also VCS and DistURL tags if they are

+ present in rpm (srpm for buildinfo page).

+ 

+ Plugins

+ -------

+ **handle plugins and generator results in count and countAndFilterResults**

+ 

+ | PR: https://pagure.io/koji/pull-request/2633

+ 

+ These functions couldn't be used for methods provided by plugins or

+ methods which returned generators. This is now fixed.

+ 

+ **plugin hooks for repo modification**

+ 

+ | PR: https://pagure.io/koji/pull-request/2637

+ 

+ New ``postCreateRepo`` and ``postCreateDistRepo`` plugin hooks were introduced

+ on builder. They can be used to modify repodata with intent to allow sign the

+ repodata by plugins but it can be used for additional repodata modification.

+ 

+ Utilities

+ ---------

+ 

+ Kojira

+ ......

+ 

+ **move checkTasks near its usage**

+ 

+ | PR: https://pagure.io/koji/pull-request/2140

+ 

+ We've moved checking running ``newRepo`` tasks to different place. Now, the number

+ of running tasks should be closer to set capacity as kojira will check

+ finished tasks just before spawning new ones.

+ 

+ Documentation

+ -------------

+ **mention the final destination for new dist-repos**

+ 

+ | PR: https://pagure.io/koji/pull-request/2621

+ 

+ **link to tag2distrepo hub plugin**

+ 

+ | PR: https://pagure.io/koji/pull-request/2617

+ 

+ **types param for content generators**

+ 

+ | PR: https://pagure.io/koji/pull-request/2609

+ 

+ **remove global SSLVerifyClient option**

+ 

+ | PR: https://pagure.io/koji/pull-request/2627

+ 

file modified
+42 -1
@@ -78,7 +78,7 @@ 

  %define release %{baserelease}

  %endif

  Name: koji

- Version: 1.23.1

+ Version: 1.24.0

  Release: %{release}%{?dist}

  License: LGPLv2 and GPLv2+

  # the included arch lib from yum's rpmUtils is GPLv2+
@@ -590,6 +590,47 @@ 

  %systemd_postun kojira.service

  

  %changelog

+ * Thu Feb  4 2021 Tomas Kopecek <tkopecek at redhat.com> - 1.24.0-1

+ - PR#2637: plugin hooks for repo modification

+ - PR#2680: fix the mode of tarfile.open

+ - PR#2608: cli: support download-build --type=remote-sources

+ - PR#2674: cli: fix tests

+ - PR#2667: spec: pythonic provides

+ - PR#2671: fix typo

+ - PR#2651: make policy test thread safe

+ - PR#2664: requires python[23]-requests-gssapi for rhel[78]

+ - PR#2655: readFullInheritance stops/jumps deprecation

+ - PR#2589: history query by key

+ - PR#2633: handle plugins and generator results in count and countAndFilterResults

+ - PR#2649: kojid: backward compatible hub call

+ - PR#2647: explicit encoding for text file operations

+ - PR#2661: web: add comment explaining null start_time values

+ - PR#2639: web: return correct content-length

+ - PR#2654: cli: hide import-sig --write option

+ - PR#2644: Lower default multicall batch values

+ - PR#2584: require gssapi-requests 1.22

+ - PR#2576: db: add debian package archivetype

+ - PR#2627: hub: remove global SSLVerifyClient option

+ - PR#2605: cli: return error if add/remove-tag-inheritance can't be applied

+ - PR#2630: fix nightly getNextReelase format

+ - PR#2610: cli: raise NotImplementedError with btype name

+ - PR#2598: lib: better print with debug_xmlrpc

+ - PR#2621: docs: mention the final destination for new dist-repos

+ - PR#2617: docs: link to tag2distrepo hub plugin

+ - PR#2609: hub: doc listArchive types param for content generators

+ - PR#2595: unify sql case

+ - PR#2566: cli: list-task --after/--before/--all

+ - PR#2574: hub: limit CGImport to allow only one CG per import

+ - PR#2564: external repos can have specified arch list

+ - PR#2562: cli: list-hosts can display description/comment

+ - PR#2529: remove deprecated --ca option

+ - PR#2555: hub: [listBuilds] add nvr glob pattern support

+ - PR#2560: cli: allow removal of unused external repo even with --alltags

+ - PR#2571: Add option to use repos from kickstart for livemedia builds

+ - PR#2559: web: order methods by name in select box

+ - PR#2540: Add nomacboot option for spin-livemedia

+ - PR#2561: hub: fix tests

+ 

  * Mon Jan  4 2021 Tomas Kopecek <tkopecek at redhat.com> - 1.23.1-1

  - PR#2603: hub: fix py2-like 'stop' usage in getFullInheritance

  - PR#2593: docs: assign multicall to "m" in code example

file modified
+1 -1
@@ -1,2 +1,2 @@ 

- __version_info__ = (1, 23, 1)

+ __version_info__ = (1, 24, 0)

  __version__ = '.'.join([str(x) for x in __version_info__])

rebased onto 74267b3b5521b7bd3eede49d82a7a22e758a254f

3 years ago

rebased onto cf8b3b61a6da6953993f3cb4a286b5caa16f3b3d

3 years ago

rebased onto 88d528cac9dfbfbf86817ec469722a943e17b000

3 years ago

pretty please pagure-ci rebuild

3 years ago

rebased onto c8b1ba8

3 years ago

1 new commit added

  • relnotes cleanup
3 years ago

Commit a7b98c3 fixes this pull-request

Pull-Request has been merged by tkopecek

3 years ago