

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Crea l'agente Amazon Kinesis Video Streams Edge
<a name="gs-build-agent"></a>

**Crea l'agente Amazon Kinesis Video Streams Edge**

1. Scarica il `tar` file utilizzando il link che ti è stato fornito.

   Se hai completato il modulo di interesse per Amazon Kinesis Video Streams Edge Agent, controlla la tua e-mail per il link per il download. [Se non hai completato il modulo, completalo qui.](https://pages.awscloud.com/GLOBAL-launch-DL-KVS-Edge-2023-learn.html)

1. Verifica il checksum.

1. Estrai i file binari e il jar dal tuo dispositivo.

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

   Dopo l'estrazione, la struttura delle cartelle sarà simile alla seguente:

   ```
   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**  
Il nome della cartella di rilascio deve essere impostato in modo da riflettere il numero della versione binaria più recente. Ad esempio, una versione 1.0.0 avrà il nome della cartella impostato come 1.0.0. 

1. Crea il jar delle dipendenze. 
**Nota**  
Il barattolo incluso con `kvs-edge-agent.tar.gz` non ha le dipendenze. Usa i seguenti passaggi per creare quelle librerie.

   Vai alla `kvs-edge-agent` cartella che contiene`pom.xml`. 

   Tipo `mvn clean package`.

   Questo genera un file jar contenente le dipendenze richieste da Amazon Kinesis Video Streams Edge Agent. `kvs-edge-agent/target/libs.jar`

1. Inseriscilo `libs.jar` nella cartella che contiene gli artefatti del componente.

   Tipo `mv ./target/libs.jar ./KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/{{EdgeAgentVersion}}/`.

1. Imposta le variabili di ambiente utilizzando i valori dei passaggi precedenti. La tabella seguente fornisce le descrizioni delle variabili.    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/kinesisvideostreams/latest/dg/gs-build-agent.html)

1. Svuota la cache. GStreamer Type:

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

   Per ulteriori informazioni, consulta la [documentazione GStreamer del registro](https://gstreamer.freedesktop.org/documentation/gstreamer/gstregistry.html?gi-language=c).

1. Preparare ed eseguire il comando java. L'agente Amazon Kinesis Video Streams Edge accetta i seguenti argomenti:    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/kinesisvideostreams/latest/dg/gs-build-agent.html)

   Per impostarli, aggiungili `-D{{java-property-name}}={{value}}` al comando java usato per eseguire il jar.

   Esempio:

   ```
   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**  
Esegui il comando java precedente dalla stessa directory di`/{{download-location}}/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/{{EdgeAgentVersion}}`.

1. Invia le configurazioni all'applicazione utilizzando. AWS CLI

   1. Crea un nuovo file,`{{example-edge-configuration}}.json`. 

      Incolla il codice seguente nel file. Questa è una configurazione di esempio che registra ogni giorno dalle 9:00 alle 16:59:59 (in base all'ora di sistema sul dispositivo). AWS IoT Inoltre, carica i file multimediali registrati ogni giorno dalle 19:00 alle 21:59:59.

      Per ulteriori informazioni, consulta [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. Per inviare il file ad Amazon Kinesis Video Streams Edge Agent, digita quanto segue nel: AWS CLI

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

1. Ripeti il passaggio precedente per ogni stream per Amazon Kinesis Video Streams Edge Agent.