From Fedora Project Wiki

在 Fedora 里使用 Koji

koji 编译系统是专为 Fedora 7 及其以后版本使用的编译打包系统。打包者使用 Koji 的客户端去请求软件包编译和从编译系统得到相关的信息。

原文地址: Using the Koji build system

安装 Koji

安装 Koji 的命令行模式

你可以用一条命令去安装你使用 Koji(当然你还要成为一名 Fedora 的贡献者。)

yum install fedora-packager

fedora-packager 提供了一系列脚本帮助你管理和安装你的koji环境。额外地,它也包括了 Koji CLI 的依赖,当你安装 fedora-packager 的时候就会被自动安装。该命令叫 koji,包括在 koji 的主包里。使用 Kerberos 作为默认的协议认证koji客户端和中心服务器。当然 SSL 协议和用户名/密码的办法是可行的。你需要有一个有效的认证去获得 Koji 众多特性。否则,在没有认证的情况下只有许多只读的命令工作。

初始化 Fedora Setup

为了使用 Koji 服务器,软件包维护者需要运行:

/usr/bin/fedora-packager-setup

如果系统里的用户需要使用 Koji 去构建 Fedora 的软件包,则必须需要运行一次该命令。每一个用户都必须拥有他们的证书用于认证他们的身份。

Idea.png
Plague 用户注意
对于已经存在的 Plagu e用户(被 koji 替代的旧的编译系统),fedora-packager-setup 会使用已有的这证书。如果你早前没有用过 plague,则需要得到用户证书和告知你从哪里得到这些用户证书。

Fedora 证书

Koji 使用以下三份证书:

~/.fedora.cert(给与Fedora的软件包维护者)
此份证书是在 FAS此页面 生成的。当你成为软件包维护者,它就已经自动生成的。你需要重新生成它当过期的时候。
~/.fedora-upload-ca.cert(此证书在验证的时候用于导入使用者的密钥。)
你可以在 此处 下载或者利用 fedora-packager-setup 获取它。
~/.fedora-server-ca.cert(此证书在验证时用于导入编译服务器的密钥。)
你可以在 此处 下载或者利用 fedora-packager-setup 获取它。


配置 Koji

Koji 本地客户端的全局配置文件在 /etc/koji.conf。你不需要为编译 Fedora 软件包去更改配置文件,只要你运行了 fedora-packager-setup,它就会自动在 ~/koji/ 目录建立一个系列配置文件。这些配置文件允许你使用首要架构编译系统和次级架构编译系统。

Web 界面

用于浏览 koji 数据的首页是一个 web 应用程序。现已可以在 http://koji.fedoraproject.org/koji/ 上使用了。大多数界面都是只读的,但是如果你登入了koji的网页界面并且有足够的权限,你可以在网页里实现以下动作,例如:

  • 取消一个编译任务
  • 重新提交一个失败的编译任务
  • 安装一个提示

拥有管理权限的用户将获得额外的动作,例如

  • 新建/编辑/删除标记
  • 新建/编辑/删除目标
  • 启动/关闭编译主机

Web 界面使用了 SSL 验证,为了登录你将需要一个真实的 SSL 证书,并且你的浏览器需要被配置成信任该 SSL 证书。当运行 fedora-packager-setup.sh 将会出现如何完成以上步骤的指令。

提示

你可以在 koji 安装一个提示请求,可以确保你不会错过你关注的一个软件包当它被编译的时候。登录入 koji 并移动到页面的按钮,你应该会在那里发现 “添加一个提示” 的连接和你已配置提示的列表。

指向一个目标编译软件包

对于简单的编译请求,在 Makefile.common 里有一个别名去请求 koji 编译。这仅仅需要 Fedora 的打包者进入适当的软件包的发行版分支(从 CVS 服务器提取出),然后运行:

make build

这将会为分支启动一个编译请求。十分容易!

