运行 Amazon IoT Greengrass 资格认证套件 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

运行 Amazon IoT Greengrass 资格认证套件

设置所需的配置后,就可以开始测试了。完整测试套件的运行时取决于您的硬件。作为参考,在 Raspberry Pi 3B 上完成完整的测试套件大约需要 30 分钟。

使用以下 run-suite 命令运行一系列测试。

devicetester_[linux | mac | win]_x86-64 run-suite \\ --suite-id suite-id \\ --group-id group-id \\ --pool-id your-device-pool \\ --test-id test-id \\ --update-idt y|n \\ --userdata userdata.json

所有选项均为可选。例如,如果您只有一个设备池(即 device.json 文件中定义的一组相同设备),则可以忽略 pool-id。或者,如果您要在 tests 文件夹中运行最新的测试套件版本,则可以忽略 suite-id

注意

如果在线提供了更新的测试套件版本,IDT 会提示您。有关更多信息,请参阅测试套件版本

用于运行资格认证套件的示例命令

以下命令行示例介绍如何针对某个设备池运行资格认证测试。有关 run-suite 和其他 IDT 命令的更多信息,请参阅 适用于 Amazon IoT Greengrass V2 的 IDT 命令

使用以下命令在指定的测试套件中运行所有测试组。list-suites 命令可列出 tests 文件夹中的测试套件。

devicetester_[linux | mac | win]_x86-64 run-suite \ --suite-id GGV2Q_1.0.0 \ --pool-id <pool-id> \ --userdata userdata.json

使用以下命令运行测试套件中的特定测试组。list-groups 命令可列出测试套件中的测试组。

devicetester_[linux | mac | win]_x86-64 run-suite \ --suite-id GGV2Q_1.0.0 \ --group-id <group-id> \ --pool-id <pool-id> \ --userdata userdata.json

使用以下命令运行测试组中的特定测试案例。

devicetester_[linux | mac | win]_x86-64 run-suite \ --group-id <group-id> \ --test-id <test-id> \ --userdata userdata.json

使用以下命令运行测试组中的多个测试案例。

devicetester_[linux | mac | win]_x86-64 run-suite \ --group-id <group-id> \ --test-id <test-id1>,<test-id2> --userdata userdata.json

使用以下命令列出测试组中的所有测试案例。

devicetester_[linux | mac | win]_x86-64 list-test-cases --group-id <group-id>

建议您运行完整的资格认证测试套件,该套件会按正确的顺序运行测试组依赖关系。如果您选择运行特定测试组,建议您先运行依赖关系检查程序测试组,以确保在运行相关测试组之前已安装所有 Greengrass 依赖关系。例如:

  • 在运行核心资格测试组之前运行 coredependencies

适用于 Amazon IoT Greengrass V2 的 IDT 命令

IDT 命令位于 <device-tester-extract-location>/bin 目录中。要运行测试套件,请按以下格式提供命令:

help

列出有关指定命令的信息。

list-groups

列出给定测试套件中的组。

list-suites

列出可用的测试套件。

list-supported-products

列出受支持的产品(在本例中为 Amazon IoT Greengrass 版本)和当前 IDT 版本的测试套件版本。

list-test-cases

列出给定测试组中的测试用例。支持以下选项:

  • group-id. 要搜索的测试组。此选项是必需的,必须指定单个组。

run-suite

对某个设备池运行一组测试。以下是一些受支持的选项:

  • suite-id. 要运行的测试套件版本。如果未指定,IDT 将使用 tests 文件夹中的最新版本。

  • group-id. 要以逗号分隔的列表形式运行的测试组。如果未指定,IDT 将运行测试套件中的所有相应测试组,具体取决于 device.json 中已配置的设置。IDT 不会根据您配置的设置运行设备不支持的任何测试组,即使这些测试组是在 group-id 列表中指定的。

  • test-id. 要以逗号分隔的列表形式运行的测试用例。指定后,group-id 必须指定单个组。

  • pool-id. 要测试的设备池。如果您在 device.json 文件中定义了多个设备池,则必须指定一个池。

  • stop-on-first-failure。将 IDT 配置为在第一次失败时停止运行。当您想要调试指定的测试组时,请将此选项与 group-id 配合使用。在运行完整测试套件以生成资格认证报告时,请勿使用此选项。

  • update-idt。为更新 IDT 的提示设置响应。如果 IDT 检测到有更新的版本,则 Y 响应将停止执行测试。N 响应会继续执行测试。

  • userdata。包含有关测试构件路径的信息的 userdata.json 文件的完整路径。此选项是 run-suite 命令所必需的。userdata.json 文件必须位于 devicetester_extract_location/devicetester_ggv2_[win|mac|linux]/configs/ 目录中。

有关 run-suite 选项的更多信息,请使用 help 选项:

devicetester_[linux | mac | win]_x86-64 run-suite -h