建立群組的大量部署

執行以下命令為您要部署的每個群組取得 groupId。您需要將 groupId 輸入大量部署輸入檔中，讓 AWS IoT Greengrass 可以識別每個要部署的群組。

aws greengrass list-groups
        

回應包含您 AWS IoT Greengrass 帳戶中每個群組的相關資訊：

{
  "Groups": [
    {
      "Name": "string",
      "Id": "string",
      "Arn": "string",
      "LastUpdatedTimestamp": "string",
      "CreationTimestamp": "string",
      "LatestVersion": "string",
      "LatestVersionArn": "string"
    }
  ],
  "NextToken": "string"
}          
        

執行以下命令為您要部署的每個群組取得 groupVersionId。

list-group-versions --group-id groupId
        

回應包含群組中所有版本的相關資訊。記下Version要使用之群組版本的值。

{
  "Versions": [
    {
      "Arn": "string",
      "Id": "string",
      "Version": "string",
      "CreationTimestamp": "string"
    }
  ],
  "NextToken": "string"
}
        

在您的電腦終端機或您選擇的編輯器中，建立檔案，MyBulkDeploymentInputFile，從下面的例子。這個檔案包含要納入大量部署中的每個 AWS IoT Greengrass 群組的相關資訊。雖然這個範例中定義多個群組，但對於此教學課程，您的檔案可以只包含一個群組。

{"GroupId":"groupId1", "GroupVersionId":"groupVersionId1", "DeploymentType":"NewDeployment"}
{"GroupId":"groupId2", "GroupVersionId":"groupVersionId2", "DeploymentType":"NewDeployment"}
{"GroupId":"groupId3", "GroupVersionId":"groupVersionId3", "DeploymentType":"NewDeployment"}
...
        

每個記錄 (或列) 包含一個群組物件。每個群組物件包含其對應的 GroupId 和 GroupVersionId 及 DeploymentType。目前，AWS IoT Greengrass 僅支援 NewDeployment 大量部署類型。

儲存並關閉檔案。請記下檔案的位置。

在終端機中使用下列命令，將輸入檔上傳到 Amazon S3 儲存貯體。以您的檔案位置與名稱取代檔案路徑。如需相關資訊，請參閱將物件新增至儲存貯體。

aws s3 cp path/MyBulkDeploymentInputFile s3://my-bucket/

使用下列政策來建立執行角色。此政策文件允許 AWS IoT Greengrass 在替您建立每個部署時存取您的大量部署輸入檔。

如需建立 IAM 角色和委派許可的詳細資訊，請參閱建立 IAM 角色。

 {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": "greengrass:CreateDeployment",
            "Resource": [
                "arn:aws:greengrass:region:accountId:/greengrass/groups/groupId1",
                "arn:aws:greengrass:region:accountId:/greengrass/groups/groupId2",
                "arn:aws:greengrass:region:accountId:/greengrass/groups/groupId3",
                ...
            ]
        }
    ]
}
        

"Resource": ["*"]

將執行角色的信任關係修改為包含 AWS IoT Greengrass。這可讓 AWS IoT Greengrass 使用您的執行角色及其連接的許可。如需相關資訊，請參閱編輯現有角色的信任關係。

我們建議您也包括aws:SourceArn和aws:SourceAccount信任策略中的全局條件上下文鍵，以幫助防止混淆代理人安全問題。條件內容索引鍵會限制存取權，只允許來自指定帳戶和 Greengrass 工作區的要求。如需混淆代理人問題的詳細資訊，請參閱預防跨服務混淆代理人。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "",
      "Effect": "Allow",
      "Principal": {
        "Service": "greengrass.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "account-id"
        },
        "ArnLike": {
          "aws:SourceArn": "arn:aws:greengrass:region:account-id:*"
        }
      }
    }
  ]
}

給予身份管理PassRoleIAM 使用者執行角色的許可。這個 IAM 使用者會用來啟動大量部署。PassRole許可讓您的 IAM 使用者將執行角色傳給AWS IoT Greengrass供使用。如需詳細資訊，請參閱授予使用者將角色傳遞至 AWS 服務。

使用以下範例，更新連接到執行角色的 IAM 政策。視需要修改此範例。

 {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Stmt1508193814000",
            "Effect": "Allow",
            "Action": [
                "iam:PassRole"
            ],
            "Resource": [
                "arn:aws:iam::account-id:user/executionRoleArn"
            ]
            "Condition": {
                "StringEquals": {
                    "iam:PassedToService": "greengrass.amazonaws.com"
                }
            }
        }
    ]
}
        

使用下列命令來開始大量部署。

建議您在每個 StartBulkDeployment 請求中包含 X-Amzn-Client-Token 字符。關於字符和請求參數，這些請求是等冪。此字符可以是任何唯一的、區分大小寫的字串，最多 64 個 ASCII 字元。

aws greengrass start-bulk-deployment --cli-input-json "{
          "InputFileUri":"URI of file in S3 bucket", 
          "ExecutionRoleArn":"ARN of execution role",
          "AmznClientToken":"your Amazon client token"
          }"
        

此命令應該會產生成功狀態碼 200 及以下的回應：

{
  "bulkDeploymentId": UUID
}
        

請記下大量部署 ID。它可用於檢查大量部署的狀態。

使用下列命令來檢查大量部署的狀態。

aws greengrass get-bulk-deployment-status --bulk-deployment-id 1234567

除了 JSON 承載資訊，此命令還應該會傳回成功狀態碼 200：

 {
  "BulkDeploymentStatus": Running,
  "Statistics": {
     "RecordsProcessed": integer,
     "InvalidInputRecords": integer,
     "RetryAttempts": integer
  },
  "CreatedAt": "string",
  "ErrorMessage": "string",
  "ErrorDetails": [
    {
      "DetailedErrorCode": "string",
      "DetailedErrorMessage": "string"
    }
  ]
}
        

BulkDeploymentStatus 包含大量執行的目前狀態。執行可以有六種不同狀態：

JSON 承載還包括大量部署進度的統計資訊。您可以使用此資訊判斷已處理多少群組，以及多少群組已失敗。統計資訊包括：

在大量部署執行失敗的情況下，這個承載還包含 ErrorDetails 區段，可用於故障排除。它包含執行失敗原因的相關資訊。

您可以定期檢查大量部署的狀態，以確認其是否如預期進行。部署完成後，RecordsProcessed 應該等於大量部署輸入檔中的部署群組數目。這表示已處理每個記錄。