重置部署 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

您正在查看Amazon IoT Greengrass Version 1.Amazon IoT Greengrass Version 2是最新的主要版本Amazon IoT Greengrass. 有关使用Amazon IoT Greengrass V2,请参阅Amazon IoT Greengrass Version 2开发人员指南.

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

重置部署

此功能适用于Amazon IoT GreengrassCore v1.1 及更高版本。

您可能希望重置组的部署以执行以下操作:

  • 删除组 (例如,当组的核心已重新镜像时。)

  • 将组的核心移到不同的组。

  • 将组恢复到任何部署之前的状态。

  • 从核心设备删除部署配置。

  • 从核心设备或云中删除敏感数据。

  • 将新的组配置部署到一个核心而不必将该核心替换成当前组中的另一个核心。

注意

Amazon IoT Greengrass 核心软件 v1.0.0 中不支持重置部署功能。您不能删除已使用 v1.0.0 部署的组。

重置部署操作首先会清除存储在云中的指定组的所有部署信息。然后,它将指示该组的核心设备也清理其所有部署相关信息 (Lambda 函数、用户日志、影子数据库和服务器证书,但不包括用户定义的config.json或 Greengrass 核心证书)。如果一个组目前的部署状态为 In ProgressBuilding,则无法为其启动部署重置。

从 中重置部署Amazon IoT控制台

您可以在中的组配置页面中重置组部署。Amazon IoT控制台。

  1. 在Amazon IoT控制台的导航窗格中,选择Greengrass经典版本Groups.

  2. 选择目标组。

  3. 操作中,选择重置部署

    
                                Greengrass 组的部署页面。

使用 Amazon IoT Greengrass API 重置部署

您可以使用 Amazon CLI、Amazon IoT Greengrass API 或 Amazon 开发工具包中的 ResetDeployments 操作来重置部署。本主题中的示例使用 CLI。

aws greengrass reset-deployments --group-id GroupId [--force]

reset-deployments CLI 命令的参数:

--group-id

组 ID。使用 list-groups 命令以获取此值。

--force

可选。如果组的核心设备丢失、被盗或损毁,则使用此参数。该选项可使重置部署过程在云中的所有部署信息都清理完后即报告成功,而不必等待核心设备响应。但是,如果核心设备处于或变为活动状态,它还会执行清理操作。

reset-deployments CLI 命令的输出如下所示:

{ "DeploymentId": "4db95ef8-9309-4774-95a4-eea580b6ceef", "DeploymentArn": "arn:aws:greengrass:us-west-2:106511594199:/greengrass/groups/b744ed45-a7df-4227-860a-8d4492caa412/deployments/4db95ef8-9309-4774-95a4-eea580b6ceef" }

可以使用 get-deployment-status CLI 命令查看重置部署的状态:

aws greengrass get-deployment-status --deployment-id DeploymentId --group-id GroupId

get-deployment-status CLI 命令的参数:

--deployment-id

部署 ID。

--group-id

组 ID。

get-deployment-status CLI 命令的输出如下所示:

{ "DeploymentStatus": "Success", "UpdatedAt": "2017-04-04T00:00:00.000Z" }

当重置部署正在准备时,DeploymentStatus 设置为 Building。如果重置部署已准备就绪,但Amazon IoT Greengrass核心未选择重置部署,DeploymentStatusInProgress.

如果重置操作失败,将在响应中返回错误信息。

另请参阅