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 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.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. libs.jarColóquelo en la carpeta que contiene los artefactos del componente.

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

  6. Configure 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 utiliza.

    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 de conexión del proveedor de AWS IoT Core credenciales de su cuenta. AWS

    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 claves pública/privada. 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 del elemento AWS IoT en el 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 dependientes de la IngestorPipelineJNI plataforma gstkvssink y las bibliotecas dependientes de la plataforma. GStreamer Carguemos 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: FALSO

    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: 0

    • Máximo: 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 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/

    GST_DEBUG

    No

    Especifica el nivel de GStreamer registros 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 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 Documentación de GStreamer .

    Ejemplo: /tmp/gstreamer-logging.log

  7. Borra la GStreamer caché. Escriba:

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

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

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

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

    java.library.path

    No

    Ruta del archivo que apunta a la carpeta que contiene las bibliotecas gstkvssink y 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 encuentra estos archivos.

    Ejemplo: /file/path/

    Para configurarlos, agréguelos -Djava-property-name=value al comando java utilizado para ejecutar el 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 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. 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.