Crea l'agente Amazon Kinesis Video Streams Edge

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.

2. Verifica il checksum.

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

4. 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 contienepom.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

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

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

6. Imposta le variabili di ambiente utilizzando i valori dei passaggi precedenti. La tabella seguente fornisce le descrizioni delle variabili.

   Nome della variabile di ambiente	Richiesto	Descrizione
   AWS_REGION	Sì	La regione utilizzata. Esempio: us-west-2
   AWS_IOT_CA_CERT	Sì	Percorso del file del certificato CA utilizzato per stabilire un rapporto di fiducia con il servizio di backend tramite TLS. Esempio: /file/path/to/AmazonRootCA1.pem
   AWS_IOT_CORE_CERT	Sì	Percorso del file del certificato X.509. Esempio: /file/path/to/certificateID-certificate.pem.crt
   AWS_IOT_CORE_CREDENTIAL_ENDPOINT	Sì	L'endpoint del provider di AWS IoT Core credenziali per il tuo account. AWS Esempio: credential-account-specific-prefix.credentials.iot.aws-region.amazonaws.com
   AWS_IOT_CORE_DATA_ATS_ENDPOINT	Sì	L'endpoint del piano AWS IoT Core dati per il tuo account. AWS Esempio: data-account-specific-prefix.iot.aws-region.amazonaws.com
   AWS_IOT_CORE_PRIVATE_KEY	Sì	Percorso del file della chiave privata utilizzata nella coppia di chiavi pubblica/privata. Per ulteriori informazioni, vedere Gestione delle chiavi in. AWS IoT Esempio: /file/path/to/certificateID-private.pem.key
   AWS_IOT_CORE_ROLE_ALIAS	Sì	Il nome dell'alias del ruolo che punta al ruolo AWS IAM da utilizzare durante la connessione a. AWS IoT Core Esempio: kvs-edge-role-alias
   AWS_IOT_CORE_THING_NAME	Sì	Il nome dell' AWS IoT oggetto su cui viene eseguita l'applicazione. Esempio: my-edge-device-thing
   GST_PLUGIN_PATH	Sì	Percorso del file che punta alla cartella che contiene le librerie gstkvssink dipendenti dalla IngestorPipelineJNI piattaforma. Carichiamo questi plugin GStreamer . Per ulteriori informazioni, consulta Scarica, crea e configura l'elemento GStreamer. Esempio: /download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/
   LD_LIBRARY_PATH	Sì	Percorso del file che punta alla directory contenente le librerie dipendenti dalla cproducer KinesisVideoProducer piattaforma. Esempio: /download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib/
   AWS_KVS_EDGE_CLOUDWATCH_ENABLED	No	Determina se Amazon Kinesis Video Streams Edge Agent pubblicherà i parametri sullo stato del lavoro su. Amazon CloudWatch Valori accettati:TRUE/FALSE(senza distinzione tra maiuscole e minuscole). Il valore predefinito è FALSE se non fornito. Esempio: FALSE
   AWS_KVS_EDGE_LOG_LEVEL	No	Il livello di registrazione degli output di Amazon Kinesis Video Streams Edge Agent. Valori accettati: OFF ALL FATALI ERRORE WARN INFO, impostazione predefinita, se non fornita DEBUG TRACE Esempio: INFO
   AWS_KVS_EDGE_LOG_MAX_FILE_SIZE	No	Una volta che il file di registro raggiunge questa dimensione, si verificherà un rollover. Minimo: 0 Massimo: 10000 Valore predefinito: 20, se non fornito Unità: megabyte (MB) Esempio: 5
   AWS_KVS_EDGE_LOG_OUTPUT_DIRECTORY	No	Il percorso del file che punta alla directory in cui vengono emessi i log di Amazon Kinesis Video Streams Edge Agent. Il valore predefinito è se non fornito. ./log Esempio: /file/path/
   AWS_KVS_EDGE_LOG_ROLLOVER_COUNT	No	Il numero di registri sovrapposti da conservare prima dell'eliminazione. Minimo: 1 Massimo: 100 Valore predefinito: 10, se non fornito Esempio: 20
   AWS_KVS_EDGE_RECORDING_DIRECTORY	No	Verrà scritto il percorso del file che punta alla directory in cui vengono registrati i file multimediali. Il valore predefinito è la directory corrente se non viene fornita. Esempio: /file/path/
   GST_DEBUG	No	Specificate il livello di GStreamer log da emettere. Per ulteriori informazioni, consulta la documentazione relativa ad GStreamer . Esempio: 0
   GST_DEBUG_FILE	No	Specifica il file di output dei log di GStreamer debug. Se non è impostato, i log di debug vengono restituiti come errore standard. Per ulteriori informazioni, consulta la documentazione relativa ad GStreamer . Esempio: /tmp/gstreamer-logging.log

7. Svuota la cache. GStreamer Type:

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

   Per ulteriori informazioni, consulta la documentazione GStreamer del registro.

8. Preparare ed eseguire il comando java. L'agente Amazon Kinesis Video Streams Edge accetta i seguenti argomenti:

   Nome della proprietà Java	Richiesto	Description
   java.library.path	No	Percorso del file che punta alla cartella contenente le librerie gstkvssink e le librerie IngestorPipelineJNI dipendenti. Se non vengono fornite, Amazon Kinesis Video Streams Edge Agent le cercherà nella directory corrente. Importante L'agente Amazon Kinesis Video Streams Edge non funzionerà correttamente se non è in grado di individuare questi file. Esempio: /file/path/

   Per impostarli, aggiungili -Djava-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.

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

      {
          "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. 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"

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