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

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

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

重置部署

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

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

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

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

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

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

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

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

注意

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

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

从 AWS IoT 控制台中重置部署

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

  1. 在 AWS IoT 控制台导航窗格的管理下，展开 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 Greengrass 核心未选择重置部署时，DeploymentStatus 为 InProgress。

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

另请参阅