支援終止通知：2026 年 10 月 7 日 AWS 將停止 的支援 AWS IoT Greengrass Version 1。2026 年 10 月 7 日之後，您將無法再存取 AWS IoT Greengrass V1 資源。如需詳細資訊，請造訪[從 遷移 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定您的裝置以執行 IDT 測試
<a name="device-config-setup"></a>

若要設定您的裝置，您必須安裝 AWS IoT Greengrass 相依性、設定 AWS IoT Greengrass Core 軟體、設定主機電腦以存取您的裝置，以及在裝置上設定使用者許可。

## 驗證待測裝置的 AWS IoT Greengrass 相依性
<a name="install-gg-dependencies"></a>

在 IDT for AWS IoT Greengrass 可以測試您的裝置之前，請確定您已如 [入門 AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-gs.html)中所述設定您的裝置。如需受支援平台的相關資訊，請參閱[支援的平台](https://docs.aws.amazon.com/greengrass/latest/developerguide/what-is-gg.html#gg-platforms)。

## 設定 AWS IoT Greengrass 軟體
<a name="config-gg"></a>

IDT for 會 AWS IoT Greengrass 測試您的裝置與特定 版本的相容性 AWS IoT Greengrass。IDT 提供兩種 AWS IoT Greengrass 在裝置上進行測試的選項：
+ 下載並使用某個版本的 [AWS IoT Greengrass Core 軟體](what-is-gg.md#gg-core-download-tab)。IDT 會為您安裝此軟體。
+ 使用您裝置上已安裝的 AWS IoT Greengrass Core 軟體版本。

**注意**  
的每個 版本 AWS IoT Greengrass 都有對應的 IDT 版本。您必須下載對應 AWS IoT Greengrass 至您正在使用之 版本的 IDT 版本。

下列各節描述這些選項。您只需要執行一個選項。

### 選項 1：下載 AWS IoT Greengrass Core 軟體並設定 AWS IoT Device Tester 使用它
<a name="download-gg"></a>

您可以從 AWS IoT Greengrass 核心軟體下載頁面下載[AWS IoT Greengrass 核心軟體](what-is-gg.md#gg-core-download-tab)。

1. 尋找正確的架構和 Linux 發行版本，然後選擇 **Download (下載)**。

1. 將 tar.gz 檔案複製到 `{{<device-tester-extract-location>}}/products/greengrass/ggc`。

**注意**  
請勿變更 AWS IoT Greengrass tar.gz 檔案的名稱。請勿將相同作業系統和架構的多個檔案放在這個目錄中。例如，將 `greengrass-linux-armv7l-1.7.1.tar.gz` 和 `greengrass-linux-armv7l-1.8.1.tar.gz` 檔案放在該目錄中將導致測試失敗。

### 選項 2： AWS IoT Greengrass 搭配 AWS IoT Device Tester 使用 的現有安裝
<a name="existing-gg"></a>

設定 IDT 將 `greengrassLocation` 屬性新增至 `{{<device-tester-extract-location>}}/configs` 資料夾中`device.json`的 檔案，以測試安裝在您裝置上的 AWS IoT Greengrass Core 軟體。例如：

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

如需 `device.json` 詳細資訊，請參閱 [設定 device.json](set-config.md#device-config)。

在 Linux 裝置上， AWS IoT Greengrass 核心軟體的預設位置為 `/greengrass`。

**注意**  
您的裝置應安裝尚未啟動的 AWS IoT Greengrass Core 軟體。  
請確定您已在裝置上新增 `ggc_user` 使用者和 `ggc_group`。如需詳細資訊，請參閱 [AWS IoT Greengrass的環境設定](https://docs.aws.amazon.com/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/) 或 [ PuTTYgen](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-copy-id** 命令，授權您的 SSH 私有金鑰登入待測裝置。此命令會將您的公有金鑰新增至待測裝置上的 `~/.ssh/authorized_keys` 檔案。例如：

   **$ 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}}`)。如果您給公有金鑰不同的名稱，或將其存放在不同的位置中，則必須在 **ssh-copy-id** 中使用 **-i** 選項，以指定 SSH 公有金鑰的完整路徑 (例如，**ssh-copy-id -i \~/my/path/myKey.pub**)。如需有關建立 SSH 金鑰和複製公有金鑰的詳細資訊，請參閱 [SSH-COPY-ID](https://www.ssh.com/ssh/copy-id)。

**使用 PuTTYgen 建立 SSH 金鑰 (僅限 Windows)**

1. 確定您的待測裝置上已安裝 OpenSSH 伺服器和用戶端。如需詳細資訊，請參閱 [OpenSSH](https://www.openssh.com/)。

1. 在您的待測裝置上安裝 [PuTTYgen](https://www.puttygen.com/)。

1. 開啟 PuTTYgen。

1. 選擇 **Generate (產生)**，並將滑鼠游標移到方塊內以產生私有金鑰。

1. 從 **Conversions (轉換)** 功能表中，選擇 **Export OpenSSH key (匯出 OpenSSH 金鑰)**，然後以 `.pem` 副檔名儲存私有金鑰。

1. 將公有金鑰新增至待測裝置上的 `/home/{{<user>}}/.ssh/authorized_keys` 檔案。

   1. 從 PuTTYgen 視窗複製公有金鑰文字。

   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 for AWS IoT Greengrass 必須能夠使用 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 AWS IoT Greengrass 設定以執行資格套件](set-config.md)。

**Topics**
+ [驗證待測裝置的 AWS IoT Greengrass 相依性](#install-gg-dependencies)
+ [設定 AWS IoT Greengrass 軟體](#config-gg)
+ [設定主機電腦以存取待測裝置](#configure-host)
+ [在您的裝置上設定使用者許可](#root-access)
+ [設定您的裝置以測試選用功能](#optional-feature-config)
+ [選用：設定 IDT for 的 Docker 容器 AWS IoT Greengrass](docker-config-setup.md)
+ [選用：設定您的裝置以取得 ML 資格](idt-ml-qualification.md)