Greengrass 连接器入门（控制台）

登录到 AWS Secrets Manager 控制台。

选择 Store a new secret (存储新密钥)。

在 选择密钥类型 下，选择 其他密钥类型。

在指定要为此密钥存储的键/值对下面的纯文本选项卡上，输入您的 Twilio 身份验证令牌。删除所有 JSON 格式设置，然后仅输入令牌值。

为加密密钥保留选中 aws/secretsmanager，然后选择下一步。

对于密钥名称，输入 greengrass-TwilioAuthToken，然后选择下一步。

本教程不需要轮换，因此，请选择“禁用自动轮换”，然后选择下一步。

在 Review (审核) 页上，审核您的设置，然后选择 Store (存储)。

接下来，在 Greengrass 组中创建一个引用该密钥的密钥资源。

在 AWS IoT 控制台导航窗格的管理下，展开 Greengrass 设备，然后选择组 (V1)。

选择要将密钥资源添加到的组。

在组配置页面上，选择资源选项卡，然后向下滚动到密钥部分。密钥部分显示从属于该组的密钥资源。您可以从此部分添加、编辑和删除密钥资源。

在密钥部分下选择添加。

在添加密钥资源页面，在资源名称中输入 MyTwilioAuthToken。

对于密钥，选择 greengrass-TwilioAuthToken。

在选择标签（可选）部分中，AWSCURRENT 暂存标签表示密钥的最新版本。该标签始终包含在密钥资源中。

选择 Add resource (添加资源)。

在组配置页面上，选择 Connectors (连接器)，然后选择 Add a connector (添加连接器)。

在添加连接器页面上，选择 Twilio Notifications。

选择 版本。

在配置部分中：

选择 Add resource (添加资源)。

从 AWS IoT Greengrass Core 软件开发工具包下载页面，将适用于 Python 的 AWS IoT Greengrass Core 软件开发工具包下载到您的计算机上。

解压缩下载的程序包以获取软件开发工具包。软件开发工具包是 greengrasssdk 文件夹。

将以下 Python 代码函数保存在名为 temp_monitor.py 的本地文件中。

import greengrasssdk
import json
import random

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

# publish to the Twilio Notifications connector through the twilio/txt topic
def function_handler(event, context):
    temp = event['temperature']
    
    # check the temperature
    # if greater than 30C, send a notification
    if temp > 30:
        data = build_request(event)
        client.publish(topic='twilio/txt', payload=json.dumps(data))
        print('published:' + str(data))
        
    print('temperature:' + str(temp))
    return

# build the Twilio request from the input data
def build_request(event):
    to_name = event['to_name']
    to_number = event['to_number']
    temp_report = 'temperature:' + str(event['temperature'])

    return {
        "request": {
            "recipient": {
                "name": to_name,
                "phone_number": to_number,
                "message": temp_report
            }
        },
        "id": "request_" + str(random.randint(1,101))
    }

将以下项目压缩到名为 temp_monitor_python.zip 的文件中。在创建 ZIP 文件时，仅包含代码和依赖项，而不包含文件夹。

此即 Lambda 函数部署程序包。

首先，创建 Lambda 函数。

1. 在 AWS Management Console中，选择 Services (服务)，然后打开 AWS Lambda 控制台。

2. 选择 创建函数，然后选择 从头开始创作。

3. 在 Basic information (基本信息) 部分中，使用以下值：

   • 对于 Function name（函数名称），请输入 TempMonitor。

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

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

4. 在页面底部，选择创建函数。

接下来，注册处理程序并上传您的 Lambda 函数部署程序包。

1. 在代码选项卡上的代码源下，选择上传自。从下拉列表中选择 .zip 文件。

   

2. 选择上传，然后选择您的 temp_monitor_python.zip 部署包。然后，选择 Save (保存)。

3. 在函数的代码选项卡中，在运行时设置下选择编辑，然后输入以下值。

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

   • 对于 Handler (处理程序)，输入 temp_monitor.function_handler。

4. 选择 Save（保存）。

   注意

   AWS Lambda 控制台上的测试按钮不适用于此功能。AWS IoT Greengrass Core 软件开发工具包不包含在 AWS Lambda 控制台中独立运行 Greengrass Lambda 函数所需的模块。这些模块（例如 greengrass_common）是在函数部署到您的 Greengrass 核心之后提供给它们的。

