Fase 6: Implementazione dell'agente Amazon Kinesis Video Streams EdgeAWS IoT Greengrasscomponente sul dispositivo - Flusso di video Amazon Kinesis

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

Fase 6: Implementazione dell'agente Amazon Kinesis Video Streams EdgeAWS IoT Greengrasscomponente sul dispositivo

Implementa l'agente Amazon Kinesis Video Streams EdgeAWS IoT Greengrasscomponente sul dispositivo

  1. Scarica iltarfile utilizzando il collegamento fornito.

    Se hai completato il modulo di interesse per Amazon Kinesis Video Streams Edge Agent, controlla la tua email per il link per il download. Se non hai completato il modulo, completaloqui.

  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 che rifletta il numero della versione binaria più recente. Ad esempio, una versione 1.0.0 avrà il nome della cartella impostato su 1.0.0.

  4. Costruisci il jar delle dipendenze.

    Nota

    Il barattolo è incluso conkvs-edge-agent.tar.gz non ha dipendenze. Usa i seguenti passaggi per creare queste librerie.

    Accedere allakvs-edge-agentcartella che contienepom.xml.

    Tipo mvn clean package.

    Questo genererà un file jar contenente le dipendenze richieste da Amazon Kinesis Video Streams Edge Agent all'indirizzokvs-edge-agent/target/libs.jar.

  5. Posiziona 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 inAWS IoT Greengrassmodalità:

    Nome della variabile di ambiente Campo obbligatorio Descrizione

    AWS_REGION

    Sì

    La regione utilizzata.

    Esempio:us-west-2

    AWS IoT GreengrassIl software principale imposta automaticamente questo valore per te. Per ulteriori informazioni, vedereRiferimento alla variabile di ambiente del componenteargomento nelAWS IoT Greengrass Version 2Guida per gli sviluppatori.

    GST_PLUGIN_PATH

    Sì

    Percorso del file che punta alla cartella contenentegstkvssinkeIngestorPipelineJNIlibrerie dipendenti dalla piattaforma. Ciò consente a GStreamer di caricare questi plugin. Per ulteriori informazioni, vedereScarica, 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 ilcproducereKinesisVideoProducerlibrerie dipendenti dalla 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à le metriche sullo stato del lavoro suAmazon CloudWatch.

    Valori accettati:TRUE/FALSE(insensibile alle maiuscole). Il valore predefinito èFALSEse non fornito.

    Esempio:FALSO

    AWS_KVS_EDGE_LOG_LEVEL

    No

    Il livello di registrazione delle uscite di Amazon Kinesis Video Streams Edge Agent.

    Valori accettati:

    • OFF

    • ALL

    • FATALI

    • ERROR

    • WARN

    • INFO, impostazione predefinita, se non fornita

    • DEBUG

    • TRACCIANO

    Esempio: INFO

    AWS_KVS_EDGE_LOG_MAX_FILE_SIZE

    No

    Una volta che il file di registro raggiunge queste dimensioni, si verificherà un rollover.

    • Minimo:1

    • Massimo:100

    • 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 è./logse non fornito.

    Esempio: /file/path/

    AWS_KVS_EDGE_LOG_ROLLOVER_COUNT

    No

    Il numero di registri accumulati da conservare prima dell'eliminazione.

    • Minimo:1

    • Massimo:100

    • 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 supporto. Il valore predefinito è la directory corrente se non viene fornita.

    Esempio: /file/path/

    GREENGRASS_ROOT_DIRECTORY

    No

    Il percorso del fileAWS IoT Greengrasscartella principale.

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

    Esempio: /file/path/

    GST_DEBUG

    No

    Specifica il livello dei log GStreamer da emettere. Per ulteriori informazioni, vedereDocumentazione GStreamer.

    Esempio:0

    GST_DEBUG_FILE

    No

    Specifica il file di output dei log di debug di GStreamer. Se non sono impostati, i log di debug restituiscono l'errore standard. Per ulteriori informazioni, vedereDocumentazione GStreamer.

    Esempio: /tmp/gstreamer-logging.log

    Apertokvs-edge-agent/KvsEdgeComponent/recipes/recipe.yamle modifica lo script di esecuzione per aggiungere una qualsiasi delle variabili di ambiente precedenti.

    Importante

    Assicurati che lo script di esecuzione modificato non ne contengalinguettapersonaggi. LaAWS IoT Greengrassil software di base non sarà in grado di leggere la ricetta.

  7. Implementa l'agente Amazon Kinesis Video Streams EdgeAWS IoT Greengrasscomponente.

    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, vedere le seguenti sezioni nelAWS IoT Greengrass Version 2Guida per gli sviluppatori:

  8. Inviare le configurazioni all'applicazione utilizzandoAWS 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 alle 16:59:59 (in base all'ora di sistema sul tuoAWS IoTdispositivo). 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 nelAWS CLIper 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.