Stellen Sie die Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent-Komponente auf dem Gerät bereit - Amazon Kinesis Video Streams

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Stellen Sie die Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent-Komponente auf dem Gerät bereit

Gehen Sie wie folgt vor, um die Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent-Komponente auf dem Gerät bereitzustellen:

Stellen Sie die Komponente bereit

  1. Laden Sie die tar Datei über den bereitgestellten Link herunter.

    Wenn Sie das Interessenformular für Amazon Kinesis Video Streams Edge Agent ausgefüllt haben, suchen Sie in Ihrer E-Mail nach dem Download-Link. Wenn Sie das Formular nicht ausgefüllt haben, füllen Sie es hier aus.

  2. Überprüfen Sie die Prüfsumme.

  3. Extrahieren Sie die Binärdateien und die JAR-Datei auf Ihrem Gerät.

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

    Nach dem Extrahieren sieht Ihre Ordnerstruktur wie folgt aus:

    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
    Anmerkung

    Der Name des Release-Ordners sollte so eingerichtet sein, dass er die neueste Binär-Versionsnummer widerspiegelt. Bei einer Version 1.0.0 wird der Ordnername beispielsweise auf 1.0.0 festgelegt.

  4. Erstellen Sie das Abhängigkeiten-Jar.

    Anmerkung

    Das in der Datei kvs-edge-agent .tar.gz enthaltene JAR hat die Abhängigkeiten nicht. Gehen Sie wie folgt vor, um diese Bibliotheken zu erstellen.

    Navigieren Sie zu dem kvs-edge-agent Ordner, der enthältpom.xml.

    Typ mvn clean package.

    Dadurch wird eine JAR-Datei generiert, die die Abhängigkeiten enthält, die der Amazon Kinesis Video Streams Edge Agent benötigt. kvs-edge-agent/target/libs.jar

  5. Platzieren Sie die Datei libs.jar in dem Ordner, der die Artefakte der Komponente enthält.

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

  6. Optional. Konfigurieren Sie die Eigenschaften. Der Amazon Kinesis Video Streams Edge Agent akzeptiert die folgenden Umgebungsvariablen im AWS IoT Greengrass Modus:

    Name der Umgebungsvariablen Erforderlich Beschreibung

    AWS_REGION

    Ja

    Die Region, die verwendet wird.

    Beispiel: us-west-2

    AWS IoT Greengrass Die Kernsoftware legt diesen Wert automatisch für Sie fest. Weitere Informationen finden Sie im Referenzthema „Umgebungsvariable für Komponenten“ im AWS IoT Greengrass Version 2 Entwicklerhandbuch.

    GST_PLUGIN_PATH

    Ja

    Dateipfad, der auf den Ordner verweist, der die gstkvssink und die IngestorPipelineJNI plattformabhängigen Bibliotheken enthält. Dadurch können diese Plugins GStreamer geladen werden. Weitere Informationen finden Sie unter Laden Sie das GStreamer Element herunter, erstellen Sie es und konfigurieren Sie es.

    Beispiel: /download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/

    LD_LIBRARY_PATH

    Ja

    Dateipfad, der auf das Verzeichnis verweist, das die cproducer und die KinesisVideoProducer plattformabhängigen Bibliotheken enthält.

    Beispiel: /download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib/

    AWS_KVS_EDGE_CLOUDWATCH_ENABLED

    Nein

    Legt fest, ob der Amazon Kinesis Video Streams Edge-Agent Jobstatus-Metriken auf Amazon CloudWatch veröffentlicht.

    Zulässige Werte:TRUE/FALSE(Groß- und Kleinschreibung wird nicht beachtet). Der Standardwert ist, FALSE falls nicht angegeben.

    Beispiel: FALSE

    AWS_KVS_EDGE_LOG_LEVEL

    Nein

    Die Ebene der Protokollierung der Amazon Kinesis Video Streams Edge Agent-Ausgaben.

    Zulässige Werte:

    • OFF

    • ALL

    • FATAL

    • ERROR

    • WARN

    • INFO, Standard, falls nicht angegeben

    • DEBUG

    • TRACE

    Beispiel: INFO

    AWS_KVS_EDGE_LOG_MAX_FILE_SIZE

    Nein

    Sobald die Protokolldatei diese Größe erreicht hat, erfolgt ein Rollover.

    • Min.: 1

    • Maximal: 100

    • Standard: 20, falls nicht angegeben

    • Einheiten: Megabyte (MB)

    Beispiel: 5

    AWS_KVS_EDGE_LOG_OUTPUT_DIRECTORY

    Nein

    Der Dateipfad, der auf das Verzeichnis verweist, in dem die Amazon Kinesis Video Streams Edge Agent-Protokolle ausgegeben werden. Der Standardwert ist, ./log falls nicht angegeben.

    Beispiel: /file/path/

    AWS_KVS_EDGE_LOG_ROLLOVER_COUNT

    Nein

    Die Anzahl der Rollover-Logs, die vor dem Löschen beibehalten werden sollen.

    • Min.: 1

    • Maximal: 100

    • Standard: 10, falls nicht angegeben

    Beispiel: 20

    AWS_KVS_EDGE_RECORDING_DIRECTORY

    Nein

    Dateipfad, der auf das Verzeichnis verweist, in das die aufgezeichneten Medien geschrieben werden. Standardmäßig wird das aktuelle Verzeichnis verwendet, falls nicht angegeben.

    Beispiel: /file/path/

    GREENGRASS_ROOT_DIRECTORY

    Nein

    Der Dateipfad zum AWS IoT Greengrass Stammverzeichnis.

    Dies ist standardmäßig, /greengrass/v2/ falls nicht angegeben.

    Beispiel: /file/path/

    GST_DEBUG

    Nein

    Gibt die Ebene der GStreamer auszugebenden Protokolle an. Weitere Informationen finden Sie in der GStreamerDokumentation.

    Beispiel: 0

    GST_DEBUG_FILE

    Nein

    Gibt die Ausgabedatei der GStreamer Debug-Logs an. Wenn diese Option nicht gesetzt ist, werden Debug-Logs mit dem Standardfehler ausgegeben. Weitere Informationen finden Sie in der GStreamer Dokumentation.

    Beispiel: /tmp/gstreamer-logging.log

    Öffnen kvs-edge-agent/KvsEdgeComponent/recipes/recipe.yaml und ändern Sie das Run-Skript, um eine der oben genannten Umgebungsvariablen hinzuzufügen.

    Wichtig

    Stellen Sie sicher, dass das geänderte Ausführungsskript keine Tabulatorzeichen enthält. Die AWS IoT Greengrass Kernsoftware wird das Rezept nicht lesen können.

  7. Stellen Sie die Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent-Komponente bereit.

    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"

    Weitere Informationen finden Sie in den folgenden Abschnitten des AWS IoT Greengrass Version 2 Entwicklerhandbuchs:

  8. Senden Sie Konfigurationen mit dem an die Anwendung AWS CLI.

    1. Erstellen Sie eine neue Datei,example-edge-configuration.json.

      Fügen Sie folgenden Code in die Datei ein. Dies ist eine Beispielkonfiguration, die täglich von 9:00:00 Uhr bis 16:59:59 Uhr aufzeichnet (je nach Systemzeit auf Ihrem Gerät). AWS IoT Außerdem werden die aufgezeichneten Medien täglich von 19:00:00 Uhr bis 21:59:59 Uhr hochgeladen.

      Weitere Informationen finden Sie unter 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. Geben Sie Folgendes in das Feld ein AWS CLI , um die Datei an den Amazon Kinesis Video Streams Edge Agent zu senden:

      aws kinesisvideo start-edge-configuration-update --cli-input-json "file://example-edge-configuration.json"

  9. Wiederholen Sie den vorherigen Schritt für jeden Stream für den Amazon Kinesis Video Streams Edge Agent.