配置设备以运行 IDT 测试

• 默认 Greengrass 用户（ggc_user）。

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

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

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

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

  JSON

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

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

  JSON

  {
     "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 资源添加到测试用户策略的 roleAliasResources 语句和 passRoleForResources 语句中，如以下示例所示：

  例通过RoleForResources声明

  {
     "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"
           ]
        }
     }
  }

  例角色AliasResources陈述

  {
     "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"
     ]
  }

• Greengrass 核心设备上安装的 Docker Engine 1.9.1 或更高版本。29.6.0 及以下的版本（例如 20.10、24.0、25.0 和 27.5）适用于酷睿软件。 Amazon IoT Greengrass 在部署运行 Docker 容器的组件之前，必须直接在核心设备上安装 Docker。

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

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

  • 在 Linux 设备上，您可向 docker 组中添加一个用户以调用 docker 命令，无需 sudo。

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

  Linux or Unix

  要添加 ggc_user 或您用于运行 Docker 容器组件的非根用户至 docker 组中，请运行以下命令：

  sudo usermod -aG docker ggc_user

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

  Windows Command Prompt (CMD)

  要添加 ggc_user 或您用于运行 Docker 容器组件的非根用户至 docker-users 组中，请以管理员身份运行以下命令：

  net localgroup docker-users ggc_user /add

  Windows PowerShell

  要添加 ggc_user 或您用于运行 Docker 容器组件的非根用户至 docker-users 组中，请以管理员身份运行以下命令：

  Add-LocalGroupMember -Group docker-users -Member ggc_user

• 在运行 Amazon 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。