配置您的設備以運行 IDT 測試

• 默認使用者 ()。ggc_user

• 您用來連接到被測設備的用戶。您可以在device.json檔案中設定此使用者。

您必須符合以下要求，才能允許 IDT 使用您的自訂 IAM 角色。強烈建議您只將必要的最低原則動作新增至此角色。

• 必須更新使用者資料 .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資源添加到roleAliasResources語句和測試用戶策略中的passRoleForResources語句中，如以下示例所示：

  範例 passRoleForResources 陳述式

  {
     "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 陳述式

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

• 碼頭引擎 1.9.1 或更高版本安裝在 Greengrass 核心設備上。版本 20.10 是經過驗證可與 AWS IoT Greengrass 核心軟件配合使用的最新版本。在部署執行 Docker 容器的元件之前，您必須直接在核心裝置上安裝 Docker。

• 在您部署此元件之前，Docker 精靈會在核心裝置上啟動並執行。

• 執行 Docker 容器元件的系統使用者必須具有根或系統管理員權限，或者您必須將 Docker 設定為以非 root 使用者或非管理員使用者身分執行。

  • 在 Linux 裝置上，您可以將使用者新增至docker群組，以便在不使用的情況下呼叫docker指令sudo。

  • 在 Windows 裝置上，您可以將使用者新增至docker-users群組，以便在沒有系統管理員權限的情況下呼叫docker命令。

  Linux or Unix

  若要將ggc_user您用來執行 Docker 容器元件的非 root 使用者新增至docker群組，請執行下列命令。

  sudo usermod -aG docker ggc_user

  如需詳細資訊，請參閱以非 root 使用者身分管理 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 設備上，如樹莓派，對於設備上安裝了 OpenCV-Python 的依賴關係。執行下列命令以安裝相依性。

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

• 樹莓派運行樹莓派 OS 靶心設備必須滿足以下要求:

  • NumPy 1.22.4 或更新版本已安裝在裝置上。樹莓派 OS 靶心包括早期版本的 NumPy，因此您可以運行以下命令在設備 NumPy 上升級。

    pip3 install --upgrade numpy

  • 裝置上啟用的舊式攝影機堆疊。樹莓派 OS Bullseye 包括一個新的相機堆疊，預設情況下啟用且不相容，因此您必須啟用傳統的相機堆疊。

    啟用舊式相機堆疊的步驟

    1. 運行以下命令以打開樹莓派配置工具。

       sudo raspi-config

    2. 選取介面選項。

    3. 選取「舊式相機」以啟用舊式相機堆疊。

    4. 重新啟動 Raspberry Pi。