Implementa il componente Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent sul dispositivo - Amazon Kinesis Video Streams

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

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.

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

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

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

  6. Facoltativo. Configura le proprietà. Amazon Kinesis Video Streams Edge Agent accetta le seguenti variabili di ambiente AWS IoT Greengrass in modalità:

    Nome della variabile di ambiente Richiesto Descrizione

    AWS_REGION

    Sì

    La regione utilizzata.

    Esempio: us-west-2

    AWS IoT Greengrass Il software principale imposta automaticamente questo valore per te. Per ulteriori informazioni, consultate l'argomento di riferimento relativo alla variabile di ambiente Component nella Guida per gli AWS IoT Greengrass Version 2 sviluppatori.

    GST_PLUGIN_PATH

    Sì

    Percorso del file che punta alla cartella contenente le librerie gstkvssink e quelle dipendenti dalla IngestorPipelineJNI piattaforma. Ciò consente GStreamer di caricare questi plugin. 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

    • FATAL

    • ERROR

    • WARN

    • INFO, predefinito, se non fornito

    • 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: 1

    • Massimo: 100

    • 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/

    GREENGRASS_ROOT_DIRECTORY

    No

    Il percorso del file alla AWS IoT Greengrass directory principale.

    Il valore predefinito è /greengrass/v2/ se non viene fornito.

    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

    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.

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

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

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