

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
<a name="gs-deploy-edge"></a>

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í.](https://pages.awscloud.com/GLOBAL-launch-DL-KVS-Edge-2023-learn.html)

1. Verifica la suma de verificación.

1. 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. 

1. 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 contiene`pom.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`

1. 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/`.

1. **Opcional.** Configure las propiedades. El agente Edge de Amazon Kinesis Video Streams acepta las siguientes variables de entorno AWS IoT Greengrass en el modo:    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/kinesisvideostreams/latest/dg/gs-deploy-edge.html)

   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.

1. Implemente el componente Amazon Kinesis Video Streams Edge AWS IoT Greengrass 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:*
   + [AWS IoT Greengrass Comandos CLI](https://docs.aws.amazon.com//greengrass/v2/developerguide/gg-cli-reference.html)
   + [Implemente AWS IoT Greengrass componentes en los dispositivos](https://docs.aws.amazon.com//greengrass/v2/developerguide/manage-deployments.html)

1. 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](API_StartEdgeConfigurationUpdate.md).

      ```
      {
          "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
              }
          }
      }
      ```

   1. 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"
      ```

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