记录下依赖于被标记的所有要完成的编译请求分支(首先运行 make tag

koji 也可以指向特定的标记,如下:

make build TARGET='<target>'

例如,如果想在 rawhide 上编译一个软件包,该软件包依赖于由 rel-eng 创建为更新 API 的一个特定标记的软件包,例如 dist-f11-python,你可以运行如下命令:

make build TARGET='dist-f11-python'

Scratch Builds

你可以使用以下命令进行 scratch build :

make scratch-build

如果你想为特定的架构进行 scratch build,你可以输入:

make scratch-build-<archs>

<arch>可以是用逗号分隔开的架构清单。

最后,可以把一个特定的 koji 标记加入到 scratch-build 命令里面。

make scratch-build TARGET='<target>'

Chained builds

Warning.png
chain-builds仅仅在devel/ (又称为rawhide)上工作。 为了更新一个已发行的版本而 chain-build,请举行一次 发行工程师团队的投票,请求把早前已编译的软件加入到可能的编译链中。对于 Fedora 打包者,则选择 ‘koji ’套件。对于 EPEL 打包者,则选择 ‘epel’ 套件。

有时你想在启动下一个任务之前取保前一个编译成功。例如,当你想重编译一个倚靠已编译好的依赖关系的软件包。那么你需要使用一次 chain build:

make chain-build CHAIN='libwidget libgizmo'

现有的软件包将会被加入到 CHAIN 清单的后面。“:”被应用于 CHAIN 的范围以定义软件包所属的组。在下一组编译开始前,软件包无论在任何一个组都会被并行编译,且所有软件包都必须编译成功和移送到软件包仓库。例如:

make chain-build CHAIN='libwidget libaselib : libgizmo :'

此举将会同时编译 libwidget 和 libaselib,随后是 libgizmo,然后到现有目录内的软件包。如果没有定义组,那么软件包将会按照顺序编译。如果其中一个编译失败,跟随的编译就会被取消但已经编译好的软件包将会被推送的软件仓库。

编译失败

如果你的软件包编译失败,你将会看到类似内容。

420066 buildArch kernel-2.6.18-1.2739.10.9.el5.jjf.215394.2.src.rpm,
ia64): open (build-1.example.com) -> FAILED: BuildrootError:
error building package (arch ia64), mock exited with status 10

你可以在日志文件里找出编译失败的原因。如果有一个 build.log 就打开它。或者查看 init.log

日志文件可透过 koji 的 web 界面在失败人物的页面里找到。或者可以透过 koji 的客户端来使用 watch-logs 命令查看日至。更详细的内容可以透过帮助命令查看到。

Koji 的高级应用

我们已经尝试让 Koji 的文档无论在哪里都自动运行。该命令行将会显示出一系列有效的命令和每一个命令都支持 --help 参数,例如:

$ koji help

Koji commands are:
build                Build a package from source//从源代码构建一个软件包
cancel-task          Cancel a task//取消一个任务
help                 List available commands//列出可用的命令
latest-build         Print the latest rpms for a tag//输出一个标记的最新rpms
latest-pkg           Print the latest builds for a tag//输入一个标记的最新builds
[...] 
$ koji build --help

usage: koji build [options]  tag URL
(Specify the --help global option for a list of other help options)

options:
-h, --help            show this help message and exit //显示帮助信息和退出
--skip-tag            Do not attempt to tag package //不标记一个软件包
--scratch             Perform a scratch buil d//运行一个 scratch buil d任务
--nowait              Don't wait on build //不等待 build
[...] 

使用koji生成一份mock配置文件并复制一个编译链

koji可以被用作复制一个编译链用于本地调试。

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

