cowpoke - 云端在线

程序：

您的姓名

cowpoke - 在远程 cowbuilder 实例中构建 Debian 源包

概要

牧童 [选项] 包名.dsc

商品描述

将 Debian 源包上传到 造牛者 托管并构建它，也可以选择
签名并将结果上传到传入队列。

配置

可以使用以下选项：

--拱门=架构
指定要为其构建的 Debian 架构。 一个空格分隔的列表
架构可用于在一次通过中为所有这些架构进行构建。 有效拱门
名称是由返回的名称 dpkg-架构（1） DEB_BUILD_ARCH.

--距离=分配
指定要为其构建的 Debian 发行版。 一个空格分隔的列表
分布可用于在一次通过中为所有这些构建。 任何一个
代号（例如 SID或 挤) 或分发名称（例如 不稳定或
试验) 可以使用，但您通常应该坚持使用其中一个
始终如一，因为此名称可用于文件路径并定位旧包
比较报告。

现在还可以在此选项中使用本地定义的名称，当用于
与 BASE_DIST 配置文件中的选项。 这允许
维护和使用专门配置的build chroots，可以源码包
来自 backports 档案或本地存储库的依赖项，或具有其他
设置了不寻常的配置选项，而不会污染您用于清理的 chroot
用于上传到主存储库的包构建。 看说明
of BASE_DIST 联络一位教师

--buildd=主持人
指定要在其上构建的远程主机。

--buildd-用户=姓名
指定要构建的远程用户。

- 创建
创建远程 造牛者 root 如果它不存在。 如果这个选项是
未通过它是指定的错误 --距离 or - 拱 没有
现有 造牛者 根在预期的位置。

这个 --buildd-用户 必须具有创建权限 结果目录 在构建主机上，
或者具有必要权限的管理员必须首先创建它并授予该用户
（或他们所在的某个组）对其进行写访问，以使此选项成功。

--返回=[径]
将构建结果复制到 径。 如果 径 未指定，然后将它们返回到
当前目录。 给定的 径 必须存在，它不会被创建。

--无回报
不要将构建结果复制到 返回目录 （覆盖为它设置的路径
配置文件）。

--dpkg-opts='选择1 选择2 ...'
指定要传递给的附加选项 dpkg-构建包(1). 多种选择
用空格分隔。 这将覆盖中指定的任何选项
调试器 在构建主机的 编译器.

--创建-选择='牛仔 选项'
指定要逐字传递给的附加参数 造牛者 当 chroot 是
首先创建（使用 - 创建 以上选项）。 如果需要多个参数
通过，应为每个选项单独指定此选项。

例如， --创建选项 “--othermirror” --创建选项 “德布 http:// ...“

此选项将覆盖任何 创建选项 为 cowpoke 中的 chroot 指定
配置文件。

--更新选项='牛仔 选项'
指定要逐字传递给的附加参数 造牛者 如果基础
chroot 已更新。 如果需要传递多个参数，这个选项应该是
分别为每一个指定。

此选项将覆盖任何 更新选项 为 cowpoke 中的 chroot 指定
配置文件。

--build-opts='牛仔 选项'
指定要逐字传递给的附加参数 造牛者 当一个包裹
执行构建。 如果需要传递多个参数，这个选项应该是
分别为每一个指定。

此选项将覆盖任何 构建选项 为 cowpoke 中的 chroot 指定
配置文件。

--符号=键名
指定用于对包进行签名的密钥。 这将覆盖任何 SIGN_KEYID 指定
对于 cowpoke 配置文件中的 chroot。

--上传=队列
指定要将签名包上传到的 dput 队列。 这将覆盖任何
上传队列 在 cowpoke 配置文件中为 chroot 指定。

- 帮帮我 显示可用选项和当前配置的简要摘要。

- 版
显示当前版本信息。

配置 配置

在规划婴儿食品行业的工艺要求时，安全性和可靠性是工艺设计中最重要的方面。 牧童 运行以下配置选项从全局读取，每个用户，
和每个项目的配置文件（如果存在）。 文件路径可以是绝对的或相对的，
后者相对于 构建用户的主目录。 由于路径是
通常在使用时引用，波浪号扩展将 而不去 对他们进行。

全球覆盖 默认
这些适用于每个 拱 和 DIST 在单个 cowpoke 调用中。

BUILDD_HOST
构建机器的网络地址或 fqdn，其中 造牛者 已配置。
这可能会被覆盖 --buildd 命令行选项。

