配置 Amazon IoT Greengrass 流管理器

1. 在Amazon IoT控制台导航窗格，在Manage展开Greengrass，然后选择组 (V1).

2. 选择目标组。

3. 选择Lambda 函数选项卡.

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

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

1. 在Amazon IoT控制台导航窗格，在Manage展开Greengrass，然后选择组 (V1).

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

3. 继续执行为您的群组命名然后选择一个Greengrass 核心页.

4. 选择创建组。

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

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

      

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

     1. 在存储库的配置流管理器页面上，选择使用自定义设置启用.

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

         

   • 要禁用流管理器，请选择禁用.

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

         

6. 选择 Save（保存）。

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

8. 在存储库的Client 设备页面上，下载安全资源，查看信息，然后选择Finish.

   注意

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

1. 在Amazon IoT控制台导航窗格，在Manage展开Greengrass，然后选择组 (V1).

2. 选择目标组。

3. 选择Lambda 函数选项卡.

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

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

1. 在Amazon IoT控制台导航窗格，在Manage展开Greengrass，然后选择组 (V1).

2. 选择目标组。

3. 选择Lambda 函数选项卡.

4. UNDER系统 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']"

   注意

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

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

3. 获取最新的组版本。

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

   • Replacelatest-group-version-id用LatestVersion你复制了文档。

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

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

   • 函数定义 ID 是后面的 GUIDfunctionsAmazon 资源名称 (ARN) 中的段。

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

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

5. 获取函数定义版本。

   • Replacefunction-definition-id使用函数定义 ID。

   • Replacefunction-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']"

   注意

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

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

3. 获取最新的组版本。

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

   • Replacelatest-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. 在函数定义中添加一个函数定义版本。

   • Replacefunction-definition-id用Id为函数定义复制的。

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

    

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

   以下示例通过包括GGStreamManagerfunctionfunctions数组。此示例使用流管理器参数的默认值。

   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。

   • Replacecore-definition-version-arn用CoreDefinitionVersionArn从最新的组版本中复制的。

   • Replacefunction-definition-version-arn用Arn为新函数定义版本复制的。

   • 替换从最新组版本中复制的其他组组件（例如 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。

    • Replacegroup-version-id用Version为新组版本复制的。

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