Options:
  -h, --help            show this help message and exit //显示帮助信息和退出
  --arch=ARCH           Specify the arch //指定架构
  --tag=TAG             Create a mock config for a tag //为一个标记创建一份 mock 设定
  --task=TASK           Duplicate the mock config of a previous task //复制前一个任务的 mock 设定
  --buildroot=BUILDROOT
                        Duplicate the mock config for the specified buildroot
                        id //复制指定 buildroot 的mock设定
  --mockdir=DIR         Specify mockdir //指定 mock 的目录
  --topdir=DIR          Specify topdir //指定 top 目录
  --topurl=URL          url under which Koji files are accessible //设定 Koji 文件可以到达的地址
  --distribution=DISTRIBUTION
                        Change the distribution macro //改变发行版的宏
  -o FILE               Output to a file //输出到一个文件

例如为得到最新 dist-f12-build 的编译链可以运行:

koji mock-config --tag dist-f12-build --arch=x86_64 --topurl=http://kojipkgs.fedoraproject.org/ dist-f12

你将要输入 --topurl=http://koji.fedoraproject.org/ 到对应的 mock-config 命令从 fedora koji 得到一份正在运行的 mock-config。

使用 koji 控制任务

列出任务:

koji list-tasks

仅列出你请求的任务:

koji list-tasks --mine

重新排列一个已经进行的任务:设置为高亮:koji resubmit [options] taskID:

koji resubmit 3

使用命令行构建一个软件包

你可以直接使用 koji 的命令行工具取代 make target。 构建一个软件包的命令是:

$ koji build <build target> <cvs URL>

例如:

Warning.png
用你想编译的标记去替换 dist-f8,例如 dist-f9 或者 dist-f10
$ koji build dist-f8 'cvs://cvs.example.com/cvs/dist?rpms/kernel/FC-7#kernel-2_6_20-1_2925_fc7'

koji build 命令会在Koji里创建一个编译任务。默认情况下该工具会等待和输出进程更新直到编译完成,你可以增加 --nowait 参数去跳过这些过程。也可以在 make 命令下使用以下环境变量。

KOJI_FLAGS="--nowait" make build
Scratch builds

你也可以 scratch build 一个源代码 rpm 包:

koji build --scratch dist-f8 mycoolpackage-3.2-1.src.rpm

警告:如果你的 .spec 文件使用.不同于 %fedora,%fc9 类似的数值,那么 Scratch build 将不会工作。打包器会像这些数值去设定 Macro 值,而不是 koji。所以 %fedora 的值将是根据源代码 RPM包 里创建的数值来设定,而不是根据它在哪个打包器上编译来设定的。非 scratched build 根据重新打包的源代码 RPM 包设定。

编译选项

在编译命令里有一系列选项。以下是一些对这些选项的解释:

--skip-tag
Normally the package is tagged after the build completes.
This option causes the tagging step to be skipped.
The package will be in the system, but untagged
(you can later tag it with the tag-pkg command)
//通常当软件编译完成就会标记该软件包。这个选项可以跳过标记这个步骤。
该软件包将会在系统里面,但不会被标记
(你稍候可以使用 tag-pkg 命令重新标记软件包)

--scratch
This makes the build into a scratch build.
The build will not be imported into the db, it will just be built.
The rpms will land under <topdir>/scratch.
Scratch builds are not tracked and can never be tagged, but can be convenient for testing.
Scratch builds are typically removed from the filesystem after one week.
//该命令会让 build 进入一个 scratch build。
这个 build 将不会汇入数据库,这紧紧是一个build。
rpms 会放置在 <topdir>/scratch。
Scratch builds 不会加入到 track 和从不会被标记, 但可以很方便地用于测试。
Scratch builds 通常会在一周之后从文件系统上移除。

--nowait
As stated above, this prevents the cli from waiting on the build task.
//正如上述, 这个参数会停止命令行等待编译任务完成。

--arch-override
This option allows you to override the base set of arches to build for.
This option is really only for testing during the beta period, but it may be retained for scratch builds in the future.
//这个参数允许你凌驾于众架构的仓库去编译和打包/
这个参数只能在 beta 的时候用于测试, 但是可能会在未来的 sctratch builds中保留。

Koji 的标记和软件包的组织

术语

