创建并打包 Lambda 函数 - AWS IoT Greengrass

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 函数

此模块中的 Python Lambda 函数示例使用AWS IoT Greengrass核心开发工具包让 Python 发布 MQTT 消息。

在此步骤中,您:

  • 下载AWS IoT Greengrass适用于 Python 的核心开发工具包到您的计算机(不是AWS IoT Greengrass核心设备)。

  • 创建包含函数代码和依赖项的 Lambda 函数部署程序包。

  • 使用 Lambda 控制台创建 Lambda 函数和上传部署程序包。

  • 发布 Lambda 函数的版本并创建指向该版本的别名。

要完成本模块,必须在核心设备上安装 Python 3.7。

 

  1. AWS IoT Greengrass核心开发工具包下载页面,下载AWS IoT Greengrass适用于 Python 的核心 SDK 连接到你的计算机。

  2. 解压缩下载的程序包以获取 Lambda 函数代码和开发工具包。

    本模块中的 Lambda 函数使用:

    • examples\HelloWorld 中的 greengrassHelloWorld.py 文件。这是您的 Lambda 函数代码。该函数每 5 秒将两条可能的消息之一发布到 hello/world 主题一次。

    • greengrasssdk 文件夹。这是开发工具包。

  3. greengrasssdk 文件夹复制到包含 greengrassHelloWorld.pyHelloWorld 文件夹中。

  4. 要创建 Lambda 函数部署程序包,请保存greengrassHelloWorld.pygreengrasssdk文件夹转换为压缩的zip文件名为hello_world_python_lambda.zip. py 文件和 greengrasssdk 文件夹必须位于该目录的根目录中。

    
                            显示 hello_word_python_lambda.zip 的压缩内容的屏幕截图。

    在类 UNIX 系统(包括 Mac 终端)上,您可以使用以下命令打包文件和文件夹:

    zip -r hello_world_python_lambda.zip greengrasssdk greengrassHelloWorld.py
    注意

    根据您的发行版,可能需要先安装 zip(例如,通过运行 sudo apt-get install zip)。您的发行版的安装命令可能不同。

    现在您已准备好创建您的 Lambda 函数和上传部署程序包。

  5. 打开 Lambda 控制台并选择创建函数.

  6. 选择 Author from scratch (从头创作)

  7. 将您的函数命名为 Greengrass_HelloWorld 并设置其余字段,如下所示:

    • 对于 Runtime (运行时),选择 Python 3.7

    • 适用于Permissions (权限),请保留默认设置。这将创建一个授予基本 Lambda 权限的执行角色。此角色未由使用AWS IoT Greengrass.

    选择 Create function(创建函数)。

  8. 上传 Lambda 函数部署软件包:

    1. 在存储库的代码选项卡,位于代码来源,选择从以下项上传. 从下拉列表中,选择.zip 格式文件.

      
                带有 .zip 文件的上传自下拉列表突出显示。
    2. 选择上传,然后选择您的hello_world_python_lambda.zip部署程序包。然后,选择 Save (保存)

    3. 在存储库的代码函数的选项卡,位于运行时设置,选择编辑,然后输入以下值。

      • 对于 Runtime (运行时),选择 Python 3.7

      • 对于 Handler (处理程序),输入 greengrassHelloWorld.function_handler

      
                                    “Runtime (运行时)” 部分,其中 “Runtime (运行时)” 部分,其中 “Runtime (运行时)” 部分,其中 “Runtime (运行时)” 部分greengrassHelloWorld.function_handler”。
    4. 选择Save(保存)。

      注意

      这些区域有:测试(的) 按钮AWS Lambda控制台不使用此函数。这些区域有:AWS IoT Greengrass核心开发工具包不包含在AWS Lambda控制台。这些模块(例如greengrass_common) 将在函数部署到你的 Greengrass 核心后提供给这些函数。

  9. 发布 Lambda 函数:

    1. 操作在页面顶部的菜单中,选择发布新版本.

      
                                    突出显示了“Publish new version (发布新版本)”的“Actions (操作)”菜单的屏幕截图。
    2. 对于 Version description (版本描述),输入 First version,然后选择 Publish (发布)

      
                                    “Version description (版本描述)”字段设置为“First version (第一个版本)”并且突出显示了“Publish (发布)”按钮的屏幕截图。
  10. 创建化名适用于 Lambda 函数版本

    注意

    Greengrass 组可以按别名引用 Lambda 函数。使用别名,您可以更轻松地管理代码更新。因为您无需在更新函数代码时更改订阅表或组定义。相反,您只需将此别名指向新函数版本。

    1. 操作在页面顶部的菜单中,选择创建别名.

      
                                    “Actions (操作)”菜单设置为“Create alias (创建别名)”的屏幕截图。
    2. 将此别名命名为GG_HelloWorld,将版本设置为1(对应于您刚刚发布的版本),然后选择Save(保存).

      注意

      AWS IoT Greengrass不支持 Lambda 别名用于$LATEST版本。

       

      
                                    “Name (名称)” 字段设置为 “G_” 的屏幕截图HelloWorld,并将 “版本” 字段设置为 1。