This is Gentoo's testing wiki. It is a non-operational environment and its textual content is outdated.
Please visit our production wiki at https://wiki.gentoo.org
二进制包指南
除了支持通常的 ebuilds 之外, Portage 还支持构建、安装二进制包。 本指南将解释如何创建、安装二进制包,以及如何配置一个二进制包服务器。
介绍
有很多原因为什么系统管理员喜欢在 Gentoo 中使用二进制软件包。
- 它允许管理员 当保持相似的系统最新时能节省时间。从源代码编译所有东西是很耗费时间的。维护许多相似的系统,可能其中的一些硬件较老,如果一个系统将所有东西从源代码编译好,其他系统使用这些二进制包,工作就会变得轻松。
- 执行安全升级。对于关键任务系统来说,保持尽可能大的 可用性 是很重要的。这可以通过一台预备服务器来实现,它首先自己执行所有的更新。一旦预备服务器更新后状态良好,那么更新可以被应用到关键系统上。这种方法的一个变形是在同一个系统的一个 chroot 中执行更新,并且在真正的系统中使用所创建的二进制包。
- 作为一个备份。通常二进制包是恢复一个受损系统的唯一方法(例如编译器受损)。拥有一台二进制包服务器上的或者本地的预编译二进制包,对于工具链受损的情况有很大的帮助。
- 它也支持 更新非常旧的系统。更新非常旧的系统这项任务可以通过使用二进制包来大大减轻。通常在旧的系统上安装二进制包是有益的,因为它们不需要安装/更新构建时依赖。因为二进制包是预编译的,这也避免了在构建过程中发生失败。
本指南将包括以下话题:
- 创建二进制包;
- 将二进制包发布到客户端;
- 使用二进制包;
- 维护二进制包。
在向导的末尾还包含几个关于二进制包操作的高级话题。
除非另行指出,本指南中使用的所有的工具都是 sys-apps/portage 的组成部分。
创建二进制包
创建二进制包有三种主要的方法:
- 在一次常规安装后,使用quickpkg程序;
- 在 emerge 操作中显式使用
--buildpkg
(-b
) 选项; - 通过使用 Portage 的 FEATURES 变量
buildpkg
自动完成。
所有这三种方法都将在 PKGDIR 变量指向的目录创建二进制包(默认为 /usr/portage/packages)。
使用 quickpkg
quickpkg 程序接收一个或多个依赖 atoms (或者包集合)并对所有与那个 atom 匹配的 已安装 包创建二进制包。
例如,要对所有已安装 GCC 版本创建二进制包:
root #
quickpkg sys-devel/gcc
要对系统中所有已安装包创建二进制包,使用 *
通配符:
root #
quickpkg "*/*"
这种方法有一点要注意:它依赖已安装的文件,会在配置文件上发生问题。管理员经常在安装完软件后改变配置文件。因为这可能向包中泄露重要(甚至可能是机密)数据, quickpkg 默认通过 CONFIG_PROTECT 方法保护配置文件不被包含在内。要强制包含配置文件,使用 --include-config
或 --include-unmodified-config
选项。
使用 --buildpkg 作为 emerge 选项
当使用 emerge 安装软件时, Portage 可以通过 --buildpkg
(-b
) 选项被要求创建二进制包:
root #
emerge --ask --buildpkg sys-devel/gcc
还可以要求 Portage 只 创建二进制包却 不 在活动系统上安装软件。 这种情况下,使用 --buildpkgonly
(-B
) 选项:
root #
emerge --ask --buildpkgonly sys-devel/gcc
后一种方法还是需要构建时的依赖事先已安装。
作为 Portage 特性实现 buildpkg
最常用的自动创建二进制包的方式是每当使用 Portage 安装一个包就自动创建二进制包,通过使用 buildpkg
特性来实现,可以在 /etc/portage/make.conf 中进行设置,例如:
/etc/portage/make.conf
打开Portage的二进制包创建功能FEATURES="buildpkg"
开启这项特性后,每次 Portage 安装软件,它将也创建一个二进制包。
排除一些包的创建
告诉 Portage 不要对一些指定的包或分类创建二进制包也是可以的。 这个可以通过向 emerge 传递 --buildpkg-exclude
选项:
root #
emerge -uDN @world --buildpkg --buildpkg-exclude "virtual/* sys-kernel/*-sources"
这可以对那些不值得创建二进制包的包使用。例如 Linux 内核代码包或上游二进制包(那些以 -bin 结尾如 www-client/firefox-bin)。
配置二进制包主机
Portage 支持多种下载二进制包的协议:FTP、FTPS、HTTP、HTTPS和SSH/SFTP。这为多种可能的二进制包主机的实现提供了空间。
可是,Portage 并没有提供一个“现成”的方法来分发二进制包。根据需求还需要安装额外的软件。
基于 Web 的二进制包主机
一种常用的分发二进制包的方法是创建一个基于 web 的二进制包主机。
使用一个 web 服务器如 lighttpd (www-servers/lighttpd) 并且将其配置为提供对 /etc/portage/make.conf 中 PKGDIR 位置的读权限。
/etc/lighttpd/lighttpd.conf
lighttpd 配置范例# add this to the end of the standard configuration server.modules += ( "mod_alias" ) alias.url = ( "/packages" => "/usr/portage/packages/" )
之后,在客户系统,对应地设置 PORTAGE_BINHOST 变量:
/etc/portage/make.conf
使用基于Web的二进制包主机PORTAGE_BINHOST="http://binhost.example.com/packages"
SSH 二进制包主机
要提供一种更多身份验证的二进制包方法,可是考虑使用 SSH 。
当使用 SSH ,可以使用 root Linux 用户的 SSH 密钥 (without passphrase as the installations need to happen in the background) 来连接到远程二进制包主机。
要实现这个,确保 root 用户的 SSH 密钥被服务器所接受的。这需要每台通过 SSH 链接到二进制包主机的客户机的 SSH 密钥都是被服务器接受的。
root #
cat root.id_rsa.pub >> /home/binpkguser/.ssh/authorized_keys
PORTAGE_BINHOST 看起来如下:
/etc/portage/make.conf
配置PORTAGE_BINHOST用于SSH访问PORTAGE_BINHOST="ssh://binpkguser@binhostserver/usr/portage/packages"
Do not use the SSH configuration files found in ~/.ssh/config for setting ports or username. This location is ignored when Portage tries to rsync the packages back onto the client. Instead set all the options correctly in the PORTAGE_BINHOST variable.
NFS 导出
当在内网中使用二进制包,可以更简单地通过 NFS 导出包并在客户系统进行挂载。
/etc/exports 文件看起来如下:
/etc/exports
导出包目录/usr/portage/packages 2001:db8:81:e2::/48(ro,no_subtree_check,root_squash) 192.168.100.1/24(ro,no_subtree_check,root_squash)
在客户系统,这个位置就可以被挂载。例如 /etc/fstab 看起来如下:
/etc/fstab
包目录的挂载点binhost:/usr/portage/packages /usr/portage/packages nfs defaults 0 0
使用二进制包
要在其他系统使用二进制包,需要满足一些条件:
- 客户机和服务器的架构以及CHOST关键字的设置必须是一致的。
- 用来创建二进制包的CFLAGS和CXXFLAGS两个参数的设置必须和所有的客户机兼容。
- 针对处理器特定指令集的USE设置(如MMX,SSE等)要仔细选择,以保证所有的客户机都支持这些功能。
Portage不会验证是否满足上述条件,因为维护这些设置是系统管理员的职责。
除了这些,Portage将检查创建二进制包时是否用和客户机一样的USE设置。如果二进制包是用不同的USE设置来创建的,Portage将忽略这个二进制包(改为使用基于源代码的方式进行安装)或者提示安装失败,取决于运行emerge命令时所带的选项(参看安装二进制包)。
为了使用二进制包,在客户机上有几个配置需要更改。
安装二进制包
在运行 emerge 命令时有几个选项可以用于告诉 Portage 使用二进制包:
Option | Description |
---|---|
--usepkg (-k ) |
Tries to use the binary package(s) in the locally available packages directory. Useful when using NFS or SSHFS mounted binary package hosts. If the binary packages are not found, a regular (source-based) installation will be performed. |
--usepkgonly (-K ) |
Similar to --usepkg (-k ) but fail if the binary package cannot be found. This option is useful if only pre-built binary packages are to be used.
|
--getbinpkg (-g ) |
Download the binary package(s) from a remote binary package host. If the binary packages are not found, a regular (source-based) installation will be performed. |
--getbinpkgonly (-G ) |
Similar to --getbinpkg (-g ) but will fail if the binary package(s) cannot be downloaded. This option is useful if only pre-built binary packages are to be used.
|
为了自动使用二进制包进行安装,可以在EMERGE_DEFAULT_OPTS变量增加适当的选项:
/etc/portage/make.conf
Automatically fetch binary packages and fail the package if not availableEMERGE_DEFAULT_OPTS="${EMERGE_DEFAULT_OPTS} --getbinpkgonly"
There is a Portage feature that automatically implements the equivalent of --getbinpkg
(-g
) without the need for updating the EMERGE_DEFAULT_OPTS variable with the --getbinpkg
value:
/etc/portage/make.conf
Enabling getbinpkg in the FEATURES variableFEATURES="getbinpkg"
从二进制包主机下载包
当使用二进制包主机时,客户机需要配置PORTAGE_BINHOST变量。不然,客户机不知道二进制包的存放位置将导致Portage无法获取二进制包。
/etc/portage/make.conf
Setting PORTAGE_BINHOSTPORTAGE_BINHOST="http://binhost.example.com/packages"
PORTAGE_BINHOST变量使用一个用空格进行分割的URI列表。这可以让管理员可以同时使用不同的二进制包主机。URI地址应该总是指向Packages文件所在的目录。
对于多个二进制包服务器的支持还不是很完整。如果几个服务器提供同一个版本的二进制包,那么只会使用第一个。当这些二进制包的USE变量配置不一样,而且后面的二进制包的USE变量配置是适合当前系统配置的情况下会产生问题。
重安装修改过的二进制包
Passing the --rebuilt-binaries
option to emerge will reinstall every binary that has been rebuilt since the package was installed. This is useful in case rebuilding tools like revdep-rebuild are run on the binary package server.
一个相关的选项是--rebuilt-binaries-timestamp
。它将使emerge不会重新安装那些在给定的时间标签之前已经建立的二进制包。如果二进制包服务器不得不从头开始重建而又要使用--rebuilt-binaries
选项,这对于避免重新安装所有的包来说是很有用。
额外的客户端设置
跟着 getbinpkg
功能特性,Portage还接受 binpkg-logs
这个功能特性。这个特性控制是否保留二进制包成功安装记录的日志文件。它只有在设置了PORT_LOGDIR变量的情况下才会生效,默认为启用。
和从特定的包集合或分类中排除一些二进制包类似,客户机可以配置为从特定的包集合或分类中排除一些二进制包的安装。
用--usepkg-exclude
选项来实现这一功能:
root #
emerge -uDNg @world --usepkg-exclude "sys-kernel/gentoo-sources virtual/*"
To enable such additional settings for each emerge command, add the options to the EMERGE_DEFAULT_OPTS variable in the make.conf file:
/etc/portage/make.conf
Enabling emerge settings on every invocationEMERGE_DEFAULT_OPTS="${EMERGE_DEFAULT_OPTS} --usepkg-exclude 'sys-kernel/gentoo-sources virtual/*'"
维护二进制包
如果二进制包列表不积极维护,导出和分发二进制包只会白白浪费存储空间。
删除过期的二进制包
app-portage/gentoolkit 包提供了一个叫 eclean 的应用。它可以用来维护Portage相关的一系列文件,如下载的源代码文件和二进制包。
The following command will remove all binary packages that have no corresponding ebuild in the installed ebuild repositories:
root #
eclean packages
请阅读Eclean的相关文章以了解更多细节。
另外一个可用的工具是 app-portage/portage-utils 包所提供的 qpkg 工具。不过,这个工具的可配置性稍微差些。
清理“无用”的二进制包(应用于存放二进制包的服务器上):
root #
qpkg -c
维护包文件
Inside the packages directory exists a manifest file called Packages. This file acts as a cache for the metadata of all binary packages in the packages directory. The file is updated whenever Portage adds a binary package to the directory. Similarly, eclean updates it when it removes binary packages.
当出于某些原因要简单地删除二进制包或将它们复制到包目录里去的时侯;或者 Packages 文件损坏或被删除了的时候,那么就必须重建这个文件。通过使用 emaint 命令来完成这个工作:
root #
emaint binhost --fix
高级主题
建立二进制包目录的快照
当需要分发二进制包给大量的客户机系统的时候,建立包目录的快照可能会比较划算。客户机系统就不是直接使用包目录,而是使用快照所提供的二进制包。
可以使用 /usr/lib64/portage/python2.7/binhost-snapshot 或者 /usr/lib64/portage/python3.3/binhost-snapshot 工具来创建快照。它需要四个参数:
- 一个源目录(包目录的路径)。
- 一个目标目录(目录必须不存在)。
- 一个URI地址。
- 一个二进制包服务器目录。
将包目录的文件复制到目标目录,然后在URI地址所指向的二进制包服务器的目录(第四个参数)里创建一个Packages文件。
客户系统需要使用一个指向二进制包服务器的 URI 地址。然后他们将会被重定向到被传递给 binhost-snapshot 的快照URI地址。这个快照 URI 地址必须指向目标目录。
理解二进制包的格式
Portage 所创建的二进制包的文件名以 tbz2 结尾,这种文件由两部分构成:
- 一个 .tar.bz2 的归档文件,包含了将会安装到系统中的文件;
- 一个 xpak 的归档文件包含了包的元数据,ebuild 和环境文件。
查看 man xpak 来了解格式描述。
在 app-portage/portage-utils 中有一些工具能分解或创建 tbz2 和 xpak 文件。
下列命令可以将 tbz2 文件分解成一个 .tar.bz2 和一个 .xpak 文件:
user $
qtbz2 -s <package>.tbz2
.xpak 文件可以用 qxpak 工具来检查。
列出其内容:
user $
qxpak -l <package>.xpak
下一条命令将生成一个叫 USE 的文件,文件包含了这个包所使用的 USE 设置:
user $
qxpak -x package-manager-0.xpak USE
PKGDIR的布局
目前使用的布局(版本2)如下:
PKGDIR `+- Packages +- app-accessibility/ | +- pkg1-version.tbz2 | `- pkgN-version.tbz2 +- app-admin/ | `- ... `- ...
Packages 文件是在第一个二进制包目录布局(版本1)之上最主要的改进(同时也是让 Portage 知道二进制包目录使用版本2的触发器)。在版本1中,所有二进制包都被放在一个叫 All/ 的目录里,而分类目录只是指向 All/ 目录中二进制包的符号链接。
用 quickunpkg 来解包
Zoobab 编写了一个叫 quickunpkg 的简单脚本程序来快速解包 tbz2 文件。