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

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

在核心上运行 Lambda 函数 AWS IoT Greengrass

AWS IoT Greengrass为您在其中创作的用户定义代码提供了容器化的 Lambda 运行时环境。AWS Lambda部署到AWS IoT Greengrass核心的 Lambda 函数在内核的本地 Lambda 运行时中运行。本地 Lambda 函数可由本地事件、来自云端的消息和其他来源触发，从而为客户端设备带来本地计算功能。例如，您可以使用 Greengrass Lambda 函数筛选设备数据，然后再将数据传输到云端。

要将 Lambda 函数部署到内核，您可以将该函数添加到 Greengrass 组（通过引用现有 Lambda 函数），为该函数配置特定于组的设置，然后部署该组。如果该函数访问AWS服务，则还必须向 Gre engrass 组角色添加所有必需的权限。

您可以配置决定 Lambda 函数运行方式的参数，包括权限、隔离、内存限制等。有关更多信息，请参阅使用组特定的配置控制 Greengrass Lambda 函数的执行：

下表列出了受支持的 AWS Lambda 运行时以及它们可以在其上运行的 AWS IoT Greengrass 核心软件版本。

* 您可以在支持的版本上运行使用这些运行时的 Lambda 函数AWS IoT Greengrass，但不能在中创建它们。AWS Lambda如果您设备上的运行时间与为该函数指定的 AWS Lambda 运行时不同，则可以通过在中选择自己的运行时。FunctionRuntimeOverride FunctionDefintionVersion有关更多信息，请参阅CreateFunctionDefinition。有关支持的运行时的更多信息，请参阅《AWS Lambda开发人员指南》中的运行时支持政策。

Greengrass Lambda 函数的软件开发工具包

AWS提供了三个软件开发工具包，可在内核上运行的 Greengrass Lambda 函数使用它们。AWS IoT Greengrass这些开发工具包在不同的软件包中，因此，函数可以同时使用它们。要在 Greengrass Lambda 函数中使用软件开发工具包，请将其包含在您上传到的 Lambda 函数部署包中。AWS Lambda

有关创建部署包的更多信息，请参阅创建并打包 Lambda 函数入门教程或AWS Lambda开发人员指南中的创建部署包。

迁移基于云的 Lambda 函数

AWS IoT Greengrass核心软件开发工具包遵循AWS软件开发工具包编程模型，可以轻松地将为云开发的 Lambda 函数移植到在核心上运行的 Lambda 函数。AWS IoT Greengrass

例如，以下 Python Lambda 函数使用some/topic在云端向主题发布消息：AWS SDK for Python (Boto3)

import boto3

iot_client = boto3.client("iot-data")
response = iot_client.publish(
    topic="some/topic", qos=0, payload="Some payload".encode()
)

要将函数移植到AWS IoT Greengrass内核，请在import语句和client初始化中，将boto3模块名称更改为greengrasssdk，如以下示例所示：

import greengrasssdk

iot_client = greengrasssdk.client("iot-data")
iot_client.publish(topic="some/topic", qos=0, payload="Some payload".encode())

编程模型之间的相似性还使您能够在云中开发 Lambda 函数，然后以最少的努力将其AWS IoT Greengrass迁移到云中。Lambda 可执行文件不在云端运行，因此在部署之前，您无法使用 AWS SDK 在云中开发它们。

按别名或版本引用 Lambda 函数

Greengrass 群组可以按别名（推荐）或按版本引用 Lambda 函数。使用别名可以更轻松地管理代码更新，因为在更新函数代码时，您不必更改订阅表或组定义。相反，您只需将别名指向新的函数版本即可。在群组部署期间，别名会解析为版本号。在使用别名时，解析的版本将在部署时更新为别名指向的版本。

AWS IoT Greengrass不支持 $LATEST 版本的 Lambda 别名。$LATEST 版本不绑定到不可变的、已发布的函数版本，并且可以随时更改，这与版本不可变AWS IoT Greengrass的原则背道而驰。

通过代码更改来更新 Greengrass Lambda 函数的常见做法是使用在 Greengrass 群组和订阅中命名的PRODUCTION别名。在将 Lambda 函数的新版本升级到生产环境时，请将别名指向最新的稳定版本，然后重新部署该组。您也可以使用这种方法回滚到以前的版本。

Greengrass Lambda 函数的通信流

Greengrass Lambda 函数支持多种与群组其他成员、本地服务和云服务（包括服务）进行通信的方法。AWS IoT Greengrass AWS

使用 MQTT 消息进行通信

Lambda 函数可以使用由订阅控制的发布-订阅模式发送和接收 MQTT 消息。

