From Fedora Project Wiki

< Zh

(移除旧的证书认证,改为新的 krb5 认证机制)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
= 在 Fedora 里使用 Koji =
{{autolang}}
koji 编译系统是专为 Fedora 7 及其以后版本使用的编译打包系统。打包者使用 Koji 的客户端去请求软件包编译和从编译系统得到相关的信息。
 
= 在 Fedora 中使用 Koji 构建系统 =
 
[[Koji| Koji 构建系统]] 是 Fedora 的 RPM 构建系统。打包人员需要使用 koji 客户端来请求构建包,并获得构建系统返回的相关信息。Koji 运行在 Mock 之上来构建不同架构的 RPM 包,并确保它们正确构建。服务自身包含多个架构的几十台在线构建宿主机。


原文地址:[[PackageMaintainers/UsingKoji| Using the Koji build system]]
原文地址:[[PackageMaintainers/UsingKoji| Using the Koji build system]]
Line 6: Line 9:
== 安装 Koji ==
== 安装 Koji ==


==== 安装 Koji CLI ====


==== 安装 Koji 的命令行模式 ====
要使用 Koji(需要您是 Fedora 的贡献者),请安装 fedora-packager 包:
 
你可以用一条命令去安装你使用 Koji(当然你还要成为一名 Fedora 的贡献者。)
 
<pre>
<pre>
yum install fedora-packager
dnf install fedora-packager
</pre>
</pre>


fedora-packager 提供了一系列脚本帮助你管理和安装你的koji环境。额外地,它也包括了 Koji CLI 的依赖,当你安装 fedora-packager 的时候就会被自动安装。该命令叫 koji,包括在 koji 的主包里。使用 Kerberos 作为默认的协议认证koji客户端和中心服务器。当然 SSL 协议和用户名/密码的办法是可行的。你需要有一个有效的认证去获得 Koji 众多特性。否则,在没有认证的情况下只有许多只读的命令工作。
fedora-packager 提供了一系列脚本帮助你安装和管理 koji 环境。额外地,它也包括了 Koji CLI 的依赖,当安装 <code>fedora-packager</code> 时 CLI 工具会被自动安装。该命令名为 <code>koji</code>,包含在 koji 主包里。koji 工具默认使用 Kerberos 协议认证客户端和中心服务器。您需要具备一个有效的认证令牌,才能使用 Koji 服务。否则,在未认证的情况下,只能运行只读命令。
 
如果您需要身份验证方面的帮助,或想成为 Fedora packager,请查看本指南:[[Join_the_package_collection_maintainers]]<br>
您需要安装 fedora-packager 软件包,执行 fedora-packager-setup 并获得有效的 kerberos 票据以执行构建。


==== 初始化 Fedora Setup ====
==== 初始化 Fedora Setup ====


为了使用 Koji 服务器,软件包维护者需要运行:
为了使用 Koji 服务器,软件包维护者需要运行:
<pre>
<pre>
/usr/bin/fedora-packager-setup
KRB5_TRACE=/dev/stdout kinit your_fas_username@FEDORAPROJECT.ORG
</pre>
</pre>


如果系统里的用户需要使用 Koji 去构建 Fedora 的软件包,则必须需要运行一次该命令。每一个用户都必须拥有他们的证书用于认证他们的身份。
其中 <code>FEDORAPROJECT.ORG</code> 必须是大写,<code>your_fas_username.ORG</code> 是你的 fas 用户名。这个命令会获取一个 krb5 ticket,用于在后续和 koji 交互时进行认证。你也可以通过 <code>koji hello</code> 来检查认证是否在正常工作。
 
{{admon/tip|Plague 用户注意|对于已经存在的 Plagu e用户(被 koji 替代的旧的编译系统),fedora-packager-setup 会使用已有的这证书。如果你早前没有用过 plague,则需要得到用户证书和告知你从哪里得到这些用户证书。}}
 
==== Fedora 证书 ====
Koji 使用以下三份证书:
 
