adt-run - 云端在线

程序：

您的姓名

adt-run - 使用源包的测试测试已安装的二进制包

概要

广告运行 选项... --- 虚拟服务器 [虚拟服务器参数...]

商品描述

广告运行 是调用 autopkgtest 包测试机制的程序。

autopkgtest 是一种用于测试二进制 Debian 或 Click 软件包的工具，它们安装在
系统（例如测试平台系统）。 测试是源包中提供的测试。

adt-run 运行由特定包提供的每个测试并报告结果。 它
根据需要驱动指定的虚拟化机制，并解析测试描述
元数据，并根据需要安排将数据复制到测试台和从测试台复制。

有关如何操作的介绍，请参阅 /usr/share/doc/autopkgtest/README.running-tests.rst.gz
使用adt-run。

指定 试验

操作指定要测试的源和二进制包，或更改发生的情况
包参数：

- 来源 DSC
从 Debian 源包运行测试 DSC. 默认情况下，包也将被构建
生成的二进制文件将用于满足测试依赖项； 禁用
即，指定 -B/--无内置二进制文件 之前的选项。

顺序很重要：每个 - 来源 选项应该在选项之前
依赖关系由它产生的二进制文件来满足。

--未建树 目录
指定来自未构建的 Debian 源代码树的测试 目录 应该运行。
这与指定非常相似 - 来源 除了目录树（其中
应该是原始的）提供，而不是源包。

--建树 目录
指定来自构建的 Debian 源代码树的测试 目录 应该运行。
请注意，所有测试依赖项都由存档包满足，除非您
显式指定本地构建的 .debs --二进制.

--apt源 源文件名
资料下载 源文件名 apt-get的 资源 在测试平台中并运行其测试。 这是
类似于指定 - 来源 但避免将源从主机复制到
试验台。 可能构建的二进制文件将 不能 用于满足依赖关系，如
通常在这种模式下，您希望从真实档案中测试二进制文件。

--git-源 网址 [分店名称]
指定来自 git-cloning 的未构建的 Debian 源代码树的测试 网址
应该运行。 如果 分店名称 给出，这个分支将被检出而不是
默认值（通常是“master”）。

这与指定非常相似 --未建树 克隆后，即这是
通常与 --无内置二进制文件。 该 混帐 软件包将被安装，如果
必要。

--二进制 DEB
规定 DEB 应该用于以下所有源包的测试。 经过
默认情况下，它将用于在构建和测试期间满足依赖项。

排序很重要，至于 - 来源. 特别是，如果后续来源
package 将构建一个同名的二进制文件，从那时起将被使用，并且
DEB 将被忽略。

- 变化 变化
指定给定 .changes 中的 debs 应该用于测试
.changes 中的源包。 就像您指定了 .debs 和 .dsc 一样
从 .changes 文件作为显式参数。

--点击源 点击源
单击源树以供后续使用的路径 - 点击 包。

- 点击 点击包
If 点击包 是一个文件 (*.click)，将给定的 click 包安装到测试平台中。 如果是
单击名称（如“com.example.myapp”），假设它已安装在
测试台并从中读取清单。

从前面运行单击包测试 --点击源. 如果一个点击源
目录没有明确指定，将根据
清单的 x源 入口。 目前唯一支持的架构是 VCS-BZR.

文件名
像处理裸文件名参数一样 --建树, - 来源, --未建树,
--apt源, --二进制, - 变化, --点击源或 - 点击 被指定； 这
从文件名的形式猜测参数的性质。 如果是
--建树, 要么必须指定选项，要么文件名必须以
削减; 末尾的两个斜杠表示 --未建树. 如果给定
目录有一个“click”子目录，它被解释为 --点击源.

测试 配置

除非另有说明，否则这些会影响所有后续的测试参数。

-B | --无内置二进制文件
来自后续的所有构建的二进制文件 - 来源 or --未建树 测试不会
构建或忽略，并且依赖项满足存档中的包。
请注意，如果测试需要，仍会构建包 建造需要.