此通信流允许 Lambda 函数与以下实体交换消息：

订阅会定义消息源、消息目标以及用于将消息从源路由到目标的主题。发布到 Lambda 函数的消息将传递给该函数的注册处理程序。订阅实现了更高的安全性并提供可预测的交互。有关更多信息，请参阅MQTT 消息传递工作流中的托管订阅：

其他通信流

检索输入 MQTT 主题（或主旨）

AWS IoT Greengrass使用订阅来控制客户端设备、Lambda 函数和群组中的连接器之间以及AWS IoT与本地影子服务之间的 MQTT 消息交换。订阅定义消息源、消息目标以及用于路由消息的 MQTT 主题。如果目标是 Lambda 函数，则在源发布消息时调用该函数的处理程序。有关更多信息，请参阅使用 MQTT 消息进行通信：

以下示例显示 Lambda 函数如何从传递给处理程序context的中获取输入主题。具体方法是通过从上下文层次结构 (context.client_context.custom['subject']) 访问 subject 密钥。该示例还会解析输入 JSON 消息，然后发布解析的主题和消息。

import greengrasssdk
import logging

client = greengrasssdk.client('iot-data')

OUTPUT_TOPIC = 'test/topic_results'

def get_input_topic(context):
    try:
        topic = context.client_context.custom['subject']
    except Exception as e:
        logging.error('Topic could not be parsed. ' + repr(e))
    return topic
    
def get_input_message(event):
    try:
        message = event['test-key']
    except Exception as e:
        logging.error('Message could not be parsed. ' + repr(e))
    return message

def function_handler(event, context):
    try:
        input_topic = get_input_topic(context)
        input_message = get_input_message(event)
        response = 'Invoked on topic "%s" with message "%s"' % (input_topic, input_message)
        logging.info(response)
    except Exception as e:
        logging.error(e)

    client.publish(topic=OUTPUT_TOPIC, payload=response)

    return

要测试函数，请使用默认配置设置将其添加到组中。然后，添加以下订阅并部署该组。有关说明，请参阅 模块 3 (第 1 部分)：上的 Lambda 函数AWS IoT Greengrass。

部署完成后，调用该函数。

Greengrass Lambda 函数的生命周期配置

Greengrass Lambda 函数生命周期决定了函数何时启动以及它如何创建和使用容器。生命周期还确定如何保留位于函数处理程序外部的变量和预处理逻辑。

AWS IoT Greengrass 支持按需（默认）或长时间生存的生命周期：

有关容器重用的更多信息，请参阅 AWS Compute 博客AWS Lambda中的了解容器重用。

Lambda 可执行文件

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

Lambda 可执行文件是一种 Greengrass Lambda 函数，可用于在核心环境中运行二进制代码。它允许您在本地执行特定于设备的功能，并从较小的编译代码占用空间中受益。Lambda 可执行文件可以通过事件调用、调用其他函数和访问本地资源。

Lambda 可执行文件仅支持二进制编码类型（不支持 JSON），但除此之外，您可以在 Greengrass 组中管理它们，并像其他 Greengrass Lambda 函数一样部署它们。但是，创建 Lambda 可执行文件的过程与创建 Python、Java 和 Node.js Lambda 函数的过程不同：

Lambda 可执行文件必须在其函数代码中实现某些调用和编程模式。例如，main 方法必须：

以下片段是 simple_handler.c 代码示例中的main方法。 GitHub

int main() {
    gg_error err = GGE_SUCCESS;

    err = gg_global_init(0);
    if(err) {
        gg_log(GG_LOG_ERROR, "gg_global_init failed %d", err);
        goto cleanup;
    }

    gg_runtime_start(handler, 0);

cleanup:
    return -1;
}

有关要求、限制和其他实现细节的更多信息，请参阅适用于 C 的 C AWS IoT Greengrass ore SDK。

创建 Lambda 可执行文件

在编译代码和软件开发工具包后，使用 AWS Lambda API 创建 Lambda 函数并上传编译后的可执行文件。

以下示例使用创建函数 CLI 命令创建 Lambda 可执行文件。该命令指定：

aws lambda create-function \
--region aws-region \
--function-name function-name \
--handler executable-name \
--role role-arn \
--zip-file fileb://file-name.zip \
--runtime arn:aws:greengrass:::runtime/function/executable

接下来，使用 AWS Lambda API 发布一个版本并创建别名。

然后，将 Lambda 可执行文件添加到 Greengrass 组，将其配置为在其特定于组的设置中接受二进制输入数据，然后部署该组。您可以在 AWS IoT Greengrass 控制台中或者使用 AWS IoT Greengrass API 执行此操作。