; <code>~/.fedora.cert</code>(给与Fedora的软件包维护者) : 此份证书是在 [[Infrastructure/AccountSystem | FAS]] 的  [https://admin.fedoraproject.org/accounts/user/gencert 此页面] 生成的。当你成为软件包维护者,它就已经自动生成的。你需要重新生成它当过期的时候。
 
; <code>~/.fedora-upload-ca.cert</code>(此证书在验证的时候用于导入使用者的密钥。) : 你可以在 [https://admin.fedoraproject.org/accounts/fedora-upload-ca.cert 此处] 下载或者利用 <code>fedora-packager-setup</code> 获取它。
 
; <code>~/.fedora-server-ca.cert</code>(此证书在验证时用于导入编译服务器的密钥。) : 你可以在 [https://admin.fedoraproject.org/accounts/fedora-server-ca.cert 此处] 下载或者利用 <code>fedora-packager-setup</code> 获取它。
 


==== 配置 Koji ====
==== 配置 Koji ====
Koji 本地客户端的全局配置文件在 <code>/etc/koji.conf</code>。你不需要为编译 Fedora 软件包去更改配置文件。这些配置文件,允许你使用首要架构编译系统和次级架构编译系统。


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


== Web 界面 ==
每次推送都通过 git 自动标记。你要做的是执行以下命令构建软件包,
<pre>
fedpkg build
</pre>


用于浏览 koji 数据的首页是一个 web 应用程序。现已可以在 http://koji.fedoraproject.org/koji/ 上使用了。大多数界面都是只读的,但是如果你登入了koji的网页界面并且有足够的权限,你可以在网页里实现以下动作,例如:
这将触发当前分支的构建请求。很简单吧!


* 取消一个编译任务
还可以如下,指定特定的 koji 标签:
* 重新提交一个失败的编译任务
<pre>
* 安装一个提示
fedpkg build --target TARGET
</pre>


拥有管理权限的用户将获得额外的动作,例如
例如,在 rawhide 上构建针对由 rel-eng 创建的用于更新许多包的 API 的特殊标签,例如 <code>dist-f14-python</code>,您可以使用以下命令:
<pre>
fedpkg build --target 'dist-f14-python'
</pre>


* 新建/编辑/删除标记
==== Chained builds ====
* 新建/编辑/删除目标
* 启动/关闭编译主机


Web 界面使用了 SSL 验证,为了登录你将需要一个真实的 SSL 证书,并且你的浏览器需要被配置成信任该 SSL 证书。当运行 fedora-packager-setup.sh 将会出现如何完成以上步骤的指令。
{{Admon/warning | chain-builds 仅在 devel/ 分支 (又称为rawhide) 上工作。为了更新一个已发行的版本而 chain-build,[https://fedoraproject.org/wiki/Bodhi/BuildRootOverrides 请使用 bodhi 设置覆盖],请求将软件包包含在正确的 buildroot 中。}}


==== 提示 ====
有时,你想在启动下一个任务之前确保前一个编译成功。例如,当你想为重建依赖关系而重新构建一个包时。这种情况下,您可以使用链式构建:


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


== 指向一个目标编译软件包 ==
当前的软件包将会被加入到 CHAIN 列表的最后。冒号“:”可以作为 CHAIN 参数使用,来定义软件包所属的组。在下一组编译开始前,任何一个组中的软件包都会被并行编译,且一个组中的所有软件包都必须编译成功,并移送到软件包仓库。例如:
                   
fedpkg chain-build libwidget libaselib : libgizmo :


对于简单的编译请求,在 Makefile.common 里有一个别名去请求 koji 编译。这仅仅需要 Fedora 的打包者进入适当的软件包的发行版分支(从 CVS 服务器提取出),然后运行:
此举将会同时编译 libwidget 和 libaselib,随后是 libgizmo,然后到现有目录内的软件包。如果没有定义组,那么软件包将会按照顺序编译。如果其中一个编译失败,跟随的编译就会被取消,但已经编译好的软件包将会被推送到软件仓库。


<pre>
== Scratch Builds ==
make build
</pre>


这将会为分支启动一个编译请求。十分容易!
有时,能够针对 buildroot 构建一个未实际包含在发行版中的包是有用的。这称为 scratch 构建。以下部分介绍,直接使用 koji 以及使用 fedpkg 工具执行 scratch 构建。要从尚未提交的更改创建临时构建,请执行以下操作:
 
记录下依赖于被标记的所有要完成的编译请求分支(首先运行 <code>make tag</code>)
 
koji 也可以指向特定的标记,如下:


<pre>
<pre>
make build TARGET='<target>'
rpmbuild -bs foo.spec
koji build --scratch rawhide foo.srpm
</pre>
</pre>


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


<pre>
<pre>
make build TARGET='dist-f11-python'
koji build --scratch rawhide 'git url'
</pre>
</pre>


==== Scratch Builds ====
警告:如果您的 .spec 文件根据 %fedora 的值(%fc9等)来执行不同的操作,则临时构建将 ''不会'' 正常工作。像这样的宏值是由 ''builder'' 设置,而不是由 koji 设置,因此 %fedora 的值将由 SRPM 的值决定,而''不是''由正在构建的内容决定。非临时构建通过首先重新构建 SRPM 来解决这个问题。


你可以使用以下命令进行 scratch build :
如果您已将更改提交到 git 并且位于当前分支中,则可以使用 fedpkg 工具进行暂存(scratch)构建,该工具以适当的选项包装了 koji 工具:


<pre>
<pre>
make scratch-build
fedpkg scratch-build
</pre>
</pre>


如果你想为特定的架构进行 scratch build,你可以输入:
如果您想要针对指定架构执行一个 scratch 构建,您可以执行:


<pre>
<pre>
make scratch-build-<archs>
fedpkg scratch-build-<archs>
</pre>
</pre>


<arch>可以是用逗号分隔开的架构清单。
<archs> 是一个逗号分隔的架构列表。


最后,可以把一个特定的 koji 标记加入到 scratch-build 命令里面。
最后可以将 scratch-build 命令与特定 koji tag 结合使用:


<pre>
<pre>
make scratch-build TARGET='<target>'
fedpkg scratch-build --target TARGET
</pre>
</pre>


==== Chained builds ====
请查看 fedpkg scratch-build --help 或 koji build --help 了解更多信息。
{{Admon/warning | chain-builds仅仅在devel/ (又称为rawhide)上工作。 为了更新一个已发行的版本而 chain-build,请举行一次 [https://fedorahosted.org/rel-eng/ 发行工程师团队的投票],请求把早前已编译的软件加入到可能的编译链中。对于 Fedora 打包者,则选择 ‘koji ’套件。对于 EPEL 打包者,则选择 ‘epel’ 套件。}}


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


make chain-build CHAIN='libwidget libgizmo'
如果您上传的软件包无法通过构建,您将会看到类似的信息:
 
现有的软件包将会被加入到 CHAIN 清单的后面。“:”被应用于 CHAIN 的范围以定义软件包所属的组。在下一组编译开始前,软件包无论在任何一个组都会被并行编译,且所有软件包都必须编译成功和移送到软件包仓库。例如:
 
make chain-build CHAIN='libwidget libaselib : libgizmo :'
 
此举将会同时编译 libwidget 和 libaselib,随后是 libgizmo,然后到现有目录内的软件包。如果没有定义组,那么软件包将会按照顺序编译。如果其中一个编译失败,跟随的编译就会被取消但已经编译好的软件包将会被推送的软件仓库。
 
==== 编译失败 ====
 
如果你的软件包编译失败,你将会看到类似内容。


<pre>
<pre>
Line 131: Line 115:
</pre>
</pre>


你可以在日志文件里找出编译失败的原因。如果有一个 build.log 就打开它。或者查看 init.log
您可以通过查看日志来了解编译失败的具体原因。build.log 是最好的分析来源。除此之外还可以查看 init.log。


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


== Koji 的高级应用 ==
== Koji 高级应用 ==


我们已经尝试让 Koji 的文档无论在哪里都自动运行。该命令行将会显示出一系列有效的命令和每一个命令都支持 --help 参数,例如:
我们已经完善了 Koji 的帮助命令,确保其可以正常运行。命令行工具将会显示一个有效命令的列表,每个命令都支持 --help 参数。例如:


<pre>
<pre>
Line 143: Line 127:


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


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


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


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


<pre>
<pre>
Line 175: Line 159:


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


例如,获得最新的 dist-f14-build 编译链可以运行:
<pre>
<pre>
koji mock-config --tag dist-f12-build --arch=x86_64 --topurl=http://kojipkgs.fedoraproject.org/ dist-f12
koji mock-config --tag dist-f14-build --arch=x86_64 --topurl=http://kojipkgs.fedoraproject.org/ dist-f14
</pre>
</pre>


你将要输入 --topurl=http://koji.fedoraproject.org/ 到对应的 mock-config 命令从 fedora koji 得到一份正在运行的 mock-config。
您需要传入 --topurl=http://koji.fedoraproject.org/ 参数到对应的 mock-config 命令,从 Fedora Koji 获得一份可以运行的 mock-config。


==== 使用 koji 控制任务 ====
==== 使用 Koji 控制任务 ====


列出任务:
列出任务:
Line 204: Line 185:
</pre>
</pre>


仅列出你请求的任务:
仅列出您请求的任务:
<pre>
<pre>
koji list-tasks --mine
koji list-tasks --mine
</pre>
</pre>


重新排列一个已经进行的任务:设置为高亮:koji resubmit [options] taskID:
重新排列一个已经进行的任务:通用语法:koji resubmit [options] taskID
<pre>
<pre>
koji resubmit 3
koji resubmit 3
Line 216: Line 197:
==== 使用命令行构建一个软件包 ====
==== 使用命令行构建一个软件包 ====


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


构建软件包的命令的语法是:
<pre>
<pre>
$ koji build <build target> <cvs URL>
$ koji build <build target> <git URL>
</pre>
</pre>


例如:
例如:
{{Admon/warning | 用你想编译的标记去替换 <code>dist-f8</code>,例如 <code>dist-f9</code> 或者 <code>dist-f10</code>}}
{{Admon/warning | 使用您需要编译的标记替换 <code>dist-f14</code>,例如 <code>dist-rawhide</code>}}
<pre>
$ koji build dist-f8 'cvs://cvs.example.com/cvs/dist?rpms/kernel/FC-7#kernel-2_6_20-1_2925_fc7'
</pre>
 
koji build 命令会在Koji里创建一个编译任务。默认情况下该工具会等待和输出进程更新直到编译完成,你可以增加 --nowait 参数去跳过这些过程。也可以在 make 命令下使用以下环境变量。
<pre>
KOJI_FLAGS="--nowait" make build
</pre>
 
===== Scratch builds =====
 
你也可以 scratch build 一个源代码 rpm 包:


<pre>
<pre>
koji build --scratch dist-f8 mycoolpackage-3.2-1.src.rpm
$ koji build dist-f14 'git url'
</pre>
</pre>


警告:如果你的 .spec 文件使用.不同于 %fedora,%fc9 类似的数值,那么 Scratch build 将不会工作。打包器会像这些数值去设定 Macro 值,而不是 koji。所以 %fedora 的值将是根据源代码 RPM包 里创建的数值来设定,而不是根据它在哪个打包器上编译来设定的。非 scratched build 根据重新打包的源代码 RPM 包设定。
koji build 命令在 Koji 中创建一个构建任务。默认情况下,工具将等待并打印状态更新,直到构建完成。您可以使用 --nowait 选项覆盖此行为。
 
===== 编译选项 =====
 
在编译命令里有一系列选项。以下是一些对这些选项的解释:
 
<pre>
--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
注意:对于 fedora koji,git url 必须基于 pkgs.fedoraproject.org。其他任何 git repos 不能用于构建。
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
== Koji 标记和软件包的组织 ==
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中保留。
</pre>
 
== Koji 的标记和软件包的组织 ==


==== 术语 ====
==== 术语 ====
在koji,有时有些东西必须要区分的,例如一个普通的软件包,一个特定编译的软件包,一次编译产生的数个rpm文件。当需要精确的时候,这些条款必须按照以下内容解释:
在 Koji 中,有时需要区分一个普通的软件包,一个包的特定构建,以及由构建创建的各种 rpm 文件。当需要精确描述时,这些术语应解释如下:


* Package:源代码包的名字,一般用于普通软件包和非特定编译的build或者主包。例如:kernel,glibc等
* Package:源码包的名称,通常指普通软件包,而不是任何特定的构建或子包。例如:kernel, glibc 等。
* Build:软件包的特定编译。这里指的是完整编译:所有架构和主包。例如:kernel-2.6.9-34.EL, glibc-2.3.4-2.19
* 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  
* 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


==== 标记与目标 ====
==== 标记和目标 (tags and targets) ====


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


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


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


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


===== 目标 (Targets) =====
使用以下命令列出编译目标的完整列表:
<pre>
<pre>
$ koji list-targets
$ koji list-targets
</pre>
</pre>


你可以添加 --name 参数查看单独的一个单独的目标:
你可以添加 --name 参数查看单独的目标:
 
<pre>
<pre>
$ koji list-targets --name dist-fc7
$ koji list-targets --name dist-f14


Name                          Buildroot                      Destination
Name                          Buildroot                      Destination
---------------------------------------------------------------------------------------------
---------------------------------------------------------------------------------------------
dist-fc7                       dist-fc7-build                dist-fc7
dist-f14                       dist-f14-build                dist-f14
</pre>
</pre>


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


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


===== 标记 =====
===== 标记 (Tags) =====


你可以使用以下命令得到标记的列表:
您可以通过下列命令获得可用的发行版本分支标记:
<pre>
<pre>
$ koji list-tags
$ koji list-tags
</pre>
</pre>


===== 软件包 =====
===== 软件包 (Packages) =====


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


<pre>
<pre>
$ koji list-pkgs --tag dist-fc7
$ koji list-pkgs --tag dist-f14


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


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


===== 最新的编译任务 =====
===== 最新的构建任务 =====


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


<pre>
<pre>
$ koji latest-pkg --all dist-fc7
$ koji latest-pkg --all dist-f14


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


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


[[Category: 指南]][[Category: 教程]]
[[Category: 指南]][[Category: 教程]]

Latest revision as of 10:08, 21 November 2021

在 Fedora 中使用 Koji 构建系统

Koji 构建系统 是 Fedora 的 RPM 构建系统。打包人员需要使用 koji 客户端来请求构建包,并获得构建系统返回的相关信息。Koji 运行在 Mock 之上来构建不同架构的 RPM 包,并确保它们正确构建。服务自身包含多个架构的几十台在线构建宿主机。

原文地址: Using the Koji build system

安装 Koji

安装 Koji CLI

要使用 Koji(需要您是 Fedora 的贡献者),请安装 fedora-packager 包:

dnf install fedora-packager

fedora-packager 提供了一系列脚本帮助你安装和管理 koji 环境。额外地,它也包括了 Koji CLI 的依赖,当安装 fedora-packager 时 CLI 工具会被自动安装。该命令名为 koji,包含在 koji 主包里。koji 工具默认使用 Kerberos 协议认证客户端和中心服务器。您需要具备一个有效的认证令牌,才能使用 Koji 服务。否则,在未认证的情况下,只能运行只读命令。

如果您需要身份验证方面的帮助,或想成为 Fedora packager,请查看本指南:Join_the_package_collection_maintainers
您需要安装 fedora-packager 软件包,执行 fedora-packager-setup 并获得有效的 kerberos 票据以执行构建。

初始化 Fedora Setup

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

KRB5_TRACE=/dev/stdout kinit your_fas_username@FEDORAPROJECT.ORG

其中 FEDORAPROJECT.ORG 必须是大写,your_fas_username.ORG 是你的 fas 用户名。这个命令会获取一个 krb5 ticket,用于在后续和 koji 交互时进行认证。你也可以通过 koji hello 来检查认证是否在正常工作。

配置 Koji

Koji 本地客户端的全局配置文件在 /etc/koji.conf。你不需要为编译 Fedora 软件包去更改配置文件。这些配置文件,允许你使用首要架构编译系统和次级架构编译系统。

使用 fedpkg targets 构建

每次推送都通过 git 自动标记。你要做的是执行以下命令构建软件包,

fedpkg build

这将触发当前分支的构建请求。很简单吧!

还可以如下,指定特定的 koji 标签:

fedpkg build --target TARGET

例如,在 rawhide 上构建针对由 rel-eng 创建的用于更新许多包的 API 的特殊标签,例如 dist-f14-python,您可以使用以下命令:

fedpkg build --target 'dist-f14-python'

Chained builds

Warning.png
chain-builds 仅在 devel/ 分支 (又称为rawhide) 上工作。为了更新一个已发行的版本而 chain-build,请使用 bodhi 设置覆盖,请求将软件包包含在正确的 buildroot 中。

有时,你想在启动下一个任务之前确保前一个编译成功。例如,当你想为重建依赖关系而重新构建一个包时。这种情况下,您可以使用链式构建:

fedpkg chain-build libwidget libgizmo

当前的软件包将会被加入到 CHAIN 列表的最后。冒号“:”可以作为 CHAIN 参数使用,来定义软件包所属的组。在下一组编译开始前,任何一个组中的软件包都会被并行编译,且一个组中的所有软件包都必须编译成功,并移送到软件包仓库。例如:

fedpkg chain-build libwidget libaselib : libgizmo :

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

Scratch Builds

有时,能够针对 buildroot 构建一个未实际包含在发行版中的包是有用的。这称为 scratch 构建。以下部分介绍,直接使用 koji 以及使用 fedpkg 工具执行 scratch 构建。要从尚未提交的更改创建临时构建,请执行以下操作:

rpmbuild -bs foo.spec
koji build --scratch rawhide foo.srpm

构建最新的 git commit:

koji build --scratch rawhide 'git url'

警告:如果您的 .spec 文件根据 %fedora 的值(%fc9等)来执行不同的操作,则临时构建将 不会 正常工作。像这样的宏值是由 builder 设置,而不是由 koji 设置,因此 %fedora 的值将由 SRPM 的值决定,而不是由正在构建的内容决定。非临时构建通过首先重新构建 SRPM 来解决这个问题。

如果您已将更改提交到 git 并且位于当前分支中,则可以使用 fedpkg 工具进行暂存(scratch)构建,该工具以适当的选项包装了 koji 工具:

fedpkg scratch-build

如果您想要针对指定架构执行一个 scratch 构建,您可以执行:

fedpkg scratch-build-<archs>

<archs> 是一个逗号分隔的架构列表。

最后可以将 scratch-build 命令与特定 koji tag 结合使用:

fedpkg scratch-build --target TARGET

请查看 fedpkg scratch-build --help 或 koji build --help 了解更多信息。

构建失败

如果您上传的软件包无法通过构建,您将会看到类似的信息:

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 界面的 Task 页面里找到。或者可以使用 koji 客户端的 watch-logs 命令查看日志。查看帮助命令了解更详细信息。

Koji 高级应用

我们已经完善了 Koji 的帮助命令,确保其可以正常运行。命令行工具将会显示一个有效命令的列表,每个命令都支持 --help 参数。例如:

$ koji help

Koji commands are:
build                Build a package from source //从 SRPM 构建一个软件包
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 //输出一个标记的最新构建
[...] 
$ 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 build //运行一个 scratch 构建任务
--nowait              Don't wait on 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 id 的 mock 配置
  --mockdir=DIR         Specify mockdir //指定 mock 的目录
  --topdir=DIR          Specify topdir //指定 top 目录
  --topurl=URL          url under which Koji files are accessible //设置 Koji 文件的url地址
  --distribution=DIST   Change the distribution macro //修改发行版的宏
  -o FILE               Output to a file //输出到一个文件

例如,获得最新的 dist-f14-build 编译链可以运行:

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

您需要传入 --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

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

您可以使用 fedpkg target,也可以直接使用 koji 命令行工具。

构建软件包的命令的语法是:

$ koji build <build target> <git URL>

例如:

Warning.png
使用您需要编译的标记替换 dist-f14,例如 dist-rawhide
$ koji build dist-f14 'git url'

koji build 命令在 Koji 中创建一个构建任务。默认情况下,工具将等待并打印状态更新,直到构建完成。您可以使用 --nowait 选项覆盖此行为。

注意:对于 fedora koji,git url 必须基于 pkgs.fedoraproject.org。其他任何 git repos 不能用于构建。

Koji 标记和软件包的组织

术语

在 Koji 中,有时需要区分一个普通的软件包,一个包的特定构建,以及由构建创建的各种 rpm 文件。当需要精确描述时,这些术语应解释如下:

  • Package:源码包的名称,通常指普通软件包,而不是任何特定的构建或子包。例如: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

标记和目标 (tags and targets)

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

  • 标记支持继承
  • 每个标记都有它们拥有的有效的软件包列表(可继承)
  • 每个标记可以设置软件包的拥有权(可继承)
  • 当您构建时,指定的是目标,而不是标记

一个编译目标指定了一个软件包应该在哪里编译和如何在编译后被标记。这允许目标名称,在标签发布修改时,保持固定。

用于标记的 Koji 命令

目标 (Targets)

使用以下命令列出编译目标的完整列表:

$ koji list-targets

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

$ koji list-targets --name dist-f14

Name                           Buildroot                      Destination
---------------------------------------------------------------------------------------------
dist-f14                       dist-f14-build                 dist-f14

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

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

标记 (Tags)

您可以通过下列命令获得可用的发行版本分支标记:

$ koji list-tags
软件包 (Packages)

如上所述,每个标记都拥有属于它的软件包列表。查看一个标记的软件包列表,使用 list-pkgs 命令:

$ koji list-pkgs --tag dist-f14

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

第一列为软件包的名称,第二列表明软件包继承自哪一个标记,第三列显示软件包的所有者。

最新的构建任务

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

$ koji latest-pkg --all dist-f14

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

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