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

# Amazon Kinesis Video Streams Edge エージェントを構築する
<a name="gs-build-agent"></a>

**Amazon Kinesis Video Streams Edge エージェントを構築する**

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

   Amazon Kinesis Video Streams Edge Agent のインタレストフォームに記入した場合は、ダウンロードリンクの E メールを確認してください。フォームを完了していない場合は、[ここで](https://pages.awscloud.com/GLOBAL-launch-DL-KVS-Edge-2023-learn.html)入力します。

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

1. デバイス内のバイナリと 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 に設定されます。

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

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

   「`mvn clean package`」と入力します。

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

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

   「`mv ./target/libs.jar ./KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/{{EdgeAgentVersion}}/`」と入力します。

1. 前のステップの値を使用して環境変数を設定します。次の表に、変数の説明を示します。    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/kinesisvideostreams/latest/dg/gs-build-agent.html)

1. GStreamer キャッシュをクリアします。タイプ:

   ```
   rm ~/.cache/gstreamer-1.0/registry.{{your-os-architecture}}.bin
   ```

   詳細については、[GStreamer レジストリドキュメント](https://gstreamer.freedesktop.org/documentation/gstreamer/gstregistry.html?gi-language=c)を参照してください。

1. Java コマンドを準備して実行します。Amazon Kinesis Video Streams Edge エージェントは、次の引数を受け入れます。    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/kinesisvideostreams/latest/dg/gs-build-agent.html)

   これらを設定するには、jar `-D{{java-property-name}}={{value}}` の実行に使用される java コマンドに を追加します。

   例えば、次のようになります。

   ```
   java -Djava.library.path=/{{download-location}}/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/{{EdgeAgentVersion}} \
     --add-opens java.base/jdk.internal.misc=ALL-UNNAMED \
     -Dio.netty.tryReflectionSetAccessible=true \
     -cp kvs-edge-agent.jar:libs.jar \
     com.amazonaws.kinesisvideo.edge.controller.ControllerApp
   ```
**重要**  
上記の java コマンドを と同じディレクトリから実行します`/{{download-location}}/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/{{EdgeAgentVersion}}`。

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

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

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

      詳細については、「[StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md)」を参照してください。

      ```
      {
          "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
              }
          }
      }
      ```

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

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

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