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 エッジエージェントは、 AWS IoT Greengrass モードで次の環境変数を受け入れます。

    環境変数名 必要 説明

    AWS_REGION

    可能

    使用されるリージョン。

    例: us-west-2

    AWS IoT Greengrass コアソフトウェアは、この値を自動的に設定します。詳細については、 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 出力のログ記録レベル。

    使用できる値:

    • OFF

    • ALL

    • FATAL

    • 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. に以下を入力して、ファイルを Amazon Kinesis Video Streams エッジエージェント AWS CLI に送信します。

      aws kinesisvideo start-edge-configuration-update --cli-input-json "file://example-edge-configuration.json"
  9. Amazon Kinesis Video Streams Edge Agent のストリームごとに前のステップを繰り返します。