Implemente el componente Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent en el dispositivo - 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.

Implemente el componente Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent en el dispositivo

Haga lo siguiente para implementar el componente Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent en el dispositivo:

Implemente el componente

  1. Descargue el tar archivo mediante el enlace proporcionado.

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

  2. Verifica la suma de verificación.

  3. Extrae los archivos binarios y el tarro de tu 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 la última versión binaria. Por ejemplo, una versión 1.0.0 tendrá el nombre de la carpeta establecido como 1.0.0.

  4. Cree el tarro de dependencias.

    nota

    El contenedor incluido con el kvs-edge-agent archivo.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 generará 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. Coloque el archivo libs.jar en la carpeta que contiene los artefactos del componente.

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

  6. Opcional. Configure las propiedades. El agente Edge de Amazon Kinesis Video Streams acepta las siguientes variables de entorno AWS IoT Greengrass en el modo:

    Nombre de la variable de entorno Obligatoria Descripción

    AWS_REGION

    Sí

    La región que se utiliza.

    Ejemplo: us-west-2

    AWS IoT Greengrass El software principal establece este valor automáticamente. Para obtener más información, consulte el tema de referencia sobre las variables de entorno de los componentes en la Guía para AWS IoT Greengrass Version 2 desarrolladores.

    GST_PLUGIN_PATH

    Sí

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

    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 bibliotecas dependientes 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á las estadísticas Amazon CloudWatch del estado del trabajo.

    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

    • INFO, predeterminado, 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 transferirá.

    • Mínimo: 1

    • Máximo: 100

    • 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 en el que se generan los registros de Amazon Kinesis Video Streams Edge Agent. 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á el soporte grabado. El valor predeterminado es el directorio actual si no se proporciona.

    Ejemplo: /file/path/

    GREENGRASS_ROOT_DIRECTORY

    No

    La ruta del archivo al directorio AWS IoT Greengrass raíz.

    El valor predeterminado es /greengrass/v2/ si no se proporciona.

    Ejemplo: /file/path/

    GST_DEBUG

    No

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

    Ejemplo: 0

    GST_DEBUG_FILE

    No

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

    Ejemplo: /tmp/gstreamer-logging.log

    Abra kvs-edge-agent/KvsEdgeComponent/recipes/recipe.yaml y modifique el script de ejecución para añadir cualquiera de las variables de entorno anteriores.

    importante

    Asegúrese de que el script de ejecución modificado no contenga ningún carácter de tabulación. El software AWS IoT Greengrass principal no podrá leer la receta.

  7. Implemente el componente Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent.

    Tipo: 

    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"

    Para obtener información adicional, consulte las siguientes secciones de la Guía para AWS IoT Greengrass Version 2 desarrolladores:

  8. 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 del dispositivo). AWS IoT También carga el contenido multimedia grabado todos los días de 19:00 a 21:59:59 horas.

      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. Escriba lo siguiente AWS CLI para enviar el archivo al agente Edge de Amazon Kinesis Video Streams:

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

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