重置部署 - Amazon IoT Greengrass
从 Amazon IoT 控制台重置部署使用 Amazon IoT Greengrass API 重置部署另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

终止支持通知：2026 年 10 月 7 日， Amazon 将停止对的支持。 Amazon IoT Greengrass Version 1 2026 年 10 月 7 日之后，您将无法再访问这些 Amazon IoT Greengrass V1 资源。如需了解更多信息，请访问迁移自 Amazon IoT Greengrass Version 1。

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

重置部署

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

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

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

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

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

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

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

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

注意

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

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

从 Amazon IoT 控制台重置部署

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

  1. 在 Amazon IoT 控制台导航窗格的管理下，展开 Greengrass 设备，然后选择群组 (V1)。

  2. 选择目标组。

  3. 在 部署 选项卡中，选择 重置部署。

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

使用 Amazon IoT Greengrass API 重置部署

您可以使用 Amazon CLI、 Amazon IoT Greengrass API 或 Amazon SDK 中的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 核心尚未启动重置部署时，则DeploymentStatus为InProgress。

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

另请参阅