将 Lambda 函数作为组件导入(控制台) - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

将 Lambda 函数作为组件导入(控制台)

当您将Amazon IoT Greengrass控制台要创建 Lambda 函数组件,请导入现有的Amazon Lambda函数,然后将其配置为创建在 Greengrass 设备上运行的组件。

在开始之前,请查看要求在Greengrass 设备上运行 Lambda 函数。

第 1 步:选择要导入的 Lambda 函数

  1. Amazon IoT Greengrass控制台导航菜单,选择组件.

  2. 在存储库的组件页面上,选择创建组件.

  3. 在存储库的创建组件页面,在组件信息,选择导入 Lambda 函数.

  4. InLambda 函数中,搜索并选择您要导入的 Lambda 函数。

    Amazon IoT Greengrass创建使用 Lambda 函数名称的组件。

  5. InLambda 函数版本中,选择要导入的版本。您不能选择 Lambda 别名$LATEST.

    Amazon IoT Greengrass使用 Lambda 函数版本作为有效语义版本。例如,如果您的函数版本是 3,则组件版本将变为 3.0.0

第 2 步:配置 Lambda 函数参数

在存储库的创建组件页面,在Lambda 函数配置配置以下参数以用于运行 Lambda 函数的参数。

  1. (可选)添加 Lambda 函数订阅其工作消息的事件源列表。您可以指定事件源,以便将此函数订阅到本地发布/订阅消息和Amazon IoT CoreMQTT 消息。Lambda 函数在收到来自事件源的消息时调用。

    注意

    要为该函数订阅来自其他 Lambda 函数或组件的消息,请部署传统订阅路由器组件当你部署此 Lambda 函数组件时。在部署旧版订阅路由器组件时,请指定 Lambda 函数使用的订阅。

    UNDER事件来源,执行以下操作,以添加事件源:

    1. 对于您添加的每个事件源,请指定以下选项:

      • 主题— 要订阅消息的主题。

      • 类型— 事件源的类型。从以下选项中进行选择:

        • 本地发布/订阅– 订阅本地发布/订阅消息。

          如果您使用以下应用程序:Greengrass 核v2.6.0 或更高版本和Lambda 经理v2.2.5 或更高版本,您可以使用 MQTT 主题通配符 (+#) 在主题当您指定此类型时。

        • Amazon IoT CoreMQTT— 订阅Amazon IoT CoreMQTT 消息。

          你可以使用 MQTT 主题通配符 (+#) 在主题当您指定此类型时。

    2. 要添加其他事件源,请选择添加事件源并重复上一步骤。要删除事件源,请选择Remove位于要删除的事件源旁边。

  2. 适用于超时(秒),输入非固定 Lambda 函数在超时之前可以运行的最长时间(以秒为单位)。默认值为 3 秒。

  3. 适用于Pinned中,选择是否固定 Lambda 函数组件。默认值为True.

    • 固定(或长时间生存)的 Lambda 函数在以下时间启动Amazon IoT Greengrass启动,并在自己的容器中继续运行。

    • 非固定(或按需)Lambda 函数仅在收到工作项时启动,在其空闲之后可退出,在其空闲之后可退出。如果该函数有多个工作项,Amazon IoT Greengrass核心软件创建该函数的多个实例。

  4. (可选)在其他参数,设置以下 Lambda 函数参数。

    • 状态超时(秒)— Lambda 函数组件向 Lambda 管理器组件发送状态更新的时间间隔(以秒为单位)。此参数仅适用于固定的函数。默认值为 60 秒。

    • 最大队列大小— Lambda 函数组件的最大消息队列大小。这些区域有:Amazon IoT Greengrass核心软件将消息存储在 FIFO(先进先出)队列中,直到它可以运行 Lambda 函数来消耗每条消息。默认值为 1,000 条消息。

    • 最大实例数— 非固定 Lambda 函数可以同时运行的最大实例数。默认为 100 个实例。

    • 最大空闲时间(秒)— 非固定 Lambda 函数在Amazon IoT Greengrass核心软件停止其进程。默认值为 60 秒。

    • 编码类型— Lambda 函数支持的负载类型。从以下选项中进行选择:

      • JSON

      • 二进制

      默认值为 JSON。

  5. (可选)指定在 Lambda 函数运行时要传递给该函数的命令行参数列表。

    1. UNDER其他参数,流程参数,选择添加参数.

    2. 对于添加的每个参数,输入要传递给函数的参数。

    3. 要移除参数,请选择Remove在要删除的参数的旁边。

  6. (可选)指定 Lambda 函数运行时可用的环境变量。环境变量使您无需更改函数代码即可存储和更新配置设置。

    1. UNDER其他参数,环境变量,选择添加环境变量.

    2. 对于您添加的每个环境变量,请指定以下选项:

      • 密钥— 变量名称。

      • — 此变量的默认值。

    3. 要移除环境变量,请选择Remove位于要删除的环境变量旁边。

第 3 步:(可选)为 Lambda 函数指定支持的平台

所有核心设备都有操作系统和架构的属性。部署 Lambda 函数组件时,Amazon IoT Greengrass核心软件会将您指定的平台值与核心设备上的平台属性进行比较,以确定该设备是否支持 Lambda 函数。

注意

将 Greengrass 核心组件部署到核心设备时,您还可以指定自定义平台属性。有关更多信息,请参阅 。platform 覆盖参数Greengrass 核组件.

UNDERLambda 函数配置、其他参数、平台,请执行以下操作来指定此 Lambda 函数支持的平台。

  1. 对于每个平台,指定以下选项:

    • 操作系统— 平台操作系统的名称。目前,唯一支持的值是 linux

    • 架构— 平台的处理器架构。支持的值为:

      • amd64

      • arm

      • aarch64

      • x86

  2. 要添加其他平台,请选择添加平台并重复上一步骤。要移除受支持的平台,请选择Remove位于要删除的平台旁边。

第 4 步:(可选)指定 Lambda 函数的组件依赖关系

组件依赖关系标识其他Amazon-提供的组件或函数使用的自定义组件。在部署 Lambda 函数组件时,部署包含这些依赖项,供您的函数运行。

重要

导入您创建的 Lambda 函数以在上运行 Lambda 函数Amazon IoT GreengrassV1 中,您必须为函数使用的功能(例如 secrets、局部阴影和流管理器)定义单个组件依赖关系。将这些组件定义为硬依赖项以便在依赖项更改状态,您的 Lambda 函数组件重新启动。有关更多信息,请参阅 导入 V1 Lambda 函数

UNDERLambda 函数配置、其他参数、组件依赖关系,请完成以下步骤以指定 Lambda 函数的组件依赖关系。

  1. 选择添加依赖项.

  2. 对于您添加的每个组件依赖项,请指定以下选项:

    • 组件名称— 组件名称。例如,输入aws.greengrass.StreamManager加入流管理器组件.

    • 版本要求— 标识此组件依赖项的兼容版本的 npm 样式语义版本约束。您可以指定单个版本或一系列版本。例如,输入^1.0.0指定此 Lambda 函数依赖于流管理器组件的第一个主要版本中的任何版本。有关语义版本约束的更多信息,请参阅npm semver 计算器.

    • 类型— 依赖项的类型。从以下选项中进行选择:

      • 硬性— 如果依赖项更改状态,Lambda 函数组件将会重新启动。This is the default selection.

      • 软性— 如果依赖项更改状态,Lambda 函数组件不会重新启动。

  3. 要移除组件依赖关系,请选择Remove在组件依赖项旁边

第 5 步:(可选)在容器中运行 Lambda 函数

默认情况下,Lambda 函数在Amazon IoT GreengrassCore 软件。您也可以选择在没有任何隔离的情况下将 Lambda 函数作为进程运行(即无容器模式)。

UNDERLinux 进程配置,对于隔离模式,从以下选项中选择您的 Lambda 函数的容器化:

  • Greengrass 容器— Lambda 函数在容器中运行。This is the default selection.

  • 无容器— Lambda 函数作为进程运行,没有任何隔离。

如果您在容器中运行 Lambda 函数,请完成以下步骤来配置 Lambda 函数的流程配置。

  1. 配置容器可用的内存量和系统资源(如卷和设备)。

    UNDER容器参数中,执行以下操作。

    1. 适用于内存大小中,输入要分配给容器的内存大小。您可以在中指定内存大小MB要么kB.

    2. 适用于只读系统文件夹,选择容器是否可以从设备的/sysfolder。默认值为False.

  2. (可选)配置容器化 Lambda 函数可以访问的本地卷。定义体积块时,Amazon IoT Greengrass核心软件将源文件挂载到容器内的目标。

    1. UNDER,选择增加音量.

    2. 对于您添加的每个卷,请指定以下选项:

      • 物理容量— 核心设备上源文件夹的路径。

      • 逻辑卷— 容器中目标文件夹的路径。

      • 许可—(可选)从容器访问源文件夹的权限。从以下选项中进行选择:

        • Read-only— Lambda 函数对源文件夹具有只读访问权限。This is the default selection.

        • Read-write (读/写)— Lambda 函数具有对源文件夹的读/写访问权限。

      • 添加组所有者—(可选)是否将运行 Lambda 函数组件的系统组添加为源文件夹的所有者。默认值为False.

    3. 要移除卷,选择Remove位于要删除的卷的旁边。

  3. (可选)配置容器化 Lambda 函数可以访问的本地系统设备。

    1. UNDERDevices,选择添加设备.

    2. 对于您添加的每个设备,请指定以下选项:

      • 挂载路径— 核心设备上系统设备的路径。

      • 许可—(可选)从容器访问系统设备的权限。从以下选项中进行选择:

        • Read-only— Lambda 函数具有对系统设备的只读访问权限。This is the default selection.

        • Read-write (读/写)— Lambda 函数具有对源文件夹的读/写访问权限。

      • 添加组所有者—(可选)是否将运行 Lambda 函数组件的系统组添加为系统设备的所有者。默认值为False.

第 6 步:创建 Lambda 函数组件

为 Lambda 函数组件配置设置后,选择Create完成新组件的创建。

要在核心设备上运行 Lambda 函数,您可以将新组件部署到核心设备。有关更多信息,请参阅部署Amazon IoT Greengrass组件到设备