

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

# Implementa il componente Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent sul dispositivo
<a name="gs-deploy-edge"></a>

Effettua le seguenti operazioni per distribuire il componente Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent sul dispositivo:

**Distribuisci il componente**

1. Scarica il `tar` file utilizzando il link 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 jar incluso in 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 genererà un file jar contenente le dipendenze richieste da Amazon Kinesis Video Streams Edge Agent. `kvs-edge-agent/target/libs.jar`

1. Inserisci il file libs.jar nella cartella che contiene gli artefatti del componente.

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

1. **Facoltativo**. Configura le proprietà. Amazon Kinesis Video Streams Edge Agent accetta le seguenti variabili di ambiente AWS IoT Greengrass in modalità:    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/kinesisvideostreams/latest/dg/gs-deploy-edge.html)

   Apri `kvs-edge-agent/KvsEdgeComponent/recipes/recipe.yaml` e modifica lo script di esecuzione per aggiungere una qualsiasi delle variabili di ambiente precedenti.
**Importante**  
Assicuratevi che lo script di esecuzione modificato non contenga caratteri di **tabulazione**. Il software AWS IoT Greengrass principale non sarà in grado di leggere la ricetta.

1. Implementa il componente Amazon Kinesis Video Streams Edge Agent. AWS IoT Greengrass 

   Type:

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

   *Per ulteriori informazioni, consulta le seguenti sezioni della Guida per gli AWS IoT Greengrass Version 2 sviluppatori:*
   + [AWS IoT Greengrass Comandi CLI](https://docs.aws.amazon.com//greengrass/v2/developerguide/gg-cli-reference.html)
   + [Distribuisci AWS IoT Greengrass componenti nei dispositivi](https://docs.aws.amazon.com//greengrass/v2/developerguide/manage-deployments.html)

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. Digita quanto segue AWS CLI per inviare il file all'agente Amazon Kinesis Video Streams Edge:

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