本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
步骤 6:部署亚马逊 Kinesis Video Streams Edge 代理Amazon IoT Greengrass设备上的组件
部署亚马逊 Kinesis 视频流边缘代理Amazon IoT Greengrass设备上的组件
-
下载这个
tar
使用提供的链接提交文件。如果你填写了 Amazon Kinesis Video Streams Edge Agent 的兴趣表,请查看电子邮件中的下载链接。如果您还没有填写表格,请填写这里
。 验证校验和。
提取设备中的二进制文件和 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。
构建依赖关系 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
。将 libs.jar 放入包含组件构件的文件夹中。
键入
mv ./target/libs.jar ./KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/
。EdgeAgentVersion
/可选。配置属性。亚马逊 Kinesis Video Streams Edge Agent 接受以下环境变量Amazon IoT Greengrass模式:
环境变量名称 必填 描述 AWS_REGION
是
使用的区域。
示例:us-west-2
Amazon IoT Greengrass核心软件会自动为您设置此值。有关更多信息,请参阅组件环境变量引用中的话题Amazon 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
否
确定亚马逊 Kinesis Video Streams Edge Agent 是否会将工作健康指标发布到Amazon CloudWatch。
可接受的值:
TRUE
/FALSE
(不区分大小写)。默认为FALSE
如果未提供。示例:假的
AWS_KVS_EDGE_LOG_LEVEL
否
记录亚马逊 Kinesis Video Streams Edge Agent 输出的级别。
可接受的值:
-
OFF
-
ALL
-
致命
-
ERROR (错误)
-
WARN
-
INFO,如果未提供,则默认
-
DEBUG
-
跟踪
示例:
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
否
的文件路径Amazon 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
并修改运行脚本以添加上述任何环境变量。重要
确保修改后的运行脚本不包含任何内容选项卡人物。这个Amazon IoT Greengrass核心软件将无法读取食谱。
-
部署亚马逊 Kinesis 视频流边缘代理Amazon 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
"有关其他信息,请参阅中的以下部分Amazon IoT Greengrass Version 2开发者指南:
使用将配置发送到应用程序Amazon CLI。
创建一个新文件,
。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 } } }在中键入以下内容Amazon CLI将文件发送到亚马逊 Kinesis Video Streams Edge Agent:
aws kinesisvideo start-edge-configuration-update --cli-input-json "file://
example-edge-configuration
.json"
对亚马逊 Kinesis Video Streams Edge Agent 的每个直播重复前面的步骤。