配置 AWS IoT Greengrass 流管理器

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

2. 选择目标组。

3. 选择 Lambda 函数选项卡。

4. 在系统 Lambda 函数下，选择流管理器，然后选择编辑。

5. 检查启用或禁用状态。还会显示所有配置的自定义流管理器设置。

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

2. 选择 Create Group（创建组）。您在下一页上的选择决定了如何为组配置流管理器。

3. 继续完成命名您的组，然后选择 Greengrass 核心页面。

4. 选择创建组。

5. 在组配置页面上，选择 Lambda 函数选项卡，选择流管理器，然后选择编辑。

   • 要使用默认设置启用流管理器，请选择 启用默认设置。

      

   • 要使用自定义设置启用流管理器，请选择 Customize settings (自定义设置)。

     1. 在配置流管理器页面上，选择启用自定义设置。

     2. 在 Custom settings (自定义设置) 下，输入流管理器参数的值。有关更多信息，请参阅流管理器参数。将字段留空以允许 AWS IoT Greengrass 使用其默认值。

         

   • 要禁用直播管理器，请选择禁用。

     1. 在 Configure stream manager (配置流管理器) 页面上，选择 Disable (禁用)。

         

6. 选择 Save（保存）。

7. 继续浏览剩余页面以创建您的组。

8. 在客户端设备页面上，下载安全资源，查看信息，然后选择完成。

   注意

   启用流管理器后，必须在核心设备上安装 Java 8 运行时，然后再部署组。

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

2. 选择目标组。

3. 选择 Lambda 函数选项卡。

4. 在系统 Lambda 函数下，选择流管理器，然后选择编辑。

5. 检查启用或禁用状态。还会显示所有配置的自定义流管理器设置。

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

2. 选择目标组。

3. 选择 Lambda 函数选项卡。

4. 在系统 Lambda 函数下，选择流管理器，然后选择编辑。

5. 检查启用或禁用状态。还会显示所有配置的自定义流管理器设置。

6. 选择 Save（保存）。

1. 获取目标 Greengrass 组和组版本的 ID。此过程假定这是最新的组和组版本。以下查询将返回最近创建的组。

   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

   或者，您也可以按名称查询。系统不要求组名称是唯一的，所以可能会返回多个组。

   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"

   注意

   您还可以在 AWS IoT 控制台中找到这些值。组 ID 显示在组的设置页面上。组版本 ID 显示在组的部署选项卡上。

2. 从输出中的目标组复制 Id 和 LatestVersion 值。

3. 获取最新的组版本。

   • 将 group-id 替换为复制的 Id。

   • 将 latest-group-version-id 替换为复制的 LatestVersion。

   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id latest-group-version-id

4. 从输出中的 FunctionDefinitionVersionArn，获得函数定义的 ID 和函数定义版本。

   • 函数定义 ID 是 Amazon 资源名称（ARN）中 functions 段后面的 GUID。

   • 函数定义版本 ID 是 ARN 中 versions 段后面的 GUID。

   arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/function-definition-id/versions/function-definition-version-id

5. 获取函数定义版本。

   • 将 function-definition-id 替换为函数定义 ID。

   • 将 function-definition-version-id 替换为函数定义版本 ID。

   aws greengrass get-function-definition-version \
   --function-definition-id function-definition-id \
   --function-definition-version-id function-definition-version-id

启用、禁用或配置流管理器 (CLI)

1. 获取目标 Greengrass 组和组版本的 ID。此过程假定这是最新的组和组版本。以下查询将返回最近创建的组。

   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

   或者，您也可以按名称查询。系统不要求组名称是唯一的，所以可能会返回多个组。

   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"

   注意

   您还可以在 AWS IoT 控制台中找到这些值。组 ID 显示在组的设置页面上。组版本 ID 显示在组的部署选项卡上。

2. 从输出中的目标组复制 Id 和 LatestVersion 值。

3. 获取最新的组版本。

   • 将 group-id 替换为复制的 Id。

   • 将 latest-group-version-id 替换为复制的 LatestVersion。

   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id latest-group-version-id

4. 从输出中复制 CoreDefinitionVersionArn 和所有其他版本的 ARN（FunctionDefinitionVersionArn 除外）。在创建组版本时，将使用这些值。

5. 在输出的 FunctionDefinitionVersionArn 中，复制函数定义的 ID。该 ID 是 ARN 中的 functions 段后面的 GUID，如以下示例所示。

   arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/bcfc6b49-beb0-4396-b703-6dEXAMPLEcu5/versions/0f7337b4-922b-45c5-856f-1aEXAMPLEsf6

   注意

   或者，您可以通过运行 create-function-definition 命令以创建一个函数定义，然后从输出中复制该 ID。