--内置二进制文件
随后 - 来源 or --未建树 将构建测试及其依赖项
对构建的二进制文件感到满意。 这是默认行为，因此您只需
需要这个来恢复以前指定的 --无内置二进制文件 选项。

--覆盖控制=PATH
读取测试元数据 PATH 而不是 Debian/测试/控制 （对于 Debian
源）或 Click 清单以进行以下测试。

--测试名称=测试
在以下测试中仅运行给定的测试名称（来自测试控制文件）。

记录 配置

如果不指定任何选项， 广告运行 仅将其输出/结果写入 stderr。

-o DIR | --输出目录=DIR
指定测试工件（来自测试的 stderr 和 stdout、日志文件、
构建的二进制包等）应该放在给定的目录中。 DIR 不得
存在或为空，否则 广告运行 将拒绝使用它。

-l 日志文件 | --日志文件=日志文件
指定应将跟踪日志写入 日志文件 而不是 输出目录.

--摘要=摘要
指定应将结果摘要写入 摘要. 事件
在摘要中无论如何都会写入日志。

-q | - 安静的
不要发送副本 广告运行的跟踪日志流到标准错误。 该选项不
影响发送到的副本 日志文件 or 输出目录. 注意没有痕迹
logstream 很难诊断问题。

测试 BED 设置 配置

--设置命令=命令
运行 命令 打开测试台后。 这可以用于例如启用额外的
apt 来源，运行 apt-get的 更新 或类似。 如果 命令 是一个现有的文件名，
命令是从中读取的； 否则它是一个带有实际命令的字符串
按原样运行。 没有目录的文件名将在
当前目录和 /usr/share/autopkgtest/设置命令/ 所以你不需要
提供 autopkgtest 附带的安装脚本的完整路径。

可以多次指定此选项。

If - 用户 给出或测试台提供 建议普通用户 能力，
$ADT_NORMAL_USER 环境变量将设置为该用户。

如果设置命令影响引导目录中的任何内容（例如 /启动 or
/lib/systemd/系统) 并且测试平台支持重启，测试平台将
在设置命令后重新启动。 这可以通过创建文件来抑制
/run/autopkgtest_no_reboot.stamp.

--apt-升级 | -U
运行 apt-get的 更新 和 apt-get的 DIST升级 -y 在运行之前的测试台中
试验。

--apt-口袋=口袋[=pkgname,src:srcname,...]
添加 apt 源 释放-口袋. 这找到第一个 DEB 排队
的/ etc / apt / sources.list文件 它尚未指定口袋并添加了 deb 和
带那个口袋的 deb-src 行 /etc/apt/sources.list.d/口袋。清单。 这也是
电话 apt-get的 更新 用于新口袋（但不是用于其他任何东西）。

如果在 = 之后给出了包列表，则设置 apt pinning 以仅使用这些包
止 口袋. 条目“src:srcname”扩展到所有由它构建的二进制包
来源。 这可用于最小化从 口袋 以便
该口袋中的软件包更新可以相互独立地进行测试
更好的隔离。 注意： 这目前不能解决某些情况
给定包的依赖关系只能在给定的口袋中解决。 在
在这种情况下，将删除 apt 固定并重试软件包安装
与整个 口袋.

--复制=主机路径：TESTBEDPATH
打开后将文件或目录从主机复制到测试台。 这发生在之前
--设置命令 因此您可以在设置命令中使用这些文件。

--环境=VAR=值
在构建和测试中设置任意环境变量。 可以指定多个
倍。

用户/权限 搬运 配置

-u 用户 | --用户=用户
运行构建和测试 用户 在试验台上。 这需要在测试台上扎根； 如果
测试台上的 root 不可用，然后以任何用户身份运行构建和测试
提供。

--获得根=扎根
前缀 Debian/规则 二进制 有增益根. 默认是不使用任何东西，
除了如果 - 用户 已提供或测试台上的 root 不可用
默认是 假根.

调试 配置

-调试|-d
在跟踪日志中包含其他调试信息。 每增加 -d
提高调试级别； 当前的最大值是 -ddd. 如果你喜欢看
这是怎么回事，-d or -dd is 建议。

