为组创建批量部署

运行以下命令以获取要部署的每个组的 groupId。在批量部署输入文件中输入 groupId，让 Amazon IoT Greengrass 可以识别要部署的每个组。

aws greengrass list-groups
        

该响应包含有关您 Amazon 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。此文件包含有关要包含在批量部署中的每个 Amazon IoT Greengrass 组的信息。虽然此示例定义多个组，但在本教程中，您的文件只能包含一个组。

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

每个记录（或行）包含一个组对象。每个组对象包含其相应 GroupId、GroupVersionId 和 DeploymentType。目前，Amazon IoT Greengrass 仅支持 NewDeployment 批量部署类型。

保存并关闭该文件。记下该文件的位置。

在您的终端中使用以下命令将输入文件上传到 Amazon S3 存储桶。将文件路径替换为该文件的位置和名称。有关信息，请参阅将对象添加到存储桶。

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

使用以下策略创建一个执行角色。此策略文档允许 Amazon 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": ["*"]

修改该执行角色的信任关系以包含 Amazon IoT Greengrass。这允许 Amazon 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:*"
        }
      }
    }
  ]
}

为 IAM 用户赋予执行角色的 IAM PassRole 权限。此 IAM 用户是用于启动批量部署的用户。PassRole 权限允许您的 IAM 用户将该执行角色传递给 Amazon IoT Greengrass 以供使用。有关更多信息，请参阅向用户授予将角色传递给 Amazon 服务的权限。

使用以下示例更新附加到您的执行角色的 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 应等于批量部署输入文件中的部署组的数量。这表示每个记录均已得到处理。