终止支持通知：2026 年 10 月 7 日， Amazon 将停止对的支持。 Amazon IoT Greengrass Version 1 2026 年 10 月 7 日之后，您将无法再访问这些 Amazon IoT Greengrass V1 资源。如需了解更多信息，请访问[迁移自 Amazon IoT Greengrass Version 1](https://docs.amazonaws.cn/greengrass/v2/developerguide/migrate-from-v1.html)。

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

# 配置设备以运行 IDT 测试
<a name="device-config-setup"></a>

要配置您的设备，您必须安装 Amazon IoT Greengrass 依赖项、配置 Amazon IoT Greengrass Core 软件、配置主机以访问您的设备，并在设备上配置用户权限。

## 验证与被测设备的 Amazon IoT Greengrass 依赖关系
<a name="install-gg-dependencies"></a>

在 IDT f Amazon IoT Greengrass or 测试您的设备之前，请确保您已[按照 Amazon IoT Greengrass入门](https://docs.amazonaws.cn/greengrass/latest/developerguide/gg-gs.html)中所述设置设备。有关支持的平台的信息，请参阅[支持的平台](https://docs.amazonaws.cn/greengrass/latest/developerguide/what-is-gg.html#gg-platforms)。

## 配置 Amazon IoT Greengrass 软件
<a name="config-gg"></a>

IDT 用于 Amazon IoT Greengrass 测试您的设备是否与特定版本的 Amazon IoT Greengrass兼容。IDT 提供了两种 Amazon IoT Greengrass 在您的设备上进行测试的选项：
+ 下载并使用某一版本的 [Amazon IoT Greengrass 核心软件](what-is-gg.md#gg-core-download-tab)。IDT 为您安装此软件。
+ 使用设备上已安装的 Amazon IoT Greengrass Core 软件版本。

**注意**  
的 Amazon IoT Greengrass 每个版本都有相应的 IDT 版本。您必须下载与 Amazon IoT Greengrass 您正在使用的版本相对应的 IDT 版本。

以下各节介绍了这些选项。您只需要使用其中一个选项。

### 选项 1：下载 Amazon IoT Greengrass 核心软件并配置 Amazon IoT 设备测试器以使用它
<a name="download-gg"></a>

您可以从 Amazon IoT Greengrass 核心软件下载页面下载[Amazon IoT Greengrass 核心软件](what-is-gg.md#gg-core-download-tab)。

1. 找到正确的架构和 Linux 发行版，然后选择 **Download (下载)**。

1. 将该 tar.gz 文件复制到 `<device-tester-extract-location>/products/greengrass/ggc`。

**注意**  
请勿更改 Amazon IoT Greengrass tar.gz 文件的名称。对于相同的操作系统和架构，请勿在此目录中放置多个文件。例如，在该目录中同时放置 `greengrass-linux-armv7l-1.7.1.tar.gz` 和 `greengrass-linux-armv7l-1.8.1.tar.gz` 文件将导致测试失败。

### 选项 2：将现有安装的 Amazon IoT Greengrass 与 Amazon IoT 设备测试器一起使用
<a name="existing-gg"></a>

通过向`<device-tester-extract-location>/configs`文件夹中的`device.json`文件添加`greengrassLocation`属性，配置 IDT 以测试设备上安装的 C Amazon IoT Greengrass ore 软件。例如：

```
"greengrassLocation" : "<path-to-greengrass-on-device>"
```

有关 `device.json` 文件的更多信息，请参阅[配置 device.json](set-config.md#device-config)。

在 Linux 设备上， Amazon IoT Greengrass 核心软件的默认位置是`/greengrass`。

**注意**  
您的设备应该安装了尚未启动的 Amazon IoT Greengrass Core 软件。  
确保您已在设备上添加 `ggc_user` 用户和 `ggc_group`。有关更多信息，请参阅 [Amazon IoT Greengrass的环境设置](https://docs.amazonaws.cn/greengrass/latest/developerguide/module1.html)。

## 配置主机以访问被测设备
<a name="configure-host"></a>

IDT 在主机上运行，并且必须能够使用 SSH 连接到您的设备。有两个选项允许 IDT 获得对被测设备的 SSH 访问权限：

1. 按照此处的说明创建一个 SSH 密钥对并授权您的密钥，以便登录被测设备而无需指定密码。

1. 在 `device.json` 文件中为每个设备提供用户名和密码。有关更多信息，请参阅 [配置 device.json](set-config.md#device-config)。

您可以使用任何 SSL 实现创建 SSH 密钥。以下说明向你展示了如何使用 [SSH-KEYGEN](https://www.ssh.com/ssh/keygen/) 或 [Pu TTYgen](https://www.ssh.com/ssh/putty/windows/puttygen)（适用于 Windows）。如果您使用的是另一个 SSL 实现，请参阅该实现的文档。

IDT 使用 SSH 密钥对被测设备进行身份验证。

**使用 SSH-KEYGEN 创建 SSH 密钥**

1. 创建 SSH 密钥。

   您可以使用 Open SSH **ssh-keygen** 命令创建 SSH 密钥对。如果您的主机上已有一个 SSH 密钥对，则最佳做法是专门为 IDT 创建一个 SSH 密钥对。这样，完成测试后，如果没有输入密码，主机将无法再连接到设备。它还使您能够仅向需要访问远程设备的人员授予访问权限。
**注意**  
Windows 没有安装 SSH 客户端。有关在 Windows 上安装 SSH 客户端的信息，请参阅[下载 SSH 客户端软件](https://www.ssh.com/ssh/#sec-Download-client-software)。

   **ssh-keygen** 命令会提示您输入要存储密钥对的名称和路径。默认情况下，密钥对文件的名称为 `id_rsa`（私有密钥）和 `id_rsa.pub`（公有密钥）。在 macOS 和 Linux 上，这些文件的默认位置为 `~/.ssh/`。在 Windows 上，默认位置为 `C:\Users\<user-name>\.ssh`。

   根据提示，输入密钥短语来保护您的 SSH 密钥。有关更多信息，请参阅[生成新的 SSH 密钥](https://www.ssh.com/ssh/keygen/)。

1. 向被测设备添加经过授权的 SSH 密钥。

   IDT 必须使用您的 SSH 私有密钥登录被测设备。要授权 SSH 私有密钥以登录被测设备，请在主机上使用 **ssh-copy-id** 命令。此命令会将您的公有密钥添加到被测设备上的 `~/.ssh/authorized_keys` 文件中。例如：

   **\$1 ssh-copy-id *<remote-ssh-user>*@*<remote-device-ip>***

   哪里*remote-ssh-user*是用于登录被测设备的用户名，以及*remote-device-ip*用于运行测试的被测设备的 IP 地址。例如：

   **ssh-copy-id pi@192.168.1.5**

   系统提示时，输入在 **ssh-copy-id** 命令中指定的用户名所对应的密码。

   **ssh-copy-id** 公有密钥的名称为 `id_rsa.pub` 并且存储在默认位置（macOS 和 Linux 上的位置为 `~/.ssh/`，Windows 上的位置为 `C:\Users\<user-name>\.ssh`）。如果公有密钥采用其他名称或存储在其他位置，则必须使用 **-i** 选项与 **ssh-copy-id** 指定 SSH 公有密钥的完全限定路径（例如，**ssh-copy-id -i \$1/my/path/myKey.pub**）。有关创建 SSH 密钥和复制公有密钥的更多信息，请参阅 [SSH-COPY-ID](https://www.ssh.com/ssh/copy-id)。

**使用 Pu 创建 SSH 密钥TTYgen （仅限 Windows）**

1. 确保您在被测设备上安装了 OpenSSH 服务器和客户端。有关更多信息，请参阅 [OpenSSH](https://www.openssh.com/)。

1. 在被测设备TTYgen上安装 [Pu](https://www.puttygen.com/)。

1. 打开 Pu TTYgen。

1. 选择 **Generate (生成)**，然后在框中移动鼠标光标以生成私有密钥。

1. 从 **Conversions (转换)** 菜单中，选择 **Export OpenSSH key (导出 OpenSSH 密钥)**，然后使用 `.pem` 文件扩展名保存私有密钥 。

1. 将公有密钥添加到被测设备上的 `/home/<user>/.ssh/authorized_keys` 文件中。

   1. 从 Pu TTYgen 窗口复制公钥文本。

   1. 使用 PuTTY 在被测设备上创建会话。

      1. 从命令提示符或 Windows Powershell 窗口中，运行以下命令：

         **C:/*<path-to-putty>*/putty.exe -ssh *<user>*@*<dut-ip-address>***

      1. 在系统提示时，输入您的设备密码。

      1. 使用 vi 或其他文本编辑器将公有密钥附加到被测设备上的 `/home/<user>/.ssh/authorized_keys` 文件中。

1. 使用您的用户名、IP 地址以及您刚刚为每个被测设备保存在主机上的私钥文件的路径更新 `device.json` 文件。有关更多信息，请参阅 [配置 device.json](set-config.md#device-config)。确保提供私有密钥的完整路径和文件名，并使用正斜杠（“/”）。例如，对于 Windows 路径 `C:\DT\privatekey.pem`，请在 `device.json` 文件中使用 `C:/DT/privatekey.pem`。

## 在您的设备上配置用户权限
<a name="root-access"></a>

IDT 将对被测设备中的各种目录和文件执行操作。其中一些操作需要升级权限（使用 **sudo**）。要自动执行这些操作，IDT fo Amazon IoT Greengrass r 必须能够在不被提示输入密码的情况下使用 sudo 运行命令。

请在被测设备上执行以下步骤，以允许在不提示输入密码的情况下进行 sudo 访问。

**注意**  
`username` 是指 IDT 用来访问被测设备的 SSH 用户。

**将用户添加到 sudo 组**

1. 在被测设备上，运行 `sudo usermod -aG sudo <username>`。

1. 注销，然后重新登录，以使变更生效。

1. 要验证您的用户名是否已成功添加，请运行 **sudo echo test**。如果系统未提示您输入密码，则说明已正确配置您的用户。

1. 打开 `/etc/sudoers` 文件，并将以下行添加到文件末尾：

   `<ssh-username> ALL=(ALL) NOPASSWD: ALL`

## 配置设备以测试可选功能
<a name="optional-feature-config"></a>

以下主题介绍如何配置设备以针对可选功能运行 IDT 测试。请仅在要测试这些功能时才执行以下配置步骤。否则，请继续查看 [配置 IDT 设置以运行 Amazon IoT Greengrass 资格套件](set-config.md)。

**Topics**
+ [验证与被测设备的 Amazon IoT Greengrass 依赖关系](#install-gg-dependencies)
+ [配置 Amazon IoT Greengrass 软件](#config-gg)
+ [配置主机以访问被测设备](#configure-host)
+ [在您的设备上配置用户权限](#root-access)
+ [配置设备以测试可选功能](#optional-feature-config)
+ [可选：为 IDT 配置你的 Docker 容器 Amazon IoT Greengrass](docker-config-setup.md)
+ [可选：配置设备进行 ML 资格认证](idt-ml-qualification.md)