From Fedora Project Wiki

This page is deprecated
All Fedora Release Engineering Documentation has moved here with source hosted along side the code in the releng pagure repository

Description

Bigger Features can take a while to stabilise and land or need a large number of packages to be built against each other, this is easiest served by having a separate build tag for the development work. This SOP will describe the steps necessary to prepare the new build target.

Action

Adding a side build target is fairly straightforward, but comes with a cost of extra newRepo tasks in koji.

Koji

In koji a tag needs to be made, it needs to inherit from the -build tag of the base your wanting to develop against, this is to ensure that group info makes it into your tag so you can build successfully. As we will be building against this tag we need to give it the needed arches also.

The add-tag, add-tag-inheritance, edit-tag, and add-target commands are used.

$ koji add-tag --help
Usage: koji add-tag [options]  name
(Specify the --help global option for a list of other help options)

Options:
-h, --help       show this help message and exit
--parent=PARENT  Specify parent
--arches=ARCHES  Specify arches

$ koji add-target --help
Usage: koji add-target name build-tag <dest-tag>
(Specify the --help global option for a list of other help options)

Options:
-h, --help  show this help message and exit

For example if we wanted to create the EPEL tags to build XFCE , we would do the following:

koji add-tag epel6-xfce48 --parent=dist-6E-epel-build --arches="i686,x86_64,ppc64"
koji add-target epel6-xfce48 epel6-xfce48 

A Fedora example would be

koji add-tag f23-gnutls --parent=f23-build --arches="armv7hl,i686,x86_64"
koji add-target f23-gnutls f23-gnutls 

Verification

check in koji that a newRepo task is created for your new tag and has the appropriate arches

Cleanup

When the builds are completed to remove the target and merge builds across

koji remove-target epel6-xfce48

to merge builds across edit mass-tag.py in the releng git repo and run it.

Tags are never removed.

Consider Before Running

  • Is the amount of work to be done worth the cost of newRepo tasks.
  • If there is only a small number of packages overrides may be better.
  • Is there a mass-rebuild going on? no side tags are allowed while a mass rebuild is underway