View a markdown version of this page

Cree el agente Edge de Amazon Kinesis Video Streams - Amazon Kinesis Video Streams

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Cree el agente Edge de Amazon Kinesis Video Streams

Cree el agente Edge de Amazon Kinesis Video Streams

  1. Descargue el tar archivo mediante el enlace que se le proporcionó.

    Si rellenó el formulario de interés de Amazon Kinesis Video Streams Edge Agent, busque el enlace de descarga en su correo electrónico. Si no ha completado el formulario, rellénelo aquí.

  2. Verifique la suma de verificación.

  3. Extraiga los archivos binarios y el archivo jar de su dispositivo.

    Tipo: tar -xvf kvs-edge-agent.tar.gz.

    Tras la extracción, la estructura de carpetas tendrá el siguiente aspecto:

    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
    nota

    El nombre de la carpeta de publicación debe configurarse de forma que refleje el número de versión binario más reciente. Por ejemplo, una versión 1.0.0 tendrá el nombre de la carpeta establecido como 1.0.0.

  4. Crea el contenedor de dependencias.

    nota

    El contenedor incluido con el kvs-edge-agent.tar.gz no tiene las dependencias. Siga los pasos siguientes para crear esas bibliotecas.

    Navegue hasta la kvs-edge-agent carpeta que contienepom.xml.

    Escriba mvn clean package.

    Esto genera un archivo jar que contiene las dependencias en las que requiere el agente Edge de Amazon Kinesis Video Streams. kvs-edge-agent/target/libs.jar

  5. Colóquelo libs.jar en la carpeta que contiene los artefactos del componente.

    Escriba mv ./target/libs.jar ./KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/.

  6. Establezca las variables de entorno utilizando los valores de los pasos anteriores. En la siguiente tabla se proporcionan descripciones de las variables.

    Nombre de la variable de entorno Obligatorio Descripción

    AWS_REGION

    Sí

    La región que se usa.

    Ejemplo: us-west-2

    AWS_IOT_CA_CERT

    Sí

    Ruta del archivo al certificado de CA utilizado para establecer la confianza con el servicio de backend a través de TLS.

    Ejemplo: /file/path/to/AmazonRootCA1.pem

    AWS_IOT_CORE_CERT

    Sí

    Ruta del archivo al certificado. X.509

    Ejemplo: /file/path/to/certificateID-certificate.pem.crt

    AWS_IOT_CORE_CREDENTIAL_ENDPOINT

    Sí

    El punto final del proveedor de terminales de AWS IoT Core credenciales de su AWS cuenta.

    Ejemplo: credential-account-specific-prefix.credentials.iot.aws-region.amazonaws.com

    AWS_IOT_CORE_DATA_ATS_ENDPOINT

    Sí

    El punto final del plano de AWS IoT Core datos de su AWS cuenta.

    Ejemplo: data-account-specific-prefix.iot.aws-region.amazonaws.com

    AWS_IOT_CORE_PRIVATE_KEY

    Sí

    Ruta del archivo a la clave privada utilizada en el par de public/private claves. Para obtener más información, consulte Administración de claves en AWS IoT.

    Ejemplo: /file/path/to/certificateID-private.pem.key

    AWS_IOT_CORE_ROLE_ALIAS

    Sí

    El nombre del alias del rol que apunta al rol de AWS IAM que se va a usar al conectarse AWS IoT Core.

    Ejemplo: kvs-edge-role-alias

    AWS_IOT_CORE_THING_NAME

    Sí

    El nombre de la AWS IoT cosa en la que se ejecuta la aplicación.

    Ejemplo: my-edge-device-thing

    GST_PLUGIN_PATH

    Sí

    Ruta del archivo que apunta a la carpeta que contiene las bibliotecas gstkvssink dependientes de la IngestorPipelineJNI plataforma. Permite que GStreamer cargue estos complementos. Para obtener más información, consulte Descargue, cree y configure el elemento GStreamer.

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

    LD_LIBRARY_PATH

    Sí

    Ruta del archivo que apunta al directorio que contiene las bibliotecas dependientes de la KinesisVideoProducer plataforma cproducer y las que dependen de la plataforma.

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

    AWS_KVS_EDGE_CLOUDWATCH_ENABLED

    No

    Determina si el agente Edge de Amazon Kinesis Video Streams publicará en él las métricas del estado del trabajo. Amazon CloudWatch

    Valores aceptados:TRUE/FALSE(no distingue entre mayúsculas y minúsculas). El valor predeterminado es FALSE si no se proporciona.

    Ejemplo: FALSE

    AWS_KVS_EDGE_LOG_LEVEL

    No

    El nivel de registro de las salidas del agente Edge de Amazon Kinesis Video Streams.

    Valores aceptados:

    • OFF

    • ALL

    • FATAL

    • ERROR

    • WARN

    • INFORMACIÓN, predeterminada, si no se proporciona

    • DEBUG

    • TRACE

    Ejemplo: INFO

    AWS_KVS_EDGE_LOG_MAX_FILE_SIZE

    No

    Cuando el archivo de registro alcance este tamaño, se producirá una transferencia.

    • Mín: 0

    • Máx: 10000

    • Predeterminado: 20, si no se proporciona

    • Unidades: megabytes (MB)

    Ejemplo: 5

    AWS_KVS_EDGE_LOG_OUTPUT_DIRECTORY

    No

    La ruta del archivo que apunta al directorio donde se generan los registros del agente Edge de Amazon Kinesis Video Streams. El valor predeterminado es ./log si no se proporciona.

    Ejemplo: /file/path/

    AWS_KVS_EDGE_LOG_ROLLOVER_COUNT

    No

    El número de registros acumulados que se deben conservar antes de eliminarlos.

    • Mínimo: 1

    • Máximo: 100

    • Predeterminado: 10, si no se proporciona

    Ejemplo: 20

    AWS_KVS_EDGE_RECORDING_DIRECTORY

    No

    La ruta del archivo que apunta al directorio en el que se escribirán los medios grabados. De forma predeterminada, es el directorio actual si no se proporciona.

    Ejemplo: /file/path/

    GST_DEBUG

    No

    Especifica el nivel de registros de GStreamer que se van a generar. Para obtener más información, consulte la documentación de GStreamer.

    Ejemplo: 0

    GST_DEBUG_FILE

    No

    Especifica el archivo de salida de los registros de depuración de GStreamer. Si no se establece, los registros de depuración muestran un error estándar. Para obtener más información, consulte la documentación de GStreamer.

    Ejemplo: /tmp/gstreamer-logging.log

  7. Borre la memoria caché de GStreamer. Escriba:

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

    Para obtener más información, consulte la documentación de registro de GStreamer.

  8. Prepara y ejecuta el comando java. El agente Edge de Amazon Kinesis Video Streams acepta los siguientes argumentos:

    Nombre de la propiedad de Java Obligatorio Description (Descripción)

    java.library.path

    No

    Ruta del archivo que apunta a la carpeta que contiene gstkvssink las bibliotecas IngestorPipelineJNI dependientes. Si no se proporcionan, el agente Edge de Amazon Kinesis Video Streams las buscará en el directorio actual.

    importante

    El agente Edge de Amazon Kinesis Video Streams no funcionará correctamente si no puede localizar estos archivos.

    Ejemplo: /file/path/

    Para configurarlos, -Djava-property-name=value agréguelos al comando java utilizado para ejecutar el archivo jar.

    Por ejemplo:

    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
    importante

    Ejecute el comando java anterior desde el mismo directorio que/download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion.

  9. Envíe las configuraciones a la aplicación mediante AWS CLI.

    1. Cree un archivo nuevo,example-edge-configuration.json.

      Pegue el código siguiente en el archivo. Este es un ejemplo de configuración que graba todos los días desde las 9:00:00 a. m. hasta las 4:59:59 p. m. (según la hora del sistema de su dispositivo). AWS IoT También carga los archivos grabados todos los días entre las 19:00:00 y las 21:59:59.

      Para obtener más información, consulte 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. Para enviar el archivo al agente Edge de Amazon Kinesis Video Streams, escriba lo siguiente en: AWS CLI

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

  10. Repita el paso anterior para cada transmisión para el agente Edge de Amazon Kinesis Video Streams.