--shell 失败|-s
在构建、测试或依赖项失败后在测试台中运行交互式 shell
安装。

- 贝壳
每次测试后在测试台中运行交互式 shell。

超时 配置

- 暂停-这=秒
对测试台上或与测试台一起进行的操作使用不同的超时。 有五个
受五个值影响的超时 这: 短: 所谓的短操作，如
设置测试平台的 apt 并检查状态（默认值：100s）； 安装:
安装包含依赖项的包（默认：3,000s）； test: 试运行
（默认：10,000 秒）； 复制：在主机和测试床之间复制文件/目录（默认：
300 秒）； 和 建立：构建（默认值：100,000 秒）。 该值必须指定为
整数秒。

--超时因子=翻番
将所有默认超时乘以指定因子（请参阅 - 暂停-这
以上）。 只有默认值会受到影响； 完全使用显式超时设置
作为指定。

本地 配置

--设置语言=朗瓦尔
在测试台上运行命令时，设置 朗 环境变量
朗瓦尔. 默认在 广告运行 是将它设置为 C.UTF-8.

其他 配置

--无自动控制
使用 autodep8 禁用自动测试生成，即使它已安装。 在那里面
情况下，没有测试的包将以代码 8 退出（“此包中没有测试”）
就像没有 autodep8 一样。

--构建并行N
在 平行=N DEB_BUILD_OPTION 用于构建包。 默认情况下，这是
可用处理器的数量。 这在您可以的容器中最有用
限制可用的 RAM，但不限制 CPU 的数量。

-h| - 帮帮我
显示命令行帮助并退出。

虚拟化 服务器

--- 虚拟服务器 虚拟服务器参数...
指定虚拟化机制服务器，作为要调用的命令和参数。
虚拟服务器 必须是现有的 autopkgtest 虚拟化服务器，例如 adt-virt-
施鲁特 or adt-virt-qemu. 你可以省略 adt-virt- 前缀并指定
最后一部分，例如 施鲁特.

之后的所有剩余参数和选项 --- 传递给虚拟化
服务器程序。 有关如何使用它们，请参阅各个服务器的联机帮助页。

OUTPUT FORMAT

在正常测试运行期间，每个测试打印一行。 这包括一个简短的
标识测试的字符串、一些水平空格，以及 PASS or 失败 原因或
SKIP 通过/失败指示被某种水平分隔的原因
空白。

识别测试的字符串由一个简短的字母数字字符串组成 广告-
运行 为了区分不同的命令行参数， 僵硬, 后跟一个连字符和
测试名称。

有时候a SKIP 当测试名称未知或未知时将报告
适用：例如，当包中没有测试时，或者有测试时
包含此版本无法理解的功能的节 广告运行。 在这种情况下 *
将出现在测试名称的位置。

If 广告运行 检测到涉及错误的包，它将打印两行
责备： 被指责的东西... 和 坏包： 的话. 这里每个空格分隔 被指责的东西
是其中一个 参数：论点 （代表在命令行参数中找到的路径名），
数码管：包 （源包名称）， deb：包 （二进制包名称）或其他可能的
要确定的字符串。 这表明哪些参数和/或包可能有
促成了这个问题； 最近处理的那些
因此，最有可能导致问题的原因列在最后。

配置 FILES

如果您使用大量选项或重要的 virt 服务器参数，您可以将任何部分
命令行转换为文本文件，每个选项一行。 例如你可以创建一个文件
配置文件 内容如

-s
--output-dir=/tmp/测试
--apt-升级
---
施鲁特
SID

然后运行

广告运行 foo_1_amd64.changes @sid.cfg

配置文件的内容将就地展开，就像您有
在命令行上给出其内容。 请确保您 别 地方 剩余名额 之间
短选项及其值，它们将成为参数值的一部分。

退出 状态

0 所有测试通过
2 至少跳过了一项测试
4 至少一项测试失败
6 至少一项测试失败，至少一项测试跳过
8 此包中没有测试
12 误包
16 测试台故障
20 其他意外故障，包括使用不当

使用 onworks.net 服务在线使用 adt-run