AWS IoT Greengrass
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

重置部署

此功能适用于 AWS IoT Greengrass Core 1.1 及更高版本。

您可能需要重置组的部署以实现以下目的:

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

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

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

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

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

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

注意

“重置部署”功能在 AWS IoT Greengrass 核心软件 v1.0.0 中不可用。此外,请注意,已使用 v1.0.0 部署的组无法删除。

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

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

reset-deployments CLI 命令的参数:

--group-id

组 ID。

--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。当重置部署已就绪而 AWS IoT Greengrass Core未选择重置部署时,DeploymentStatusInProgress

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

另请参阅

本页内容: