Koji 1.18.0 Release notes
=========================


Migrating from Koji 1.17
------------------------

For details on migrating see :doc:`migrating_to_1.18`



Security Fixes
--------------



Client Changes
--------------

**Add option for custom cert location**

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

The CLI now has an option for setting a custom SSL certificate, similar to the
options for Kerberos authentication.


**Load client plugins from ~/.koji/plugins**

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


This change allows users to load their own cli plugins from ``~/.koji/plugins``
or from another location by using the ``plugin_paths`` setting.


**Show load/capacity in list-channels**

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

The ``list-channels`` display has been expanded to show overall totals for load
and capacity.


**Allow taginfo cli to use tag IDs**

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

The ``taginfo`` command can now accept a numeric tag id on the command line.


**Add option to show channels in list-hosts**

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

The ``list-hosts`` command will now display channel subscriptions if the
``--show-channels`` option is given.


**Remove merge option from edit-external-repo**

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

This option was mistakenly added to the command and never did anything.
It is gone now.


**Honor mock.package_manager tag setting in mock-config cli**

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

The ``mock-config`` command will now honor this setting just as ``kojid`` does.




Library Changes
---------------

**New multicall interface**

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

This feature implements a new and much better way to use multicall in the Koji
library.
These changes create a new implementation outside of ClientSession.
The old way will still work.

With this new implementation:

* a multicall is tracked as an instance of `MultiCallSession`
* the original session is unaffected
* multiple multicalls can be managed in parallel, if desired
* `MultiCallSession` behaves more or less like a session in multicall mode
* method calls return a `VirtualCall` instance that can later be used to access the result
* `MultiCallSession` can be used as a context manager, ensuring that the calls are executed

Usage examples can be found in the :doc:`Writing Koji Code <writing_koji_code>`
document.




Web UI Changes
--------------

**Retain old search pattern in web ui**

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

The search results page of the web ui now retains a search form with the
current search pre-filled.
This makes it easier for users to refine their searches.


**Display task durations in webui**

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


The ``taskinfo`` page in the web ui now shows task durations in addition to
timestamps.



Builder Changes
---------------

**Rebuild SRPMS before building**

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

For rpm builds from an uploaded srpm, Koji will now rebuild the srpm in the
build environment first.
This ensures that the NVR is correct for the resulting build.

The old behavior can be requested by setting ``rebuild_srpm=False`` in the tag
extra data for the build tag in question.


**User createrepo_c by default**

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


The ``use_createrepo_c`` configuration option for ``kojid`` now defaults to True.


**Use createrepo update option even for first repo run**

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

If there is no older repo for a tag, Koji will now attempt to find
a related repo to use ``createrepo --update`` with.
This will speed up first-time repo generations for tags that
predominantly inherit their content from another build tag.


**Scale task_avail_delay based on bin rank**

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

This is an adjustment to Koji's decentralized scheduling algorithm.
It should result in better utilization of host capacity, particularly when
a channel has hosts that are very heterogeneous in capacity.

The meaning of the ``task_avail_delay`` setting is different now.
Within a channel-arch bin, the hosts with highest capacity will take the task
immediately, while hosts lower down will have a delay proportional to their
rank.
The "rank" here is a float between 0.0 and 1.0 used as a multiplier.
So ``task_avail_delay`` is the maximum time that any host will wait to
take a task.

Hosts with higher available capacity will be more likely to claim a
task, resulting in better utilization of the highest capacity hosts.


**Use RawConfigParser for kojid**

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

The use of percent signs is common in ``kojid.conf`` because of the
``host_principal_format`` setting.
This causes an error in python3 if ``SafeConfigParser`` is used, so we use
``RawConfigParser`` instead.


**Handle bare merge mode**

| PR: https://pagure.io/koji/pull-request/1411
| PR: https://pagure.io/koji/pull-request/1516
| PR: https://pagure.io/koji/pull-request/1502


This feature adds a new merge mode for external repos named ``bare``.
This mode is intended for use with modularity.

Use of this mode requires createrepo_c version 0.14.0 or later on the builders
that handle the createrepo tasks.




