View a markdown version of this page

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

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

Implemente el componente

  1. Descargue el tar archivo mediante el enlace proporcionado.

    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 archivo jar incluido con el archivo 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 generará un archivo jar que contiene las dependencias en las que necesita 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 en AWS IoT Greengrass modo:

    Nombre de la variable de entorno Obligatorio Descripción

    AWS_REGION

    Sí

    La región que se usa.

    Ejemplo: us-west-2

    AWS IoT Greengrass El software principal establece automáticamente este valor para usted. Para obtener más información, consulte el tema de referencia sobre las variables de entorno de 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 que dependen de ella. Esto permite a GStreamer cargar 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 cproducer la KinesisVideoProducer 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: 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 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/

    GREENGRASS_ROOT_DIRECTORY

    No

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

    De forma predeterminada, es /greengrass/v2/ si no se proporciona.

    Ejemplo: /file/path/

    GST_DEBUG

    No

    Especifica el nivel de registros de GStreamer que se generarán. 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

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

    Escriba:

    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 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. Escriba lo siguiente en el campo 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 perimetral de Amazon Kinesis Video Streams.