Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

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

将 Amazon IoT Greengrass 组部署到 Amazon IoT Greengrass 核心

使用 Amazon IoT Greengrass 组用于组织边缘环境中的实体。您也可以使用组来控制组中的实体如何相互交互并与 Amazon Web Services 云 交互。例如，只针对本地运行部署组中的 Lambda 函数，仅组中的设备可以使用本地 MQTT 服务器进行通信。

一个组必须包含一个核心，它是一个运行 Amazon IoT Greengrass 核心软件的 Amazon IoT 设备。网关作为边缘核心，可在边缘环境中提供 Amazon IoT Core 功能。根据您的业务需求，还可以向组中添加以下实体：

您可以管理 Amazon Web Services 云 中的 Greengrass 组，然后将其部署到核心。部署会将组配置复制到核心设备上的 group.json 文件。此文件位于 greengrass-root/ggc/deployments/group 中：

从 Amazon IoT 控制台中部署组

您可以从 Amazon IoT 控制台中的组配置页面中部署组并管理其部署。

使用 Amazon IoT Greengrass API 部署组

Amazon IoT Greengrass API 提供了以下操作，可用于部署 Amazon IoT Greengrass 组和管理组部署。您可以从 Amazon CLI、Amazon IoT Greengrass API 或 Amazon 开发工具包中调用这些操作。

获取组 ID

组 ID 通常用于 API 操作中。您可以使用ListGroups操作从群组列表中查找目标群组的 ID。例如，在 Amazon CLI 中，使用 list-groups 命令。

aws greengrass list-groups

您还可以包含用于筛选结果的 query 选项。例如：

以下为 list-groups 响应示例。每个组的信息都包含组 ID（在 Id 属性中）和最新组版本 ID（在 LatestVersion 属性中）。要获取群组的其他版本 ID，请使用群组 ID 和ListGroupVersions。

{
    "Groups": [
        {
            "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE/versions/4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE",
            "Name": "MyFirstGroup",
            "LastUpdatedTimestamp": "2019-11-11T05:47:31.435Z",
            "LatestVersion": "4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE",
            "CreationTimestamp": "2019-11-11T05:47:31.435Z",
            "Id": "00dedaaa-ac16-484d-ad77-c3eedEXAMPLE",
            "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE"
        },
        {
            "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE/versions/8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE",
            "Name": "GreenhouseSensors",
            "LastUpdatedTimestamp": "2020-01-07T19:58:36.774Z",
            "LatestVersion": "8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE",
            "CreationTimestamp": "2020-01-07T19:58:36.774Z",
            "Id": "036ceaf9-9319-4716-ba2a-237f9EXAMPLE",
            "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE"
        },
        ...
    ]
}

如果您不指定 Amazon Web Services 区域，Amazon CLI 命令将使用您的配置文件中的默认区域。要返回不同区域中的组，请包含区域选项。例如：

aws greengrass list-groups --region us-east-1

Amazon IoT Greengrass 组对象模型概述

当使用 Amazon IoT Greengrass API 编程时，了解 Greengrass 组对象模型很有帮助。

组

在 Amazon IoT Greengrass API 中，顶级 Group 对象包含元数据和 GroupVersion 对象的列表。GroupVersion 对象通过 ID 与 Group 关联。

组版本

GroupVersion 对象可定义组成员资格。每个 GroupVersion 通过 ARN 引用一个 CoreDefinitionVersion 和其他组件版本。这些引用可确定组中要包括哪些实体。

例如，要在组中包含三个 Lambda 函数、一个设备和两个订阅，GroupVersion 引用：

部署到核心设备的 GroupVersion 决定了本地环境中的可用实体及其它们如何进行交互。

组组件

添加到组中的组件具有三级层次结构：

以下示例 DeviceDefinition 会引用三个 DeviceDefinitionVersion 对象，每个都包含多个 Device 对象。一个组中一次只使用一个 DeviceDefinitionVersion。

更新组

在 Amazon IoT Greengrass API 中，您可以使用多个版本更新组的配置。版本是不可变的，因此要添加、移除或更改组组件，必须创建包含新的或更新的实DefinitionVersion体的对象。

您可以将新DefinitionVersions对象与新的或现有的定义对象相关联。例如，您可以使用 CreateFunctionDefinition 操作来创建 FunctionDefinition（其中包含作为初始版本的 FunctionDefinitionVersion），也可以使用 CreateFunctionDefinitionVersion 操作并引用现有 FunctionDefinition。

创建组组件后，您将创建一个GroupVersion包含要包含在组中的所有DefinitionVersion对象。然后，部署 GroupVersion。

要部署 GroupVersion，则必须引用包含一个 Core 的 CoreDefinitionVersion。所有引用的实体必须是组的成员。此外，Greengrass 服务角色必须与正在部署 GroupVersion 的 Amazon Web Services 区域 中的 Amazon Web Services 账户 关联。

更新引用 Amazon 资源的实体

Greengrass Lambda 函数和密钥资源会定义 Greengrass 特定属性，并引用相应的 Amazon 资源。要更新这些实体，您可以更改相应的 Amazon 资源，而不是 Greengrass 对象。例如，Lambda 函数会引用 Amazon Lambda 中的一个函数，并且定义特定于 Greengrass 组的生命周期和其他属性。

另请参阅