构建用户
在构建机器上进行操作的非特权用户名。 这默认为
执行用户的本地名称 牧童 （或指定的用户名
您的 SSH 配置 BUILDD_HOST)，并且可能被覆盖 --buildd-用户
命令行选项。

BUILDD_ARCH 建筑
要为其构建的 Debian 架构。 这必须符合 DEB_BUILD_ARCH 的
正在使用构建 chroot。 它默认为本地机器架构，其中
牧童 被执行，并且可能被覆盖 - 拱 命令行选项。 一种
（引用）空间分隔的架构列表可用于此处构建所有
他们一次通过。

构建_DIST
要为其构建的 Debian 发行版。 一个（引用）空格分隔的列表
分布可用于在一次通过中为所有这些构建。 这可能是
被覆盖 --距离 命令行选项。

传入_目录
构建机器上的目录路径，源包最初位于
放置。 这必须是可写的 构建用户.

PBUILDER_BASE
所有 pbuilder CoW 和结果文件的文件系统根目录。 拱 和 DIST 具体的
子目录通常会在此下创建。 apt 缓存和临时
build 目录也将位于此路径下。

SIGN_KEYID
如果设置了此选项，则应包含要传递给的 gpg 密钥 ID
设计(1) 如果要对包进行远程签名。 系统会提示您
确认您是否希望在所有构建完成后对包进行签名。 如果
此选项未设置或为空字符串，不会尝试对包进行签名。
它可能会被覆盖 拱 和 DIST 使用的具体依据
拱门距离_SIGN_KEYID 下面描述的选项，或每次调用 - 标志
命令行选项。

上传队列
如果设置了这个选项，它应该包含一个“主机”规范 输出(1)
签名后将用于上传它们。 系统会提示您
确认您是否希望在签名后上传包。 如果这
选项未设置或为空字符串，将不会尝试上传包。 如果
SIGN_KEYID 未设置，此选项将被完全忽略。 它可能会被覆盖
上一个 拱 和 DIST 使用的具体依据 拱门距离_上传_队列 选项
下面描述，或每次调用 --上传 命令行选项。

BUILDD_ROOTCMD
用于在远程构建机器上获得 root 权限的命令。 如果未设置
默认是 须藤(8). 这只需要调用 造牛者 并允许它
输入它的 chroot，所以你可以限制这个用户只能运行那个
具有升级权限的命令。 sudoers 中的类似内容将启用
调用 造牛者 无需额外的密码输入：

youruser ALL = NOPASSWD：/usr/sbin/cowbuilder

或者，您可以使用带有转发密钥的 SSH 或任何其他机制
适合您的本地访问策略。 使用 su -c 不太适合这里，因为它
报价要求与其他要求略有不同。

去引导程序
创建新构建根时要使用的实用程序。 替代方案是 解除引导 or
引导程序.

返回目录
如果设置，生成的包文件将被复制到路径（本地或
远程），这被设置为，在构建完成后。 路径必须存在，它
不会被创建。 默认情况下未设置此选项，可以使用
- 返回 or --无回报.

拱 和 DIST 具体的 选项
这些是以下形式的变量：$arch_$dist_VAR 仅适用于特定目标
拱/dist 构建。

拱门距离_RESULT_DIR
生成包（源和
binary) 将被找到，以及构建的旧版本包的位置
以前可以找到。 如果存在任何此类较旧的软件包， 德比夫 将习惯
构建完成后将新包与以前的版本进行比较，以及
结果将包含在构建日志中。 其中的文件必须是可读的
构建用户 用于完整性检查 临田（1）和 德比夫(1)，以及上传
输出(1). 如果未为某些 arch 和 dist 组合指定此选项，则
它将默认为 $PBUILDER_BASE/$arch/$dist/结果

拱门距离_BASE_PATH
找到 CoW 主文件的目录（或创建，如果
- 创建 命令行选项已通过）。 如果没有为某些指定此选项
arch 或 dist 那么它将默认为 $PBUILDER_BASE/$arch/$dist/base.cow

拱门距离_BASE_DIST
要传递的代码名称 - 分配 牛建造者的选择，而不是 DIST.
这是必要的，当 DIST 是分配给某些的本地重要名称
专门配置的构建 chroot，例如 'wheezy_backports'，而不是正式的
debootstrap 已知的发行版的套件名称。 这个选项不能
在命令行上覆盖，因为它很少（如果有的话）有意义
为个别调用更改它 牧童. 如果未指定此选项
对于 arch 和 dist 组合，它将默认为 DIST.

