配置设备以运行 IDT 测试

• 默认 Greengrass 用户 ()。ggc_user

• 您用来连接到被测设备的用户。您可以在device.json文件中配置此用户。

您必须满足以下要求才能允许 IDT 使用您的自定义 IAM 角色。我们强烈建议您仅向该角色添加最低要求的策略操作。

• 必须更新 userdata.json 配置文件才能将参数设置为。GreengrassV2TokenExchangeRole true

• 必须使用以下最低信任策略配置自定义 IAM 角色：

  {
     "Version":"2012-10-17",
     "Statement":[
        {
           "Effect":"Allow",
           "Principal":{
              "Service":[
                 "credentials.iot.amazonaws.com",
                 "lambda.amazonaws.com", 
                 "sagemaker.amazonaws.com" 
              ]
           },
           "Action":"sts:AssumeRole"
        }
     ]
  }

• 必须使用以下最低权限策略配置自定义 IAM 角色：

  {
     "Version":"2012-10-17",
     "Statement":[
        {
           "Effect":"Allow",
           "Action":[
              "iot:DescribeCertificate",
              "logs:CreateLogGroup",
              "logs:CreateLogStream",
              "logs:PutLogEvents",
              "logs:DescribeLogStreams",
              "iot:Connect",
              "iot:Publish",
              "iot:Subscribe",
              "iot:Receive",
              "iot:ListThingPrincipals", 
              "iot:GetThingShadow",
              "iot:UpdateThingShadow",
              "s3:GetBucketLocation",
              "s3:GetObject",
              "s3:PutObject",
              "s3:AbortMultipartUpload",
              "s3:ListMultipartUploadParts"
           ],
           "Resource":"*"
        }
     ]
  }

• 自定义 IAM 角色的名称必须与您在测试用户的 IAM 权限中指定的 IAM 角色资源相匹配。默认情况下，测试用户策略允许访问角色名称中idt-带有前缀的 IAM 角色。如果您的 IAM 角色名称不使用此前缀，请将arn:aws:iam::*:role/custom-iam-role-name资源添加到测试用户策略的passRoleForResources语roleAliasResources句和语句中，如以下示例所示：

  例 passRoleForResources statement

  {
     "Sid":"passRoleForResources",
     "Effect":"Allow",
     "Action":"iam:PassRole",
     "Resource":"arn:aws:iam::*:role/custom-iam-role-name",
     "Condition":{
        "StringEquals":{
           "iam:PassedToService":[
              "iot.amazonaws.com",
              "lambda.amazonaws.com",
              "greengrass.amazonaws.com"
           ]
        }
     }
  }

  例 roleAliasResources statement

  {
     "Sid":"roleAliasResources",
     "Effect":"Allow",
     "Action":[
        "iot:CreateRoleAlias",
        "iot:DescribeRoleAlias",
        "iot:DeleteRoleAlias",
        "iot:TagResource",
        "iam:GetRole"
     ],
     "Resource":[
        "arn:aws:iot:*:*:rolealias/idt-*",
        "arn:aws:iam::*:role/custom-iam-role-name"
     ]
  }

• 安装在 Greengr@@ ass 核心设备上的 Docker E ngine 1.9.1 或更高版本。版本 20.10 是经验证可与 Amazon IoT Greengrass 核心软件配合使用的最新版本。在部署运行 Docker 容器的组件之前，必须直接在核心设备上安装 Docker。

• 在部署此组件之前，Docker 守护程序已启动并在核心设备上运行。

• 运行 Docker 容器组件的系统用户必须具有根或管理员权限，或者您必须将 Docker 配置为以非根用户或非管理员用户身份运行。

  • 在 Linux 设备上，您可以将用户添加到docker群组中，无需用户即可调用docker命令sudo。

  • 在 Windows 设备上，无需管理员权限即可将用户添加到docker-users群组中以调用docker命令。

  Linux or Unix

  要将或用于运行 Docker 容器组件的非 root 用户添加到ggc_userdocker群组，请运行以下命令。

  sudo usermod -aG docker ggc_user

  有关更多信息，请参阅以非 root 用户身份管理 Docker。

  Windows Command Prompt (CMD)

  要将或您用来运行 Docker 容器组件的用户添加到ggc_userdocker-users群组，请以管理员身份运行以下命令。

  net localgroup docker-users ggc_user /add

  Windows PowerShell

  要将或您用来运行 Docker 容器组件的用户添加到ggc_userdocker-users群组，请以管理员身份运行以下命令。

  Add-LocalGroupMember -Group docker-users -Member ggc_user

• 在运行亚马逊 Linux 2 或 Ubuntu 18.04 的 Greengrass 核心设备上，设备上安装了 GNU C 库 (glibc) 2.27 或更高版本。

• 在 armv7L 设备上，例如 Raspberry Pi，设备上安装了 OpenCV-Python 的依赖关系。运行以下命令来安装依赖项。

  sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev

• 运行 Raspberry Pi OS Bullseye 的 Raspberry Pi 设备必须满足以下要求：

  • NumPy 设备上安装了 1.22.4 或更高版本。Raspberry Pi OS Bullseye 包含的早期版本 NumPy，因此你可以运行以下命令在设备 NumPy 上进行升级。

    pip3 install --upgrade numpy

  • 设备上已启用旧版相机堆栈。Raspberry Pi OS Bullseye 包含一个新的相机堆栈，该堆栈默认处于启用状态且不兼容，因此您必须启用旧版相机堆栈。

    启用旧版相机堆栈

    1. 运行以下命令打开 Raspberry Pi 配置工具。

       sudo raspi-config

    2. 选择 “接口选项”。

    3. 选择旧版相机以启用旧版相机堆栈。

    4. 重启 Raspberry Pi。