运行 IDT 测试的先决条件 - AWS IoT Greengrass
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

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

运行 IDT 测试的先决条件

本节介绍使用适用于 AWS IoT Greengrass 的 AWS IoT Device Tester (IDT) 需满足的先决条件。

下载适用于 AWS IoT Greengrass 的最新版本的 AWS IoT Device Tester

适用于 AWS IoT Greengrass 的 AWS IoT Device Tester 的受支持版本 下载最新版本的 IDT。将软件提取到文件系统中您具有读取和写入权限的位置。

注意

IDT 不支持由多个用户从共享位置(如 NFS 目录或 Windows 网络共享文件夹)运行。因为这样做可能会导致崩溃或数据损坏。建议您将 IDT 包解压缩到本地驱动器,并在本地工作站上运行 IDT 二进制文件。

Windows 的路径长度限制为 260 个字符。如果您使用的是 Windows,请将 IDT 提取到根目录(如 C:\ D:\)以使路径长度不超过 260 个字符的限制。

创建和配置 AWS 账户

您必须创建 AWS 账户并配置 IDT 在运行测试时所需的权限,然后才能使用适用于 AWS IoT Greengrass 的 IDT。这些权限允许 IDT 代表您访问 AWS 服务和创建 AWS 资源,例如 AWS IoT 事物、Greengrass 组和 Lambda 函数。

为了创建这些资源,适用于 AWS IoT Greengrass 的 IDT 使用在 config.json 文件中配置的 AWS 凭证来代表您发出 API 调用。这些资源将在测试过程的不同时间进行预置。

注意

尽管大多数测试都符合 AWS 免费套餐的要求,但您在注册 AWS 账户时必须提供信用卡。有关更多信息,请参阅我的账户使用的是免费套餐,为什么还需要提供付款方式?

步骤 1:创建 AWS 账户

在此步骤中,将创建并配置 AWS 账户。如果您已有 AWS 账户,请跳到步骤 2:为 IDT 配置权限

  1. 打开 AWS 主页,然后选择 Create an AWS Account (创建 AWS 账户)

    注意

    如果您最近已登录到 AWS,则您可能会看到 Sign In to the Console (登录控制台)

  2. 按照在线说明操作。注册过程包括注册信用卡、接收短信或电话以及输入 PIN。

    有关更多信息,请参阅如何创建并激活新的 Amazon Web Services 账户?

步骤 2:为 IDT 配置权限

在此步骤中,将配置适用于 AWS IoT Greengrass 的 IDT 运行测试和收集 IDT 使用情况数据所需的权限。您可以使用 AWS 管理控制台 或 AWS Command Line Interface (AWS CLI) 为 IDT 创建 IAM 策略和测试用户,然后将策略附加到用户。如果您已经为 IDT 创建了测试用户,请跳转至 配置设备可选: 为为IDT配置Docker容器 AWS IoT Greengrass

为 IDT 配置权限(控制台)

