Koji 1.25.0 Release notes

All changes can be found in the roadmap. Most important changes are listed here.

Migrating from Koji 1.24/1.24.1

For details on migrating see Migrating to Koji 1.25

Security Fixes


Client Changes

More verbose error/warning messages

We’ve revised many calls which previously returned empty results to raise more meaningful errors. For example, koji list-untagged package_x previously did not distinguish between the case where package_x had no untagged builds and the case where package_x did not exist. Also, all warning and error messages were unified in their wording.

Show connection exception for anonymous calls

Calls which don’t need authentication were not properly propagating connection-related exceptions with --debug.

list-api option for one method

Now you don’t need to scroll through list-api output if you want a single method signature. The koji list-api listBuilds command will show just one.

Add wait/nowait to all calls

Some commands had --wait and/or --nowait options. We’ve made it consistent, so all eligible commands now contain both variants. These options override waiting behavior for the command.

If neither option is specified, the default depends on the runtime context. If the client is running on a TTY, then it defaults to waiting. If it is running in the background, then it defaults to not waiting.

This is not new behaviour, just adding explicit options in cases where they were not present.

Use multicall for cancel, list-hosts and write-signed-rpm commands

These commands are now much faster when acting on multiple items.

Using ‘call’ command without authentication

The call command authenticates by default, which is not always desired. This authentication can be disabled with the the global --noauth option. The help text now clarifies this.

Support modules and other btypes in download-build

The download-build command now downloads all regular archives. Previously it was limited to a subset of file types.

Library Changes

Better failed authentication/connections

Connection errors now provide a bit more information for debugging. Some errors were masked by more generic ones. We’re now trying to display more information about these, and to help with debugging krbV/GSSAPI errors. We have added a documentation page for common GSSAPI errors, which the CLI now refers to.

More portable BadStatusLine checking

Python 3 versions had some problems detecting expired keepalive connections. We’ve made the code a bit more portable so you shouldn’t see these errors now.

Missing default values in read_config

Some default values were missing in the config parsing which could have led to mysterious behaviour. The configuration values in question were related to retry behavior when making calls to the hub.

Use parse_task_params for taskLabel

The taskLabel function (used in various places to generate a short label for a given task) has been updated to use the newer parse_task_params function instead of parsing the parameters itself. As a result, the function is simpler and more accurate.

The parse_task_params function is currently the preferred way to interpret task parameters. We recommend that developers use it rather than ad-hoc code.

API Changes

Fail early on wrong info in create*Build methods

The createWinBuild, createImageBuild, and createMavenBuild hub calls will now raise an exception when some data in buildinfo are missing, and their exception text should be clearer than before.

getVolume with strict option

This new option brings getVolume in line with other similar calls. When the requested volume does not exist, the call will either return None (when strict=False, the default) or raise an exception (when strict=True).

getLastHostUpdate ts option

Historically we’ve passed around dates as text strings. Almost everywhere we’re now also sending GMT timestamps to better handle timezone problems. This new option in the getLastHostUpdate call allows you to get a timestamp instead of a string value.

Be tolerant with duplicate parents in _writeInheritanceData

Regression fix - call will now not raise an exception if there are duplicated parents in inheritance chain.

with_owners options for readPackageList and listPackages

Performance improvement. Most of the calls to these functions don’t need information about the package owner. Dropping this data simplifies the underlying query to a faster one. If you’re using this call in your automation give it a chance to lower your database load.

System Changes

Task priority policy

There is a new priority policy which can be used to alter task priorities based on data about task/build. See Defining Hub Policies for details.

Python egginfo

After years of struggling with pip/setuptools/rpm packaging we should finally have something compatible. So, now egginfo, etc. should be properly installed and usable in virtualenvs.

Task ID for repos

When debugging buildroot content issues it is often important to find out which repo was used and when it was created, investigate createrepo and mergerepo logs, etc. It was not easy to find the task that created a given repo. This information is now tracked in the database, and reported in the web and CLI interfaces. It is also recorded in the repo.json file for the repo.

Add squashfs-only and compress-arg options to livemedia

Livemedia tasks can now use these options for passing to ImageFactory.


Show VCS and DistURL tags as links when appropriate

Previously these values were shown as plain text in the web interface. Now they should appears as links.

Don’t use count(*) on first tasks page

The tasks list page can be quite slow in many cases. The primary cause of this is pagination and the underlying count(*) query. As PostgreSQL is very slow for this type of query we’ve removed the page count for the first page which is loaded most often. Subsequent pages will continue to show the count (and therefore also the performance penalty in some situations).

Additional info on API page

We’ve added some simple example client code to the API page, to help users get started without having to dig through the rest of the documentation.


Configurable sidetags suffixes

The sidetag plugin now allows defining a set of allowed suffixes which can be used when creating the sidetag. You can distinguish between different types (private, gating, …)

Protonmsg: fixes for persistent queue

The persistent message queue option (see Proton messaging) was broken. Now it should work correctly.



Faster startup

Multicall is used to prefetch tag data from hub. It significantly improves startup time for larger installations.

Check repo.json before deleting

Previously kojira refused to delete repositories if the path did not match the name of the tag the repo was based on. This kept kojira from cleaning up repos after a build tag was renamed. Now kojira also consults the repo.json which records the name of the tag at the time the repo was created.

Tolerate floats in metadata timestamps

External repositories sometimes can use float timestamp. We now correctly parse that.

Fix fork-related issues

Forking while deleting is causing some issues (mostly with loggign module) especially with the latest python. These can result in kojira not deleting repos at all.

Garbage Collector

Allow specifying all CLI options in config

Every option that can be specified on the command line can now be also put into the configuration file.

Implement hastag policy for koji-gc

The gc policy now offers a hastag test for builds, similar to the test offered by hub policies.

This can be used in numerous ways. One example (a protected tag that protects builds from pruning) is described in the original request.