Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

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

为测试运行者配置设置

要运行自定义测试套件，测试运行者必须根据他们想要运行的测试套件配置其设置。设置是根据位于<device-tester-extract-location>/configs/folder。如果需要，测试跑步者还必须设置AmazonIDT 将用来连接到Amazon云。

作为测试作者，您需要将这些文件配置为调试测试套件. 您必须向测试运行者提供说明，以便他们可以根据需要配置以下设置来运行测试套件。

配置 device.json

这些区域有：device.json文件包含有关运行测试的设备的信息（例如，IP 地址、操作系统和 CPU 体系结构）。

测试运行者可以使用以下模板提供此信息：device.json位于中的文件<device-tester-extract-location>/configs/folder。

[
    {
        "id": "<pool-id>",
        "sku": "<pool-sku>",
        "features": [
            {
                "name": "<feature-name>",             
                "value": "<feature-value>",                
                "configs": [
                    {
                        "name": "<config-name>",                    
                        "value": "<config-value>"
                    }
                ],
            }
        ],     
        "devices": [
            {
                "id": "<device-id>",              
                "connectivity": {
                    "protocol": "ssh | uart | docker",                   
                    // ssh
                    "ip": "<ip-address>",
                    "port": <port-number>,
                    "auth": {
                        "method": "pki | password",
                        "credentials": {
                            "user": "<user-name>", 
                            // pki
                            "privKeyPath": "/path/to/private/key",
                                         
                            // password
                            "password": "<password>",
                        }
                    },
                    
                    // uart
                    "serialPort": "<serial-port>",
                    
                    // docker
                    "containerId": "<container-id>",
                    "containerUser": "<container-user-name>",
                }
            }
        ]
    }
]

包含值的所有字段都为必填字段，如下所述：

（可选）配置 userdata.json

这些区域有：userdata.json文件包含测试套件所需但未在device.json文件。此文件的格式取决于userdata_scheme.json文件测试套件中定义。如果您是测试作者，请确保向将运行您编写的测试套件的用户提供此信息。

（可选）配置资源 .json

这些区域有：resource.json文件包含有关将用作资源设备的任何设备的信息。资源设备是测试受测设备的某些功能所需的设备。例如，要测试设备的蓝牙功能，可以使用资源设备来测试设备是否可以成功连接到它。资源设备是可选的，您可以根据需要多个资源设备。作为测试作家，你使用test.json 文件以定义测试所需的资源设备功能。然后测试跑步者使用resource.json文件以提供具有所需功能的资源设备池。确保向将运行您编写的测试套件的用户提供此信息。

测试运行者可以使用以下模板提供此信息：resource.json位于中的文件<device-tester-extract-location>/configs/folder。

[
    {
        "id": "<pool-id>",
        "features": [
            {
                "name": "<feature-name>",             
                "version": "<feature-value>",                
                "jobSlots": <job-slots>
            }
        ],     
        "devices": [
            {
                "id": "<device-id>",              
                "connectivity": {
                    "protocol": "ssh | uart | docker",                   
                    // ssh
                    "ip": "<ip-address>",
                    "port": <port-number>,
                    "auth": {
                        "method": "pki | password",
                        "credentials": {
                            "user": "<user-name>", 
                            // pki
                            "privKeyPath": "/path/to/private/key",
                                         
                            // password
                            "password": "<password>",
                        }
                    },
                    
                    // uart
                    "serialPort": "<serial-port>",
                    
                    // docker
                    "containerId": "<container-id>",
                    "containerUser": "<container-user-name>",
                }
            }
        ]
    }
]

包含值的所有字段都为必填字段，如下所述：

（可选）配置 config.json

这些区域有：config.json文件包含 IDT 的配置信息。通常，测试运行者不需要修改此文件，除了提供他们的AmazonIDT 的用户凭据，也可以选择Amazon地区。如果Amazon提供了具有所需权限的凭据Amazon IoT Device Tester收集使用量指标并将其提交到Amazon. 这是一种可选功能，用于改进 IDT 功能。有关更多信息，请参阅 IDT 使用情况指标。

测试跑步者可以配置他们的Amazon通过以下方法之一采用凭证：

配置AmazonIDT 凭证，测试运行者编辑auth部分中config.json位于中的文件<device-tester-extract-location>/configs/folder。

{
    "log": {
        "location": "logs"
    },
    "configFiles": {
        "root": "configs",
        "device": "configs/device.json"
    },
    "testPath": "tests",
    "reportPath": "results",
    "awsRegion": "<region>",
    "auth": {
        "method": "file | environment",
        "credentials": {
            "profile": "<profile-name>"
        }
    }
}
]

包含值的所有字段都为必填字段，如下所述：