View a markdown version of this page

Stellen Sie den Amazon Kinesis Video Streams Edge Agent bereit AWS IoT Greengrass Komponente auf dem Gerät - 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 den Amazon Kinesis Video Streams Edge Agent bereit AWS IoT Greengrass Komponente auf dem Gerät

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 das Jar in 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 Jar mit den Abhängigkeiten.

    Anmerkung

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

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

    Geben Sie mvn clean package ein.

    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.

    Geben Sie mv ./target/libs.jar ./KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/ ein.

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

    Name der Umgebungsvariable 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 zur Komponenten-Umgebungsvariablen im AWS IoT Greengrass Version 2 Entwicklerhandbuch.

    GST_PLUGIN_PATH

    Ja

    Dateipfad, der auf den Ordner verweist, der die gstkvssink und IngestorPipelineJNI plattformabhängigen Bibliotheken enthält. Dadurch kann GStreamer diese Plugins laden. 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 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 Kennzahlen zum Jobstatus veröffentlicht. Amazon CloudWatch

    Zulässige Werte:TRUE/FALSE(Groß- und Kleinschreibung nicht beachten). Ist standardmäßig eingestellt, FALSE falls nicht angegeben.

    Beispiel: FALSE

    AWS_KVS_EDGE_LOG_LEVEL

    Nein

    Der Grad der Protokollierung der Amazon Kinesis Video Streams Edge Agent-Ausgaben.

    Zulässige Werte:

    • OFF

    • ALL

    • TÖDLICH

    • 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, findet ein Rollover statt.

    • 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. Die Standardeinstellung ist, ./log falls nicht angegeben.

    Beispiel: /file/path/

    AWS_KVS_EDGE_LOG_ROLLOVER_COUNT

    Nein

    Die Anzahl der Rollover-Protokolle, die vor dem Löschen aufbewahrt werden sollen.

    • Mindestbestellmenge: 1

    • Maximal: 100

    • Standard: 10, falls nicht angegeben

    Beispiel: 20

    AWS_KVS_EDGE_RECORDING_DIRECTORY

    Nein

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

    Beispiel: /file/path/

    GREENGRASS_ROOT_DIRECTORY

    Nein

    Der Dateipfad zum AWS IoT Greengrass Stammverzeichnis.

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

    Beispiel: /file/path/

    GST_DEBUG

    Nein

    Gibt die Ebene der auszugebenden GStreamer-Logs an. Weitere Informationen finden Sie in der GStreamer-Dokumentation.

    Beispiel: 0

    GST_DEBUG_FILE

    Nein

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

    Beispiel: /tmp/gstreamer-logging.log

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

    Wichtig

    Stellen Sie sicher, dass das geänderte Run-Skript 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 (je nach Systemzeit auf Ihrem Gerät) aufzeichnet. 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 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.