第 8 步：构建并运行亚马逊 Kinesis Video Streams Edge Agent

构建并运行 Amazon Kinesis Video Streams 边缘代理

1. 使用提供给您的链接下载tar文件。

   如果你填写了 Amazon Kinesis Video Streams Edge Agent 意向表，请查看电子邮件中的下载链接。如果您尚未填写表格，请在此处填写。

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。

   注意

   随附的 jar kvs-edge-agent.tar.gz 没有依赖关系。使用以下步骤来构建这些库。

   导航到包含kvs-edge-agent的文件夹pom.xml。

   键入 mvn clean package。

   这将生成一个 jar 文件，其中包含亚马逊 Kinesis Video Streams Edge Agent 所需的kvs-edge-agent/target/libs.jar依赖项。

5. 将放libs.jar入包含组件构件的文件夹中。

   键入 mv ./target/libs.jar ./KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/。

6. 使用前面步骤中的值设置环境变量。下表提供了变量的描述。

   环境变量名	必需	描述
   AWS_REGION	是	使用的区域。 示例：us-west -2
   AWS_IOT_CA_CERT	是	用于通过 TLS 与后端服务建立信任的 CA 证书的文件路径。 示例：/file/path/to/AmazonRootCA1.pem
   AWS_IOT_CORE_CERT	是	X.509 证书的文件路径。 示例：/file/path/to/certificateID-certificate.pem.crt
   AWS_IOT_CORE_CREDENTIAL_ENDPOINT	是	您 Amazon 账户的Amazon IoT Core 凭证终端节点提供商终端节点。 示例：credential-account-specific-prefix.credentials.iot.aws-region.amazonaws.com
   AWS_IOT_CORE_DATA_ATS_ENDPOINT	是	您 Amazon 账户Amazon IoT Core 的数据平面终端节点。 示例：data-account-specific-prefix.iot.aws-region.amazonaws.com
   AWS_IOT_CORE_PRIVATE_KEY	是	公钥/私钥对中使用的私钥的文件路径。有关更多信息，请参阅中的密钥管理 Amazon IoT。 示例：/file/path/to/certificateID-private.pem.key
   AWS_IOT_CORE_ROLE_ALIAS	是	指向连接时要使用 Amazon 的 IAM 角色的角色别名的名称 Amazon IoT Core。 示例：kvs-edge-role-alias
   AWS_IOT_CORE_THING_NAME	是	正在运行应用程序 Amazon IoT 的事物的名称。 示例：my-edge-device-thing
   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 Video Streams Edge Agent 是否会将作业运行状况指标 Amazon CloudWatch发布到上。 可接受的值：TRUE/FALSE（不区分大小写）。FALSE如果未提供，则默认为。 示例：假
   AWS_KVS_EDGE_LOG_LEVEL	否	亚马逊 Kinesis Video Streams Video Streams Edge Agent 输出的记录级别。 可接受的值： 关闭 ALL 致命 错误 警告 信息，默认（如果未提供） 调试 跟踪 示例：INFO
   AWS_KVS_EDGE_LOG_MAX_FILE_SIZE	否	一旦日志文件达到此大小，就会发生翻转。 最小:0 最大：10000 默认值：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/
   GST_DEBUG	否	指定要输出的 GStreamer 日志的级别。有关更多信息，请参阅 gStreamer 文档。 示例：0
   GST_DEBUG_FILE	否	指定 GStreamer 调试日志的输出文件。如果未设置，则调试日志将输出为标准错误。有关更多信息，请参阅 gStreamer 文档。 示例：/tmp/gstreamer-logging.log

7. 清除 GStreamer 缓存。类型：

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

   有关更多信息，请参阅 gStreamer 注册表文档。

8. 准备并运行 java 命令。亚马逊 Kinesis Video Streams Edge Agent 接受以下参数：

   Java 属性名称	必需	描述
   java.library.path	否	指向包含gstkvssink和IngestorPipelineJNI依赖库的文件夹的文件路径。如果未提供，Amazon Kinesis Video Streams Edge Agent 将在当前目录中搜索它们。 重要 如果 Amazon Kinesis Video Streams Edge Agent 找不到这些文件，它将无法正常运行。 示例：/file/path/

   要设置这些，请-Djava-property-name=value添加到用于运行 jar 的 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。

9. 使用向应用程序发送配置 Amazon CLI。

   1. 创建一个新文件，example-edge-configuration.json。

      将以下代码粘贴到该文件中。这是一个配置示例，每天从上午 9:00:00 到下午 4:59:59（根据设备上的系统时间）进行记录。 Amazon 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. 要将文件发送到亚马逊 Kinesis Video Streams Edge Agent，请在中 Amazon CLI键入以下内容：

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

10. 对亚马逊 Kinesis Video Streams Edge Agent 的每个直播重复上一个步骤。