AWS IoT Greengrass ストリームマネージャーの設定

1. AWS IoT コンソールのナビゲーションペインの [Manage]（管理）で、[Greengrass devices]（Greengrass デバイス）を展開して、[Group (V1)]（グループ (V1)）を選択します。

2. ターゲットグループを選択します。

3. [Lambda functions] (Lambda 関数) タブを選択します。

4. [System Lambda functions] (システム Lambda 関数) で、[Stream manager] (ストリームマネージャー)、[Edit] (編集) の順に選択します。

5. 有効または無効のステータスを確認します。設定されているカスタムストリームマネージャー設定も表示されます。

1. AWS IoT コンソールのナビゲーションペインの [Manage]（管理）で、[Greengrass devices]（Greengrass デバイス）を展開して、[Group (V1)]（グループ (V1)）を選択します。

2. [グループを作成] を選択します。次のページで選択すると、グループのストリームマネージャーの設定方法が決まります。

3. [Name your Group] (グループに名前を付ける) から [Greengrass core] (Greengrass コア) ページを選択します。

4. [Create group] (グループの作成) を選択します。

5. グループ設定ページで、[Lambda functions] (Lambda 関数) タブを選択し、[Stream manager] (ストリームマネージャー)、[Edit] (編集) の順に選択します。

   • デフォルト設定でストリームマネージャーを有効にするには、[Use defaults] (デフォルトを使用) を選択します。

      

   • カスタム設定でストリームマネージャーを有効にするには、[Customize settings (設定をカスタマイズ)] を選択します。

     1. [Configure stream manager] (ストリームマネージャーの設定) ページで、[Enable with custom settings] (カスタム設定で有効にする) を選択します。

     2. [Custom settings (カスタム設定)] で、ストリームマネージャーパラメータの値を入力します。詳細については、「ストリームマネージャーのパラメータ」を参照してください。AWS IoT Greengrass でデフォルト値を使用できるようにするには、フィールドを空のままにします。

         

   • ストリームマネージャーを無効にするには、[Disable] (無効化) を選択します。

     1. [Configure stream manager (ストリームマネージャーの設定)] ページで、[Disable (無効にする)] を選択します。

         

6. [Save] を選択します。

7. 残りのページに進み、グループを作成します。

8. [Client devices] (クライアントデバイス) ページで、セキュリティリソースをダウンロードし、情報を確認して、[Finish] (完了) を選択します。

   注記

   ストリームマネージャーが有効になっている場合、グループをデプロイする前に、コアデバイスに Java 8 ランタイムをインストールする必要があります。

1. AWS IoT コンソールのナビゲーションペインの [Manage]（管理）で、[Greengrass devices]（Greengrass デバイス）を展開して、[Group (V1)]（グループ (V1)）を選択します。

2. ターゲットグループを選択します。

3. [Lambda functions] (Lambda 関数) タブを選択します。

4. [System Lambda functions] (システム Lambda 関数) で、[Stream manager] (ストリームマネージャー)、[Edit] (編集) の順に選択します。

5. 有効または無効のステータスを確認します。設定されているカスタムストリームマネージャー設定も表示されます。

1. AWS IoT コンソールのナビゲーションペインの [Manage]（管理）で、[Greengrass devices]（Greengrass デバイス）を展開して、[Group (V1)]（グループ (V1)）を選択します。

2. ターゲットグループを選択します。

3. [Lambda functions] (Lambda 関数) タブを選択します。

4. [System Lambda functions] (システム Lambda 関数) で、[Stream manager] (ストリームマネージャー)、[Edit] (編集) の順に選択します。

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-idId を置換えます。

   • コピーした で latest-group-version-idLatestVersion を置換えます。

   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. 関数定義バージョンの ID。

   • function-definition-id を関数定義 ID に置き換えます。

   • function-definition-version-id 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-idId を置換えます。

   • コピーした で latest-group-version-idLatestVersion を置換えます。

   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 Core で使用できるようにする他のすべての関数を含めます。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 関数の 1 つを表します。

   カスタム設定でストリームマネージャーを有効にする

   次の例では、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-arnCoreDefinitionVersionArn を置換えます。

   • 新しい関数定義バージョンにコピーした で function-definition-version-arnArn を置換えます。

   • 最新のグループバージョンからコピーした他のグループコンポーネントの ARN (SubscriptionDefinitionVersionArn、DeviceDefinitionVersionArn など) を置き換えます。

   • 使用されていないパラメータをすべて削除します。例えば、グループバージョンにリソースがない場合には、--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-id を、グループのコピー済み Id に置き換えます。

    • 新しいグループバージョンにコピーした で group-version-idVersion を置換えます。

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