6. 在函数定义中添加一个函数定义版本。

   • 使用为函数定义复制的 替换 function-definition-idId。

   • 在 functions 数组中，包括要在 Greengrass 核心上提供的所有其他函数。您可以使用 get-function-definition-version 命令获取现有函数的列表。

    

   使用默认设置启用流管理器

   以下示例通过在 functions 数组中包含 GGStreamManager 函数来启用流管理器。此示例使用流管理器参数的默认值。

   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[
           {
               "FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
               "FunctionConfiguration": {
                   "MemorySize":  4194304,
                   "Pinned": true,
                   "Timeout": 3
               },
               "Id": "streamManager"
           },
           {    
               "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:MyLambdaFunction:MyAlias",
               "FunctionConfiguration": {
                   "Executable": "myLambdaFunction.function_handler",
                   "MemorySize": 16000,
                   "Pinned": true,
                   "Timeout": 5
               },
               "Id": "myLambdaFunction"
           },
           ... more user-defined functions
       ]
   }'

   注意

   示例中的 myLambdaFunction 函数表示用户定义的 Lambda 函数之一。

   使用自定义设置启用流管理器

   以下示例通过在 functions 数组中包含 GGStreamManager 函数来启用流管理器。除非要更改默认值，否则所有流管理器设置都是可选的。此示例演示如何使用环境变量来设置自定义值。

   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[
           {
               "FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
               "FunctionConfiguration": {
                   "Environment": {
                       "Variables": {
                           "STREAM_MANAGER_STORE_ROOT_DIR": "/data",
                           "STREAM_MANAGER_SERVER_PORT": "1234",
                           "STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE": "4"
                       }
                   },
                   "MemorySize":  4194304,
                   "Pinned": true,
                   "Timeout": 3
               },
               "Id": "streamManager"
           },
           {    
               "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:MyLambdaFunction:MyAlias",
               "FunctionConfiguration": {
                   "Executable": "myLambdaFunction.function_handler",
                   "MemorySize": 16000,
                   "Pinned": true,
                   "Timeout": 5
               },
               "Id": "myLambdaFunction"
           },
           ... more user-defined functions
       ]
   }'

   注意

   对于 FunctionConfiguration 属性，您可能知道以下内容：

   • 在默认设置下，MemorySize 设置为 4194304 KB (4 GB)。您可随时更改此值。建议您将 MemorySize 设置为至少 128000 KB。

   • Pinned 必须设置为 true。

   • Timeout 是函数定义版本所需的，但 GGStreamManager 不使用它。

   禁用流管理器

   以下示例省略了用于禁用流管理器的 GGStreamManager 函数。

   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[
           {       
               "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:MyLambdaFunction:MyAlias",
               "FunctionConfiguration": {
                   "Executable": "myLambdaFunction.function_handler",
                   "MemorySize": 16000,
                   "Pinned": true,
                   "Timeout": 5
               },
               "Id": "myLambdaFunction"
           },
           ... more user-defined functions
       ]
   }'

   注意

   如果不需要部署任何 Lambda 函数，则可以完全省略函数定义版本。

7. 从输出中复制函数定义版本的 Arn。

8. 创建一个包含系统 Lambda 函数的组版本。

   • 将 group-id 替换为组的 Id。

   • 将 core-definition-version-arn 替换为从最新组版本中复制的 CoreDefinitionVersionArn。

   • 使用为新函数定义版本复制的 替换 function-definition-version-arnArn。

   • 替换从最新组版本中复制的其他组组件（例如 SubscriptionDefinitionVersionArn 或 DeviceDefinitionVersionArn）的 ARN。

   • 删除任何未使用的参数。例如，如果组版本不包含任何资源，请删除 --resource-definition-version-arn。

   aws greengrass create-group-version \
   --group-id group-id \
   --core-definition-version-arn core-definition-version-arn \
   --function-definition-version-arn function-definition-version-arn \
   --device-definition-version-arn device-definition-version-arn \
   --logger-definition-version-arn logger-definition-version-arn \
   --resource-definition-version-arn resource-definition-version-arn \
   --subscription-definition-version-arn subscription-definition-version-arn

9. 从输出中复制 Version。这是新组版本的 ID。

10. 用新组版本替换组。

    • 使用为组复制的 替换 group-idId。

    • 使用为新组版本复制的 替换 group-version-idVersion。

    aws greengrass create-deployment \
    --group-id group-id \
    --group-version-id group-version-id \
    --deployment-type NewDeployment