请按照以下步骤使用控制台为适用于 AWS IoT Greengrass 的 IDT 配置权限。

  1. 登录 IAM 控制台

  2. 创建客户托管策略,该策略授权创建具有特定权限的角色。

    1. 在导航窗格中,选择策略,然后选择创建策略

    2. JSON 选项卡中,将占位符内容替换为以下策略。

      { "Version": "2012-10-17", "Statement": [ { "Sid": "ManageRolePoliciesForIDTGreengrass", "Effect": "Allow", "Action": [ "iam:DetachRolePolicy", "iam:AttachRolePolicy" ], "Resource": [ "arn:aws-cn:iam::*:role/idt-*", "arn:aws-cn:iam::*:role/GreengrassServiceRole" ], "Condition": { "ArnEquals": { "iam:PolicyARN": [ "arn:aws-cn:iam::aws:policy/service-role/AWSGreengrassResourceAccessRolePolicy", "arn:aws-cn:iam::aws:policy/service-role/GreengrassOTAUpdateArtifactAccess", "arn:aws-cn:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole" ] } } }, { "Sid": "ManageRolesForIDTGreengrass", "Effect": "Allow", "Action": [ "iam:CreateRole", "iam:DeleteRole", "iam:PassRole", "iam:GetRole" ], "Resource": [ "arn:aws-cn:iam::*:role/idt-*", "arn:aws-cn:iam::*:role/GreengrassServiceRole" ] } ] }
      重要

      以下策略授权来创建和管理适用于 AWS IoT Greengrass 的 IDT 所需的角色。这包括附加以下 AWS 托管策略的权限:

    3. 选择查看策略

    4. 对于 Name (名称),请输入 IDTGreengrassIAMPermissions。在 Summary (摘要) 下,查看策略授予的权限。

    5. 选择 Create policy

  3. 创建 IAM 用户并附加适用于 AWS IoT Greengrass 的 IDT 所需的权限。

    1. 创建 IAM 用户.按照 IAM 用户指南创建 IAM 用户(控制台)的步骤 1 到 5 操作。

    2. 将权限附加到您的 IAM 用户:

      1. Set permissions (设置权限) 页面上,选择 Attach existing policies to user directly (直接附加现有策略到用户)

      2. 搜索您在上一步中创建的 IDTGreengrassIAMPermissions 策略。选中复选框。

      3. 搜索 AWSIoTDeviceTesterForGreengrassFullAccess 策略。选中复选框。

        注意

        AWSIoTDeviceTesterForGreengrassFullAccess 是AWS管理策略,它定义了IDT创建和访问用于测试的AWS资源所需的权限。有关更多信息,请参阅适用于 AWS IoT Device Tester 的 AWS 托管策略

    3. 选择下一步: 标签

    4. 选择 Next: Review (下一步:审核) 以查看您的选择摘要。

    5. 选择 Create user

    6. 要查看用户的访问密钥(访问密钥 ID 和秘密访问密钥),请选择密码和访问密钥旁边的 Show (显示)。要保存访问密钥,请选择Download.csv (下载 .csv),然后将文件保存到安全位置。稍后您可以使用此信息配置 AWS 凭证文件。

  4. 下一步: 配置您的 物理设备.

 

为 IDT 配置权限 (AWS CLI)