现在，发布 Lambda 函数的第一个版本并创建此版本的别名。

1. 在 Actions 菜单上，选择 Publish new version。

2. 对于 Version description (版本描述)，输入 First version，然后选择 Publish (发布)。

3. 在 TempMonitor: 1 配置页面上，从 Actions (操作) 菜单中选择 Create alias (创建别名)。

4. 在创建新别名页面上，使用以下值：

   • 对于 Name（名称），请输入 GG_TempMonitor。

   • 对于 Version (版本)，选择 1。

   注意

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

5. 选择 Create（创建）。

在组配置页面上，选择Lambda 函数选项卡。

在我的 Lambda 函数下，选择添加。

在添加 Lambda 函数页面上，为您的 Lambda 函数选择 TempMonitor。

对于 Lambda 函数版本，请选择 Alias: GG_TempMonitor。

选择 添加 Lambda 函数。

在组配置页面中，选择订阅选项卡，然后选择添加订阅。

在创建订阅页面中，按如下所述配置源和目标：

1. 在源类型中，选择 Lambda 函数，然后选择 TempMonitor。

2. 对于目标类型，选择连接器，然后选择 Twilio Notifications。

对于主题筛选条件，输入 twilio/txt。

选择 Create subscription（创建订阅）。

重复步骤 1 至 4，以创建允许 AWS IoT 将消息发布到该函数的订阅。

1. 在源类型中，选择服务，然后选择 IoT 云。

2. 对于选择目标，选择 Lambda 函数，然后选择 TempMonitor。

3. 对于 Topic filter (主题筛选条件)，输入 temperature/input。

重复步骤 1 至 4，以创建允许连接器将消息发布到 AWS IoT 的订阅。

1. 对于源类型，选择连接器，然后选择 Twilio Notifications。

2. 对于目标类型，选择服务，然后选择 IoT 云。

3. 对于主题筛选条件，已为您输入 twilio/message/status。这是连接器发布到的预定义主题。

确保 AWS IoT Greengrass 核心正在运行。根据需要在您的 Raspberry Pi 终端中运行以下命令。

1. 要检查守护程序是否正在运行，请执行以下操作：

   ps aux | grep -E 'greengrass.*daemon'

   如果输出包含 root 的 /greengrass/ggc/packages/ggc-version/bin/daemon 条目，则表示守护程序正在运行。

   注意

   路径中的版本取决于您的核心设备上安装的 AWS IoT Greengrass 核心软件版本。

2. 启动进程守护程序：

   cd /greengrass/ggc/core/
   sudo ./greengrassd start

在组配置页面上，选择部署。

1. 在 Lambda 函数选项卡的系统 Lambda 函数部分下，选择 IP 检测器，再选择编辑。

2. 在编辑 IP 检测器设置对话框中，选择自动检测和覆盖 MQTT 代理端点。

3. 选择 Save（保存）。

   这使得设备可以自动获取核心的连接信息，例如 IP 地址、DNS 和端口号。建议使用自动检测，不过 AWS IoT Greengrass 也支持手动指定的终端节点。只有在首次部署组时，系统才会提示您选择发现方法。

   注意

   如果出现提示，请授予权限，以创建 Greengrass 服务角色并将其关联至当前 AWS 区域中的 AWS 账户。该角色将允许 AWS IoT Greengrass 访问您的 AWS 服务资源。

   Deployments (部署) 页面显示了部署时间戳、版本 ID 和状态。完成后，部署的状态应显示为 已完成。

   有关问题排查帮助，请参阅故障排除 AWS IoT Greengrass。

在 AWS IoT 控制台主页上，选择测试。

对于订阅主题，请使用以下值，然后选择订阅。Twilio 通知连接器向此主题发布状态信息。

对于发布到主题，请使用以下值，然后选择发布 来调用函数。

{
   "to_name": "recipient-name",
   "to_number": "recipient-phone-number",
   "temperature": 31
}

如果成功，收件人将收到短信，控制台将在输出数据中显示 success 状态。

现在，将输入消息中的 temperature 更改为 29 并发布。由于温度小于 30，因此 TempMonitor 函数不会触发 Twilio 消息。