拱门距离_CREATE_OPTS
包含附加选项的 bash 数组以逐字传递给 造牛者 当这个
chroot 是第一次创建（使用 - 创建 选项）。 这很有用
当选项像 --其他镜像 想要创建专门的 chroot
诸如“wheezy_backports”之类的配置。 默认情况下这是未设置的。 所有值
如果设置将被覆盖 --创建选项 选项在命令上传递
线。

此数组中的每个元素对应一个参数（在 ARGV 意义上）
这将传递给cowbuilder。 这确保了可能包含的参数
空格或有奇怪的引用要求或其他特殊字符会
在他们到达奶牛制造商之前不要被破坏。

Bash 数组使用以下形式初始化：

OPTS=( "arg1" "arg 2" "--option" "value" "--opt=val" "etc. etc." )

拱门距离_更新_选项
包含附加选项的 bash 数组以逐字传递给 造牛者 粉末
此 chroot 的基础已更新。 它的行为类似于 创建选项 选项
以上，除了在 chroot 更新时执行。

拱门距离_BUILD_OPTS
包含附加选项的 bash 数组以逐字传递给 造牛者 粉末
在这个 chroot 中执行包构建。 这在您想使用时很有用
一些选项，如 - 两次 哪个牛仔不需要直接关心。 它
否则行为类似于 更新选项 以上，除了它在
构建阶段 造牛者.

拱门距离_SIGN_KEYID
一个可选的 arch 和 dist 特定的全局覆盖 SIGN_KEYID 选项。

拱门距离_上传_队列
一个可选的 arch 和 dist 特定的全局覆盖 上传队列 选项。

配置 FILES

/etc/cowpoke.conf
全局配置选项。 将覆盖硬编码的默认值。

〜/.cowpoke
每用户配置选项。 将覆盖任何全局配置。

。牧童
每个项目的配置选项。 将覆盖任何每个用户或全局
配置如果 牧童 从它们所在的目录调用。

如果环境变量 COWPOKE_CONF 被设置，它指定了一个额外的
配置文件将覆盖上述所有内容。 指定的选项
在命令行上明确覆盖所有配置文件。

牛仔布 配置

没有什么特别需要配置一个 造牛者 使用实例
- 牧童. 只需使用`以您需要的风味创建它们造牛者 - 创建`
根据本 造牛者 文档，然后配置 牧童 与用户、拱门和
访问它所需的路径信息，在您希望从中调用它的机器上（或
或者配置 牧童 带有路径、拱形和分布信息和通行证
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 - 创建 第一次调用时的选项）。 正在运行的构建主机 造牛者
不要求 牧童 本地安装。

构建机器应该有 临田 和 文字 为后期构建安装的软件包
健全性检查。 完成后，构建日志和自动检查的结果将
记录在 传入_目录. 如果你想上传签名包，构建机器
还需要 输出(1) 安装并配置为使用 '主持人' 指定的别名
上传队列。 如果 rsync的(1) 在本地和构建机器上都可用，然后它将
用于传输源包（这可能会节省一些传输 原版.tar.*
在构建后续 Debian 修订版时）。

用户执行 牧童 必须具有对构建机器的 SSH 访问权限，因为 构建用户.
该用户必须能够调用 造牛者 以 root 身份使用 BUILDD_ROOTCMD. 签约
不需要在构建机器上安装密钥（并且在那里将被忽略，如果
他们是）。 如果包已签名，则在执行的机器上将需要密钥
牧童.

在规划婴儿食品行业的工艺要求时，安全性和可靠性是工艺设计中最重要的方面。 牧童 被调用，它将首先尝试更新 造牛者 图像如果有
没有在同一天完成。 这是通过存在或不存在
cowbuilder-$arch-$dist-更新日志-$date 文件中 传入_目录. 你可以移动、移除、
或者，如果您希望图像更新频率更高或更低，请触摸此文件。 它的
内容记录输出 造牛者 在构建根的更新（或创建）期间。

附注

建立 造牛者 创建一个 chroot，为此你需要 root， 牧童 也需要
某种程度的根访问权限。 所以所有可能出错的可怕事情都可能
好吧，有一天你会下雨。 造牛者 已知会意外消除绑定
在 chroot 之外挂载的文件系统，比这更糟糕的情况很容易发生。 所以是
小心，保留好你不想在你的构建机器上丢失的东西的备份，并使用
牧童 将所有这些都保存在一台机器上，而不是你最后一个最前沿的开发箱
几个小时未完成的工作。

使用 onworks.net 服务在线使用 cowpoke