请按照以下步骤使用 AWS CLI 为适用于 AWS IoT Greengrass 的 IDT 配置权限。如果您已在控制台中配置权限,请跳转至 配置设备可选: 为为IDT配置Docker容器 AWS IoT Greengrass

  1. 在您的计算机上,安装并配置 AWS CLI(如果尚未安装)。按照 AWS Command Line Interface 用户指南 中的安装 AWS CLI 中所述的步骤进行操作。

    注意

    AWS CLI 是一个开源工具,您可以使用此工具通过命令行 Shell 与 AWS 服务进行交互。

  2. 创建用于授予管理 IDT 和 AWS IoT Greengrass 角色的权限的客户托管策略。

    Linux, macOS, or Unix
    aws iam create-policy --policy-name IDTGreengrassIAMPermissions --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Sid": "ManageRolePoliciesForIDTGreengrass", "Effect": "Allow", "Action": [ "iam:DetachRolePolicy", "iam:AttachRolePolicy" ], "Resource": [ "arn:aws-cn:iam::*:role/idt-*", "arn:aws-cn:iam::*:role/GreengrassServiceRole" ], "Condition": { "ArnEquals": { "iam:PolicyARN": [ "arn:aws-cn:iam::aws:policy/service-role/AWSGreengrassResourceAccessRolePolicy", "arn:aws-cn:iam::aws:policy/service-role/GreengrassOTAUpdateArtifactAccess", "arn:aws-cn:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole" ] } } }, { "Sid": "ManageRolesForIDTGreengrass", "Effect": "Allow", "Action": [ "iam:CreateRole", "iam:DeleteRole", "iam:PassRole", "iam:GetRole" ], "Resource": [ "arn:aws-cn:iam::*:role/idt-*", "arn:aws-cn:iam::*:role/GreengrassServiceRole" ] } ] }'
    Windows command prompt
    aws iam create-policy --policy-name IDTGreengrassIAMPermissions --policy-document '{\"Version\": \"2012-10-17\", \"Statement\": [{\"Sid\": \"ManageRolePoliciesForIDTGreengrass\",\"Effect\": \"Allow\",\"Action\": [\"iam:DetachRolePolicy\", \"iam:AttachRolePolicy\"], \"Resource\": [\"arn:aws-cn:iam::*:role/idt-*\",\"arn:aws-cn:iam::*:role/GreengrassServiceRole\"],\"Condition\": {\"ArnEquals\": {\"iam:PolicyARN\": [\"arn:aws-cn:iam::aws:policy/service-role/AWSGreengrassResourceAccessRolePolicy\",\"arn:aws-cn:iam::aws:policy/service-role/GreengrassOTAUpdateArtifactAccess\",\"arn:aws-cn:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole\"]}}},{\"Sid\": \"ManageRolesForIDTGreengrass\",\"Effect\": \"Allow\",\"Action\": [\"iam:CreateRole\",\"iam:DeleteRole\", \"iam:PassRole\", \"iam:GetRole\"],\"Resource\": [\"arn:aws-cn:iam::*:role/idt-*\",\"arn:aws-cn:iam::*:role/GreengrassServiceRole\"]}]}'
    注意

    此步骤包含一个 Windows 命令提示符示例,因为它使用的 JSON 语法与 Linux、macOS 或 Unix 终端命令不同。

  3. 创建 IAM 用户并附加适用于 AWS IoT Greengrass 的 IDT 所需的权限。

    1. 创建 IAM 用户.在此示例设置中,用户被命名为 IDTGreengrassUser

      aws iam create-user --user-name IDTGreengrassUser
    2. 将您在步骤 2 中创建的 IDTGreengrassIAMPermissions 策略附加到您的 IAM 用户。将命令中的 <account-id> 替换为您的 AWS 账户 ID。

      aws iam attach-user-policy --user-name IDTGreengrassUser --policy-arn arn:aws-cn:iam::<account-id>:policy/IDTGreengrassIAMPermissions
    3. AWSIoTDeviceTesterForGreengrassFullAccess 策略附加到您的 IAM 用户。

      aws iam attach-user-policy --user-name IDTGreengrassUser --policy-arn arn:aws-cn:iam::aws:policy/AWSIoTDeviceTesterForGreengrassFullAccess
      注意

      AWSIoTDeviceTesterForGreengrassFullAccess 是AWS管理策略,它定义了IDT创建和访问用于测试的AWS资源所需的权限。有关更多信息,请参阅适用于 AWS IoT Device Tester 的 AWS 托管策略

  4. 为用户创建私密访问密钥。

    aws iam create-access-key --user-name IDTGreengrassUser

    将输出存储在安全位置。稍后您可以使用此信息配置 AWS 凭证文件。

  5. 下一步: 配置您的 物理设备.

适用于 AWS IoT Device Tester 的 AWS 托管策略

AWSIoTDeviceTesterForGreengrassFullAccess 托管策略允许 IDT 运行操作并收集使用情况指标。此策略授予以下 IDT 权限:

  • iot-device-tester:CheckVersion。检查一组 AWS IoT Greengrass、测试套件和 IDT 版本是否兼容。

  • iot-device-tester:DownloadTestSuite。下载测试套件。

  • iot-device-tester:LatestIdt。获取有关可供下载的最新 IDT 版本的信息。

  • iot-device-tester:SendMetrics。发布 IDT 收集的有关测试的使用情况数据。

  • iot-device-tester:SupportedVersion。获取 IDT 支持的 AWS IoT Greengrass 和测试套件版本的列表。此信息显示在命令行窗口中。