在koji,有时有些东西必须要区分的,例如一个普通的软件包,一个特定编译的软件包,一次编译产生的数个rpm文件。当需要精确的时候,这些条款必须按照以下内容解释:

  • Package:源代码包的名字,一般用于普通软件包和非特定编译的build或者主包。例如:kernel,glibc等
  • Build:软件包的特定编译。这里指的是完整编译:所有架构和主包。例如:kernel-2.6.9-34.EL, glibc-2.3.4-2.19
  • RPM:一个特定的rpm。一个编译任务里的一个特定架构和主包。例如:kernel-2.6.9-34.EL.x86_64, kernel-devel-2.6.9-34.EL.s390, glibc-2.3.4-2.19.i686, glibc-common-2.3.4-2.19.ia64

标记与目标

Koji 使用标记来管理软件包。在 Koji 里一个标记大概是一个软件包的集合:

  • 标记支持继承
  • 每一个标记都有它们拥有的有效的软件包清单(可继承)
  • 每一个标记可以设置软件包的拥有权(可继承)
  • 当你请求一个面向特定目标的编译,同时也请求了一个特定的标记

一个编译目标指向了一个软件包应该在哪里编译和如何在编译后被标记。这允许了目标名称可以在跨版本的时候修改临时的标记。

用于标记 Koji 的命令

目标

你可以使用以下命令列出一个完整编译目标清单:

$ koji list-targets

你可以添加 --name 参数查看单独的一个单独的目标:

$ koji list-targets --name dist-fc7

Name                           Buildroot                      Destination
---------------------------------------------------------------------------------------------
dist-fc7                       dist-fc7-build                 dist-fc7

以上内容是告知你一个属于 dist-fc7 目标的编译任务将使用一条带有标记为 dist-fc7-build 的软件包组成的编译链,并且在编译完成后生成的软件包也会被标记为 dist-fc7。

留意:你可能不希望在 dist-rawhide 上编译。如果 Fedora N 是已发布的最新一个版本,那么你可以选择编译到下一个版本,标记选择为 dist-f{N+1}。

标记

你可以使用以下命令得到标记的列表:

$ koji list-tags
软件包

就如上面所提及的,每一个标记都拥有属于它的在此标记下的软件包的清单。为了查看属于一个标记的清单,使用 list-pkgs 命令:

$ koji list-pkgs --tag dist-fc7

Package                 Tag                     Extra Arches     Owner
----------------------- ----------------------- ---------------- ----------------
ElectricFence           dist-fc6                                 pmachata
GConf2                  dist-fc6                                 rstrode
lucene                  dist-fc6                                 dbhole
lvm2                    dist-fc6                                 lvm-team
ImageMagick             dist-fc6                                 nmurray
m17n-db                 dist-fc6                                 majain
m17n-lib                dist-fc6                                 majain
MAKEDEV                 dist-fc6                                 clumens
[...] 

第一列为软件包的名称,第二列告知软件包继承自哪一个标记,第三列则告知软件包的所有者。

最新的编译任务

为了查看某个标记的最新builds,使用 latest-pkg 命令:

$ koji latest-pkg --all dist-fc7

Build                                     Tag                   Built by
----------------------------------------  --------------------  ----------------
ConsoleKit-0.1.0-5.fc7                    dist-fc7              davidz
ElectricFence-2.2.2-20.2.2                dist-fc6              jkeating
GConf2-2.16.0-6.fc7                       dist-fc7              mclasen
ImageMagick-6.2.8.0-3.fc6.1               dist-fc6-updates      nmurray
MAKEDEV-3.23-1.2                          dist-fc6              nalin
MySQL-python-1.2.1_p2-2                   dist-fc7              katzj
NetworkManager-0.6.5-0.3.cvs20061025.fc7  dist-fc7              caillon
ORBit2-2.14.6-1.fc7                       dist-fc7              mclasen

输出不仅仅会告知你最新的编译,而且会告知你继承自哪一个标记和谁在编译。