System Changes
--------------


**API for reserving NVRs for content generators**

| PR: https://pagure.io/koji/pull-request/1464
| PR: https://pagure.io/koji/pull-request/1597
| PR: https://pagure.io/koji/pull-request/1601
| PR: https://pagure.io/koji/pull-request/1602
| PR: https://pagure.io/koji/pull-request/1606

This feature allows content generators to reserve NVRs earlier in the build
process similar to builds performed by ``kojid``. The NVR is reserved by
calling ``CGInitBuild()`` and finalized by the ``CGImport()`` call.



**Per-tag configuration of rpm macros**

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

This feature allows setting rpm macros via the tag extra field. These macros
will be added to the mock configuration for the buildroot. The system
looks for extra values of the form ``rpm.macro.NAME``.

For example, to set the dist tag for a given tag, you could use a command like:

::

    $ koji edit-tag f30-build -x rpm.macro.dist=MYDISTTAG



**Per-tag configuration for module_hotfixes setting**

| PR: https://pagure.io/koji/pull-request/1524
| PR: https://pagure.io/koji/pull-request/1578

Koji now handles the field ``mock.yum.module_hotfixes`` in the tag extra.
When set, kojid will set ``module_hotfixes=0/1`` in the yum portion of the
mock configuration for a buildroot.


**Allow users to opt out of notifications**

| PR: https://pagure.io/koji/pull-request/1417
| PR: https://pagure.io/koji/pull-request/1580

This feature lets users opt out of notifications that they would otherwise
automatically recieve, such as build and tag notifications for:

- the build owner (the user who submitted the build)
- the package owner within the given tag

These opt-outs are user controlled and can be managed with the new
``block-notification`` and ``unblock-notificiation`` commands.


**Allow hub policy to match version and release**

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


This feature adds new policy tests to match ``version`` and ``release``.
This tests are glob pattern matches.


**Allow hub policy to match build type**

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


Koji added btypes in version 1.11 along with content generators.
Now, all builds have one or more btypes.

This change allows policies to check the btype value using the ``buildtype`` test.



**More granular admin permissions**

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

A number of actions that were previously admin-only are now governed by
separate permissions:

    ``host``
        This permission governs most host management operations, such as
        adding, editing, enabling/disabling, and restarting.

    ``tag``
        This permission governs adding, editing, and deleting tags.

    ``target``
        This permission governs adding, editing, and deleting targets.

Koji administrators may want to consider reducing the number of users with
full ``admin`` permission.


**Option to generate separate source repo**

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

The (non-dist) yum repos that Koji generates for building normally don't
include srpms.
An old option allowed them to be included in some cases, but they were simply
added to each repo.
Newer options have been added that instruct Koji to include them as a separate
src repo.

In the cli, the ``regen-repo`` command now accepts a ``--separate-source``
option that triggers this behavior.

In ``kojira``, the ``separate_source_tags`` option is a list of tag patterns.
Build tags that match any of these patterns will have their repos generated
with a separate src repo.



**Add volume option for dist-repo**

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

Dist repos can now be generated on volumes other than the main one.
Use the ``--volume`` option to the ``dist-repo`` command to do so.

Generally you want the repo to be on the same volume as the rpms it will
contain.
Dist repos hard link (same volume) or copy (different volume) their rpms into
place.
Using the appropriate volume can drastically improve the efficiency, both in
generation time and space consumption.


**Minor gc optimizations**

| PR: https://pagure.io/koji/pull-request/1337
| PR: https://pagure.io/koji/pull-request/1442
| PR: https://pagure.io/koji/pull-request/1437

This change speeds up portions of garbage collection by making the
``build_references`` check lazy by default.



**Rollback errors in multiCall**

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

If one of the calls in a multicall raises an error, then the transaction will
be rolled back to the start of that call before Koji proceeds to the next call.
This matches the behavior of normal calls more closely.

Multicalls are still handled within single database transaction.



**Support tilde in search**

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


The tilde character is no longer prohibited in search terms.



**Remove 'keepalive' option**

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

The ``keepalive`` setting is no longer used anywhere in koji.
It has been removed.