重置部署 - AWS IoT Greengrass
从 中重置部署AWS IoT控制台使用 AWS IoT Greengrass API 重置部署另请参阅

AWS IoT Greengrass Version 12023 年 6 月 30 日进入延长寿命阶段。有关更多信息，请参阅AWS IoT Greengrass V1维护政策。在此日期之后，AWS IoT Greengrass V1不会发布提供功能、增强功能、错误修复或安全补丁的更新。在上面运行的设备AWS IoT Greengrass V1不会中断，将继续运行并连接到云端。我们强烈建议您迁移到 AWS IoT Greengrass Version 2，这样可以添加重要的新功能并支持其他平台。

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

重置部署

此功能适用于以下项AWS IoT Greengrass核心 v1.1 及更高版本。

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

  • 删除该组，例如当您要将组的核心移至另一个组，或者该组的核心已重新映像时。在删除组之前，您必须重置该组的部署，以便将该核心与另一个 Greengrass 组一起使用。

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

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

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

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

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

注意

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

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

从 中重置部署AWS IoT控制台

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

  1. 在AWS IoT控制台导航窗格，在Manage，展开Greengrass 设备，然后选择组 (V1).

  2. 选择目标组。

  3. 从部署选项卡上，选择重置部署.

  4. 在重置此 Greengrass 组的部署对话框上，键入confirm同意，然后选择重置部署.

使用 AWS IoT Greengrass API 重置部署

您可以使用 AWS CLI、AWS IoT Greengrass API 或 AWS 开发工具包中的 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。当重置部署已准备就绪，但AWS IoT Greengrasscore 未选择重置部署，DeploymentStatus是InProgress.

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

另请参阅