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 软件的 OTA 更新

AWS IoT Greengrass Core 软件包中包含可执行 AWS IoT Greengrass 软件无线 (OTA) 更新的更新代理。您可以使用 OTA 更新在一个或多个核心上安装最新版本的 AWS IoT Greengrass Core 软件或 OTA 更新代理软件。通过 OTA 更新，您的核心设备无需物理连接。

我们建议您尽可能使用 OTA 更新。这提供了一种可用于跟踪更新状态和更新历史记录的机制。如果更新失败，则 OTA 更新代理回滚到以前的软件版本。

OTA 更新可以更高效地执行以下操作：

此功能与 AWS IoT 作业集成。

要求

以下要求适用于 AWS IoT Greengrass 软件的 OTA 更新。

OTA 更新的 IAM 权限

当 AWS IoT Greengrass 发布 AWS IoT Greengrass Core 软件的新版本时，AWS IoT Greengrass 更新存储在用于 OTA 更新的 Amazon S3 中的软件构件。

您的 AWS 账户 必须包含可用于访问这些构件的 Amazon S3 URL 签署人角色。该角色必须具有允许对目标 AWS 区域 中存储桶执行 s3:GetObject 操作的权限策略。该角色还必须具有信任策略，允许 iot.amazonaws.com 作为可信实体代入角色。

此外，启动 OTA 更新的用户必须具有使用 greengrass:CreateSoftwareUpdateJob 和 iot:CreateJob 的权限，并可以使用 iam:PassRole 来传递签署人角色的权限。以下为 IAM policy 示例：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "greengrass:CreateSoftwareUpdateJob"
            ],
            "Effect": "Allow",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:CreateJob"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iam:PassRole"
            ],
            "Resource": "arn-of-s3-url-signer-role"
        }
    ]
}

注意事项

在对 Greengrass 核心软件启动 OTA 更新之前，要注意该操作对 Greengrass 组中设备的影响，不仅影响核心设备，还会影响在本地连接至该核心的客户端设备：

OTA 更新期间保留以下状态信息：

Greengrass OTA 更新代理

Greengrass OTA 更新代理是设备上的软件组件，可处理在云中创建和部署的更新任务。OTA 更新代理在与 AWS IoT Greengrass Core 软件相同的软件包中分发。代理位于 /greengrass-root/ota/ota_agent/ggc-ota。它将日志写入到 /var/log/greengrass/ota/ggc_ota.txt。

您可以通过手动执行二进制文件或通过作为 init 脚本的一部分（如 systemd 服务文件）集成来启动 OTA 更新代理。如果您手动执行二进制文件，则应以 root 用户身份运行。在启动时，OTA 更新代理从 AWS IoT Core 侦听 AWS IoT Greengrass 软件更新作业并按顺序执行它们。OTA 更新代理将忽略所有其他 AWS IoT 作业类型。

以下摘录显示了用于启动、停止和重新启动 OTA 更新代理的系统服务文件示例：

[Unit]
Description=Greengrass OTA Daemon

[Service]
Type=forking
Restart=on-failure
ExecStart=/greengrass/ota/ota_agent/ggc-ota

[Install]
WantedBy=multi-user.target

作为更新目标的核心不能运行 OTA 更新代理的两个实例。这样做会导致两个代理处理相同的任务，因此产生冲突。

与初始化系统集成

在 OTA 更新期间，OTA 更新代理将重新启动核心设备上的二进制文件。如果二进制文件正在运行，在更新期间，当 init 系统监控 AWS IoT Greengrass Core 软件或代理的状态时，这可能会导致冲突。为了帮助将 OTA 更新机制与您的 init 监控策略集成，您可以编写在更新前后运行的 shell 脚本。例如，您可以使用 ggc_pre_update.sh 脚本，在设备关闭之前备份数据或停止进程。

要告诉 OTA 更新代理运行这些脚本，您必须在 config.json 文件中包含 "managedRespawn" : true 标志。以下摘录显示了此设置：

{
   "coreThing": {                                                     
       …
   },
   "runtime": {                                                       
       …
   },
   "managedRespawn": true
       …
}

使用 OTA 更新的托管 Respawn

以下要求适用于 managedRespawn 设置为 true 的 OTA 更新：

OTA 更新代理运行来自 /greengrass-root/usr/scripts 的脚本。该目录树应如下所示：

<greengrass_root>
|-- certs
|-- config
|   |-- config.json
|-- ggc
|-- usr/scripts
|   |-- ggc_pre_update.sh
|   |-- ggc_post_update.sh
|   |-- ota_pre_update.sh
|   |-- ota_post_update.sh
|-- ota

如果将 managedRespawn 设置为 true，则 OTA 更新代理在软件更新前后检查 /greengrass-root/usr/scripts 目录中的这些脚本。如果脚本不存在，则更新失败。AWS IoT Greengrass 不会验证这些脚本的内容。作为最佳实践，请验证您的脚本是否正常运行，并针对错误发出相应的退出代码。

创建 OTA 更新

按照以下步骤在一个或多个核心上执行 AWS IoT Greengrass 软件的 OTA 更新：

CreateSoftwareUpdateJob API

您可以使用 CreateSoftwareUpdateJob API 更新核心设备上的 AWS IoT Greengrass Core 软件或 OTA 更新代理软件。此 API 创建一个 AWS IoT 快照作业，在更新可用时通知设备。调用 CreateSoftwareUpdateJob 后，您可以使用其他 AWS IoT 作业命令来跟踪软件更新。有关更多信息，请参阅 AWS IoT 开发人员指南中的作业。

以下示例介绍如何使用 AWS CLI 创建用于更新核心设备上的 AWS IoT Greengrass Core 软件的作业：

aws greengrass create-software-update-job \
--update-targets-architecture x86_64 \
--update-targets [\"arn:aws:iot:region:123456789012:thing/myCoreDevice\"] \
--update-targets-operating-system ubuntu \
--software-to-update core \
--s3-url-signer-role arn:aws:iam::123456789012:role/myS3UrlSignerRole \
--update-agent-log-level WARN \
--amzn-client-token myClientToken1

create-software-update-job 命令会返回一个 JSON 响应，其中包含作业 ID、作业 ARN 和更新所安装的软件版本：

{
    "IotJobId": "GreengrassUpdateJob_c3bd7f36-ee80-4d42-8321-a1da0EXAMPLE",
    "IotJobArn": "arn:aws:iot:region:123456789012:job/GreengrassUpdateJob_c3bd7f36-ee80-4d42-8321-a1da0EXAMPLE",
    "PlatformSoftwareVersion": "1.9.2"
}

有关演示如何使用 create-software-update-job 更新核心设备的步骤，请参阅创建 OTA 更新。

create-software-update-job 命令包含以下参数：