View a markdown version of this page

Implementa Amazon Kinesis Video Streams Edge Agent AWS IoT Greengrass componente 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 Amazon Kinesis Video Streams Edge Agent AWS IoT Greengrass componente sul dispositivo

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

Implementa 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 email per trovare il link per il download. Se non hai completato il modulo, compilalo qui.

  2. Verifica il checksum.

  3. Estrai i file binari e il jar nel tuo dispositivo.

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

    Dopo l'estrazione, la struttura delle cartelle sarà la 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 l'ultimo numero binario della versione. 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 nel file kvs-edge-agent.tar.gz non contiene le dipendenze. Usa i seguenti passaggi per creare quelle librerie.

    Accedere 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 in AWS IoT Greengrass 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, consulta l'argomento di riferimento sulle variabili di ambiente dei componenti nella Guida per AWS IoT Greengrass Version 2 gli sviluppatori.

    GST_PLUGIN_PATH

    Sì

    Percorso del file che punta alla cartella contenente le librerie gstkvssink e quelle dipendenti dalla IngestorPipelineJNI piattaforma. Questo permette a 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 e quelle dipendenti dalla cproducer piattaforma. KinesisVideoProducer

    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à le metriche 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

    • FATALE

    • 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: 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 generati 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 trasferiti 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 è stato registrato il file multimediale. 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

    Specifica il livello dei log di GStreamer da emettere. Per maggiori informazioni, consulta la documentazione di GStreamer.

    Esempio: 0

    GST_DEBUG_FILE

    No

    Specifica il file di output dei log di debug di GStreamer. Se non è impostato, i log di debug restituiscono un errore standard. Per maggiori informazioni, consulta la documentazione di 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. Distribuisci 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 nella 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:00 AM alle 16:59:59 PM (in base all'ora di sistema sul dispositivo). AWS IoT Inoltre, carica i file multimediali registrati ogni giorno dalle 19:00: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 ad Amazon Kinesis Video Streams Edge Agent:

      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.