Amazon IoT Greengrass Version 12023 年 6 月 30 日进入延长寿命阶段。有关更多信息,请参阅Amazon IoT Greengrass V1维护政策。在此日期之后,Amazon IoT Greengrass V1不会发布提供功能、增强功能、错误修复或安全补丁的更新。在上运行的设备Amazon IoT Greengrass V1不会受到干扰,将继续运行并连接到云端。我们强烈建议你迁移到Amazon IoT Greengrass Version 2,它补充说重要的新功能和支持其他平台。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
运行Amazon IoT Greengrass资格套件的先决条件
本节介绍使用Amazon IoT设备测试器 (IDT) 运行Amazon IoT Greengrass资格套件的先决条件。Amazon IoT Greengrass
下载适用于 Amazon IoT Greengrass 的最新版本的 Amazon IoT Device Tester
下载最新版本的 IDT 并将软件解压到文件系统上您具有读写权限的位置。
注意
IDT 不支持由多个用户从共享位置(如 NFS 目录或 Windows 网络共享文件夹)运行。建议您将 IDT 包解压缩到本地驱动器,并在本地工作站上运行 IDT 二进制文件。
Windows 的路径长度限制为 260 个字符。如果您使用的是 Windows,请将 IDT 提取到根目录(如 C:\
或 D:\
)以使路径长度不超过 260 个字符的限制。
创建和配置Amazon Web Services 账户
必须先执行以下步骤Amazon IoT Greengrass,然后才能将 IDT 用于:
-
创建一个Amazon Web Services 账户. 如果已具有了Amazon Web Services 账户,请跳至步骤 2。
这些账户权限允许 IDT 代表您访问Amazon服务和创建Amazon资源,例如Amazon IoT事物、Greengrass 群组和 Lambda 函数。
要创建这些资源,IDT fAmazon IoT Greengrass or 使用config.json
文件中配置的Amazon证书代表您进行 API 调用。这些资源将在测试过程的不同时间进行预置。
注意
尽管大多数测试都符合 Amazon Web Services 免费套餐
第 1 步:创建Amazon Web Services 账户
在此步骤中,创建和配置Amazon Web Services 账户。如果您已经有Amazon Web Services 账户,请跳至步骤 2:为 IDT 配置权限。
注册一个 Amazon Web Services 账户
如果您还没有 Amazon Web Services 账户,请完成以下步骤来创建一个。
注册 Amazon Web Services 账户
按照屏幕上的说明进行操作。
在注册时,您将接到一通电话,要求您使用电话键盘输入一个验证码。
当您注册 Amazon Web Services 账户 时,系统将会创建一个 Amazon Web Services 账户根用户。根用户有权访问该账户中的所有 Amazon Web Services和资源。作为安全最佳实践,请 为管理用户分配管理访问权限,并且只使用根用户执行 需要根用户访问权限的任务。
Amazon注册过程完成后,会向您发送一封确认电子邮件。在任何时候,您都可以通过转至 https://aws.amazon.com/
保护 IAM 用户
注册 Amazon Web Services 账户 后,启用多重身份验证(MFA)保护您的管理用户。有关说明,请参阅 IAM 用户指南中的为 为 IAM 用户(控制台)启用虚拟 MFA 设备。
要授予其他用户访问您的 Amazon Web Services 账户 资源的权限,请创建 IAM 用户。为了保护您的 IAM 用户,请启用 MFA 并仅向 IAM 用户授予执行任务所需的权限。
有关创建和保护 IAM 用户的更多信息,请参阅 IAM 用户指南中的以下主题:
步骤 2:为 IDT 配置权限
在此步骤中,将配置适用于 Amazon IoT Greengrass 的 IDT 运行测试和收集 IDT 使用情况数据所需的权限。您可以使用Amazon Web Services Management Console或Amazon Command Line Interface (Amazon CLI) 为 IDT 创建 IAM 策略和测试用户,然后将策略附加到该用户。如果您已经为 IDT 创建了测试用户,请跳转至 配置设备来运行 IDT 测试 或 可选:为适用于的 IDT 配置 Docker 容器Amazon IoT Greengrass。
为 IDT 配置权限(控制台)
请按照以下步骤使用控制台为适用于 Amazon IoT Greengrass 的 IDT 配置权限。
-
登录 IAM 控制台
。 -
创建客户托管策略,该策略授权创建具有特定权限的角色。
-
在导航窗格中,选择 Policies (策略),然后选择 Create policy (创建策略)。
-
在 JSON 选项卡中,将占位符内容替换为以下策略。
{ "Version": "2012-10-17", "Statement": [ { "Sid": "ManageRolePoliciesForIDTGreengrass", "Effect": "Allow", "Action": [ "iam:DetachRolePolicy", "iam:AttachRolePolicy" ], "Resource": [ "arn:aws:iam::*:role/idt-*", "arn:aws:iam::*:role/GreengrassServiceRole" ], "Condition": { "ArnEquals": { "iam:PolicyARN": [ "arn:aws:iam::aws:policy/service-role/AWSGreengrassResourceAccessRolePolicy", "arn:aws:iam::aws:policy/service-role/GreengrassOTAUpdateArtifactAccess", "arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole" ] } } }, { "Sid": "ManageRolesForIDTGreengrass", "Effect": "Allow", "Action": [ "iam:CreateRole", "iam:DeleteRole", "iam:PassRole", "iam:GetRole" ], "Resource": [ "arn:aws:iam::*:role/idt-*", "arn:aws:iam::*:role/GreengrassServiceRole" ] } ] }
重要
以下策略授权来创建和管理适用于 Amazon IoT Greengrass 的 IDT 所需的角色。这包括附加以下Amazon托管策略的权限:
-
请选择下一步:标签。
-
请选择下一步:审核。
-
对于 Name(名称),请输入
IDTGreengrassIAMPermissions
。在 Summary (摘要) 下,查看策略授予的权限。 -
选择 Create policy(创建策略)。
-
-
创建 IAM 用户并附加到 IDT 所需的权限Amazon IoT Greengrass。
-
创建 IAM 用户。按照 IAM 用户指南中创建 IAM 用户(控制台)中的步骤 1 到 5 进行操作。
-
为您的 IAM 用户附加权限:
-
在 “设置权限” 页面上,选择 “直接附加现有策略”。
-
搜索您在上一步中创建的 IDTGreengrassIAMPermissions 策略。选中复选框。
-
搜索AWSIoTDeviceTesterForGreengrassFullAccess政策。选中复选框。
注意
AWSIoTDeviceTesterForGreengrassFullAccess
是一项Amazon托管策略,用于定义 IDT 创建和访问用于测试的Amazon资源所需的权限。有关更多信息,请参阅AmazonAmazon IoT设备测试器的托管策略:
-
-
请选择下一步:标签。
-
选择 Next: Review (下一步:审核) 以查看您的选择摘要。
-
选择 Create user。
-
要查看用户的访问密钥(访问密钥 ID 和秘密访问密钥),请选择密码和访问密钥旁边的 Show (显示)。要保存访问密钥,请选择Download.csv (下载 .csv),然后将文件保存到安全位置。稍后您将使用此信息来配置您的Amazon证书文件。
-
-
下一步:配置物理设备。
为 IDT 配置权限 (Amazon CLI)
请按照以下步骤使用 Amazon CLI 为适用于 Amazon IoT Greengrass 的 IDT 配置权限。如果您已在控制台中配置权限,请跳转至 配置设备来运行 IDT 测试 或 可选:为适用于的 IDT 配置 Docker 容器Amazon IoT Greengrass。
-
在您的计算机上,安装并配置 Amazon CLI(如果尚未安装)。按照《Amazon Command Line Interface用户指南》中的 “安装”Amazon CLI 中的步骤进行操作。
注意
Amazon CLI是一种开源工具,可用于在命令行 Shell 中使用与Amazon服务进行交互。
-
创建用于授予管理 IDT 和 Amazon IoT Greengrass 角色的权限的客户托管策略。
-
创建 IAM 用户并附加到 IDT 所需的权限Amazon IoT Greengrass。
-
创建 IAM 用户。在此示例设置中,用户被命名为
IDTGreengrassUser
。aws iam create-user --user-name IDTGreengrassUser
-
将您在步骤 2 中创建的
IDTGreengrassIAMPermissions
策略附加到您的 IAM 用户。<account-id>在命令中替换为你的 IDAmazon Web Services 账户。
aws iam attach-user-policy --user-name IDTGreengrassUser --policy-arn arn:aws:iam::
<account-id>
:policy/IDTGreengrassIAMPermissions -
将
AWSIoTDeviceTesterForGreengrassFullAccess
策略附加到您的 IAM 用户。aws iam attach-user-policy --user-name IDTGreengrassUser --policy-arn arn:aws:iam::aws:policy/AWSIoTDeviceTesterForGreengrassFullAccess
注意
AWSIoTDeviceTesterForGreengrassFullAccess
是一项Amazon托管策略,用于定义 IDT 创建和访问用于测试的Amazon资源所需的权限。有关更多信息,请参阅AmazonAmazon IoT设备测试器的托管策略:
-
-
为用户创建私密访问密钥。
aws iam create-access-key --user-name IDTGreengrassUser
将输出存储在安全位置。稍后您将使用此信息来配置您的Amazon证书文件。
-
下一步:配置物理设备。
AmazonAmazon IoT设备测试器的托管策略
AWSIoTDeviceTesterForGreengrassFullAccess
-
iot-device-tester:CheckVersion
。 检查一组Amazon IoT Greengrass、测试套件和 IDT 版本是否兼容。 -
iot-device-tester:DownloadTestSuite
。 下载测试套件。 -
iot-device-tester:LatestIdt
。 获取有关可供下载的最新 IDT 版本的信息。 -
iot-device-tester:SendMetrics
。 发布 IDT 收集的有关您的测试的使用情况数据。 -
iot-device-tester:SupportedVersion
。 获取 IDT 支持的列表Amazon IoT Greengrass和测试套件版本。此信息显示在命令行窗口中。