Amazon Kinesis Video Streams Edge Agent AWS IoT Greengrass コンポーネントをデバイスにデプロイする - Amazon Kinesis Video Streams

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Kinesis Video Streams Edge Agent AWS IoT Greengrass コンポーネントをデバイスにデプロイする

Amazon Kinesis Video Streams Edge Agent AWS IoT Greengrass コンポーネントをデバイスにデプロイするには、以下を実行します。

コンポーネントのデプロイ

  1. 提供されたリンクを使用して tar ファイルをダウンロードします。

    Amazon Kinesis Video Streams Edge Agent のインタレストフォームに記入した場合は、ダウンロードリンクの E メールを確認してください。フォームを完了していない場合は、ここで入力します。

  2. チェックサムを確認します。

  3. デバイス内のバイナリと jar を抽出します。

    型: tar -xvf kvs-edge-agent.tar.gz。

    抽出後、フォルダ構造は次のようになります。

    kvs-edge-agent/LICENSE
kvs-edge-agent/THIRD-PARTY-LICENSES
kvs-edge-agent/pom.xml
kvs-edge-agent/KvsEdgeComponent
kvs-edge-agent/KvsEdgeComponent/recipes
kvs-edge-agent/KvsEdgeComponent/recipes/recipe.yaml
kvs-edge-agent/KvsEdgeComponent/artifacts
kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent
kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion
kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/edge_log_config                   
kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/kvs-edge-agent.jar
kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/libgstkvssink.so
kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/libIngestorPipelineJNI.so
kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib
kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib/libcproducer.so
kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib/libKinesisVideoProducer.so
    注記

    リリースフォルダ名は、最新のバイナリリリース番号を反映するように設定する必要があります。たとえば、1.0.0 リリースでは、フォルダ名は 1.0.0 に設定されます。

  4. 依存関係 jar を構築します。

    注記

    kvs-edge-agent.tar.gz に含まれている jar には依存関係がありません。これらのライブラリを構築するには、次のステップを使用します。

    を含むkvs-edge-agentフォルダに移動しますpom.xml。

    タイプ mvn clean package。

    これにより、Amazon Kinesis Video Streams Edge Agent が で必要とする依存関係を含む jar ファイルが生成されますkvs-edge-agent/target/libs.jar。

  5. libs.jar をコンポーネントのアーティファクトを含むフォルダに配置します。

    タイプ mv ./target/libs.jar ./KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/。

  6. オプション。プロパティを設定します。Amazon Kinesis Video Streams Edge エージェントは、 モードで次の環境変数を受け入れます AWS IoT Greengrass 。

    環境変数名 必要 説明

    AWS_REGION

    はい

    使用されるリージョン。

    例： us-west-2

    AWS IoT Greengrass Core ソフトウェアは、この値を自動的に設定します。詳細については、「 AWS IoT Greengrass Version 2 デベロッパーガイド」の「コンポーネント環境変数リファレンス」トピックを参照してください。

    GST_PLUGIN_PATH

    はい

    gstkvssink およびIngestorPipelineJNIプラットフォーム依存ライブラリを含むフォルダを指すファイルパス。これにより、GStreamer はこれらのプラグインをロードできます。詳細については、「GStreamer 要素をダウンロード、構築、設定する」を参照してください。

    例: /download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/

    LD_LIBRARY_PATH

    はい

    cproducer およびKinesisVideoProducerプラットフォーム依存ライブラリを含むディレクトリを指すファイルパス。

    例: /download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib/

    AWS_KVS_EDGE_CLOUDWATCH_ENABLED

    いいえ

    Amazon Kinesis Video Streams Edge Agent がジョブのヘルスメトリクスを投稿するかどうかを決定します Amazon CloudWatch。

    使用できる値: TRUE/FALSE (大文字と小文字は区別されません）。指定FALSEしない場合、デフォルトは になります。

    例： FALSE

    AWS_KVS_EDGE_LOG_LEVEL

    いいえ

    Amazon Kinesis Video Streams Edge Agent 出力のログ記録のレベル。

    使用できる値:

    • VOFF

    • すべて

    • 致命的

    • ERROR

    • WARN

    • INFO、デフォルト、指定されていない場合

    • DEBUG

    • TRACE

    例: INFO

    AWS_KVS_EDGE_LOG_MAX_FILE_SIZE

    いいえ

    ログファイルがこのサイズに達すると、ロールオーバーが発生します。

    • 最小： 1

    • 最大： 100

    • デフォルト： 指定されていない場合は 20

    • 単位： メガバイト (MB)

    例： 5

    AWS_KVS_EDGE_LOG_OUTPUT_DIRECTORY

    いいえ

    Amazon Kinesis Video Streams Edge Agent ログが出力されるディレクトリを指すファイルパス。指定しない場合、デフォルト./logは になります。

    例: /file/path/

    AWS_KVS_EDGE_LOG_ROLLOVER_COUNT

    いいえ

    削除する前に保持するロールオーバーログの数。

    • 最小： 1

    • 最大： 100

    • デフォルト： 指定されていない場合は 10

    例： 20

    AWS_KVS_EDGE_RECORDING_DIRECTORY

    いいえ

    ディレクトリに記録されたメディアを指すファイルパスが書き込まれます。指定しない場合、デフォルトは現在のディレクトリになります。

    例: /file/path/

    GREENGRASS_ROOT_DIRECTORY

    いいえ

    AWS IoT Greengrass ルートディレクトリへのファイルパス。

    指定/greengrass/v2/しない場合、デフォルトで になります。

    例: /file/path/

    GST_DEBUG

    いいえ

    出力する GStreamer ログのレベルを指定します。詳細については、GStreamer ドキュメントを参照してください。

    例： 0

    GST_DEBUG_FILE

    いいえ

    GStreamer デバッグログの出力ファイルを指定します。設定されていない場合、デバッグログは標準エラーに出力されます。詳細については、GStreamer ドキュメントを参照してください。

    例: /tmp/gstreamer-logging.log

    実行スクリプトを開いてkvs-edge-agent/KvsEdgeComponent/recipes/recipe.yaml変更し、前述の環境変数を追加します。

    重要

    変更された実行スクリプトにタブ文字が含まれていないことを確認します。 AWS IoT Greengrass コアソフトウェアはレシピを読み取ることができません。

  7. Amazon Kinesis Video Streams Edge Agent AWS IoT Greengrass コンポーネントをデプロイします。

    タイプ:

    sudo /greengrass/v2/bin/greengrass-cli deployment create \
  --recipeDir <download location>/kvs-edge-agent/KvsEdgeComponent/recipes/ \
  --artifactDir <download location>/kvs-edge-agent/KvsEdgeComponent/artifacts/ \
  --merge "aws.kinesisvideo.KvsEdgeComponent=EdgeAgentVersion"

    詳細については、 AWS IoT Greengrass Version 2 デベロッパーガイドの以下のセクションを参照してください。

  8. を使用して設定をアプリケーションに送信します AWS CLI。

    1. 新しいファイル を作成しますexample-edge-configuration.json。

      ファイルに次のコードを貼り付けます。これは、毎日午前 9:00:00 から午後 4:59:59 まで ( AWS IoT デバイスのシステム時間に応じて) を記録するサンプル設定です。また、記録されたメディアを毎日午後 7:00:00 から午後 9:59:59 にアップロードします。

      詳細については、「StartEdgeConfigurationUpdate」を参照してください。

      {
    "StreamARN": "arn:aws:kinesisvideo:your-region:your-account-id:stream/your-stream/0123456789012",
    "EdgeConfig": {
        "HubDeviceArn": "arn:aws:iot:your-region:your-account-id:thing/kvs-edge-agent-demo",
        "RecorderConfig": {
            "MediaSourceConfig": {
                "MediaUriSecretArn": "arn:aws:secretsmanager:your-region:your-account-id:secret:your-secret-dRbHJQ",
                "MediaUriType": "RTSP_URI"
            },
            "ScheduleConfig": {
                "ScheduleExpression": "0 0 9,10,11,12,13,14,15,16 ? * * *",
                "DurationInSeconds": 3599
            }
        },
        "UploaderConfig": {
            "ScheduleConfig": {
                "ScheduleExpression": "0 0 19,20,21 ? * * *",
                "DurationInSeconds": 3599
            }
        },
        "DeletionConfig": {
            "EdgeRetentionInHours": 15,
            "LocalSizeConfig": {
              "MaxLocalMediaSizeInMB": 2800,
              "StrategyOnFullSize": "DELETE_OLDEST_MEDIA"
            },
            "DeleteAfterUpload": true
        }
    }
}

    2. に次のように入力 AWS CLI して、ファイルを Amazon Kinesis Video Streams Edge エージェントに送信します。

      aws kinesisvideo start-edge-configuration-update --cli-input-json "file://example-edge-configuration.json"

  9. Amazon Kinesis Video Streams Edge Agent のストリームごとに前のステップを繰り返します。