View a markdown version of this page

Erstellen Sie den Amazon Kinesis Video Streams Edge Agent - 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.

Erstellen Sie den Amazon Kinesis Video Streams Edge Agent

Erstellen Sie den Amazon Kinesis Video Streams Edge Agent

  1. Laden Sie die tar Datei über den Link herunter, der Ihnen zur Verfügung gestellt wurde.

    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 im Lieferumfang von enthaltene JAR kvs-edge-agent.tar.gz enthält keine Abhängigkeiten. Gehen Sie wie folgt vor, um diese Bibliotheken zu erstellen.

    Navigieren Sie zu dem kvs-edge-agent Ordner, der 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 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. Legen Sie Umgebungsvariablen mit den Werten aus den vorherigen Schritten fest. Die folgende Tabelle enthält Beschreibungen der Variablen.

    Name der Umgebungsvariablen Erforderlich Beschreibung

    AWS_REGION

    Ja

    Die Region, die verwendet wird.

    Beispiel: us-west-2

    AWS_IOT_CA_CERT

    Ja

    Dateipfad zum CA-Zertifikat, das verwendet wird, um über TLS eine Vertrauensstellung mit dem Back-End-Dienst herzustellen.

    Beispiel: /file/path/to/AmazonRootCA1.pem

    AWS_IOT_CORE_CERT

    Ja

    Dateipfad zum X.509-Zertifikat.

    Beispiel: /file/path/to/certificateID-certificate.pem.crt

    AWS_IOT_CORE_CREDENTIAL_ENDPOINT

    Ja

    Der Endpoint Provider-Endpunkt für AWS IoT Core Anmeldeinformationen für Ihr AWS Konto.

    Beispiel: credential-account-specific-prefix.credentials.iot.aws-region.amazonaws.com

    AWS_IOT_CORE_DATA_ATS_ENDPOINT

    Ja

    Der Endpunkt der AWS IoT Core Datenebene für Ihr AWS Konto.

    Beispiel: data-account-specific-prefix.iot.aws-region.amazonaws.com

    AWS_IOT_CORE_PRIVATE_KEY

    Ja

    Dateipfad zu dem privaten Schlüssel, der im öffentlichen/privaten key pair verwendet wird. Weitere Informationen finden Sie unter Schlüsselverwaltung in. AWS IoT

    Beispiel: /file/path/to/certificateID-private.pem.key

    AWS_IOT_CORE_ROLE_ALIAS

    Ja

    Der Name des Rollenalias, der auf die AWS IAM-Rolle verweist, mit der eine Verbindung hergestellt werden soll AWS IoT Core.

    Beispiel: kvs-edge-role-alias

    AWS_IOT_CORE_THING_NAME

    Ja

    Der Name des Objekts AWS IoT , auf dem die Anwendung ausgeführt wird.

    Beispiel: my-edge-device-thing

    GST_PLUGIN_PATH

    Ja

    Dateipfad, der auf den Ordner verweist, der die gstkvssink und die IngestorPipelineJNI plattformabhängigen Bibliotheken enthält. Lassen Sie uns diese GStreamer Plugins laden. Weitere Informationen finden Sie unter Laden Sie das GStreamer Element herunter, erstellen 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 Statistiken zur Auftragsintegrität 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

    • 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 hat, erfolgt ein Rollover.

    • Min.: 0

    • Maximal: 10000

    • 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. Standardmäßig, ./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 aufgezeichnete Medien geschrieben werden. Standardmäßig wird das aktuelle Verzeichnis verwendet, falls es nicht angegeben wird.

    Beispiel: /file/path/

    GST_DEBUG

    Nein

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

    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

  7. Leeren Sie den GStreamer Cache. Type:

    rm ~/.cache/gstreamer-1.0/registry.your-os-architecture.bin

    Weitere Informationen finden Sie in der GStreamer Registrierungsdokumentation.

  8. Bereiten Sie den Java-Befehl vor und führen Sie ihn aus. Der Amazon Kinesis Video Streams Edge Agent akzeptiert die folgenden Argumente:

    Java-Eigenschaftsname Erforderlich Description

    java.library.path

    Nein

    Dateipfad, der auf den Ordner verweist, der die gstkvssink und die IngestorPipelineJNI abhängigen Bibliotheken enthält. Falls nicht angegeben, sucht der Amazon Kinesis Video Streams Edge Agent im aktuellen Verzeichnis nach ihnen.

    Wichtig

    Der Amazon Kinesis Video Streams Edge Agent funktioniert nicht richtig, wenn er diese Dateien nicht finden kann.

    Beispiel: /file/path/

    Um diese festzulegen, fügen Sie -Djava-property-name=value sie dem Java-Befehl hinzu, mit dem das JAR ausgeführt wurde.

    Beispiel:

    java -Djava.library.path=/download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion \
  --add-opens java.base/jdk.internal.misc=ALL-UNNAMED \
  -Dio.netty.tryReflectionSetAccessible=true \
  -cp kvs-edge-agent.jar:libs.jar \
  com.amazonaws.kinesisvideo.edge.controller.ControllerApp
    Wichtig

    Führen Sie den obigen Java-Befehl aus demselben Verzeichnis aus wie/download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion.

  9. 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. Um die Datei an den Amazon Kinesis Video Streams Edge Agent zu senden, geben Sie Folgendes in das AWS CLI Feld ein:

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

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