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 für AWS IoT Greengrass Dieser Abschnitt enthält eine umfassende Anleitung zur Verwendung von Amazon Kinesis Video Streams mit AWS IoT Greengrass. Durch die Kombination dieser Dienste können Sie Videos effizient von Edge-Geräten in die Cloud streamen und so eine Vielzahl von Anwendungen in den Bereichen IoT, Überwachung und mehr ermöglichen. Sie finden detaillierte Informationen zu: + Einrichtung der -Entwicklungsumgebung + Einen Kinesis-Videostream erstellen + Eine Lambda-Funktion erstellen und verpacken + Konfiguration des Kinesis Video Streams Streams-Core-Geräts + Bereitstellung auf dem Kerngerät + Dein Stream wird verifiziert Gehen Sie wie folgt vor, um den Amazon Kinesis Video Streams Edge Agent bereitzustellen, AWS IoT Greengrass um Medien von IP-Kameras aufzunehmen und hochzuladen. **Topics** + [Erstellen Sie eine Ubuntu Amazon EC2 EC2-Instanz](gs-ubuntu.md) + [Richten Sie das AWS IoT Greengrass V2 Kerngerät auf dem Gerät ein](gs-setup-gg.md) + [Erstellen Sie die Amazon Kinesis Video Streams und AWS Secrets Manager Ressourcen für Ihre IP-Kamera RTSP URLs](gs-create-resources.md) + [Fügen Sie der Rolle Token Exchange Service (TES) Berechtigungen hinzu](gs-add-permissions.md) + [Installieren Sie die AWS IoT Greengrass Secret Manager-Komponente auf dem Gerät](gs-install-secrets-manager.md) + [Stellen Sie die Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent-Komponente auf dem Gerät bereit](gs-deploy-edge.md) + [Installieren Sie die AWS IoT Greengrass Log Manager-Komponente auf dem Gerät](gs-publish-edge.md) # Erstellen Sie eine Ubuntu Amazon EC2 EC2-Instanz Gehen Sie wie folgt vor, um eine Ubuntu Amazon EC2 EC2-Instance zu erstellen. **Erstellen Sie eine Ubuntu Amazon EC2 EC2-Instanz** 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon EC2 EC2-Konsole unter [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). Stellen Sie sicher, dass die entsprechende Region ausgewählt ist. 1. Wählen Sie **Launch Instance** aus. Füllen Sie die folgenden Felder aus: + **Name** — Geben Sie einen Namen für die Instanz ein. + **Anwendungs- und Betriebssystem-Images (Amazon Machine Image)** — Wählen Sie **Ubuntu** aus. + **Instanztyp** — Wählen Sie **t2.large** aus. + **Schlüsselpaar-Login** — Erstellen Sie Ihr eigenes key pair. + **Netzwerkeinstellungen** — Behalten Sie die Standardeinstellung bei. + **Speicher konfigurieren** — Erhöhen Sie das Volumen auf 256 GiB. + **Erweiterte Einstellungen** — Behalten Sie die Standardeinstellung bei. 1. Starten Sie die Instance und greifen Sie per SSH auf sie zu. Gehen Sie wie folgt vor: 1. Wählen Sie im linken Navigationsbereich **Instances** und dann die Instance-ID aus. 1. Wählen Sie oben rechts **Connect** aus. 1. Wählen Sie **SSH-Client** und folgen Sie den Anweisungen auf dem Bildschirm. 1. Öffnen Sie ein Terminal und navigieren Sie zur heruntergeladenen `.pem` Datei (wahrscheinlich in`~/Downloads`). 1. Wenn Sie diese Verfahren zum ersten Mal ausführen, erhalten Sie die Meldung „Die Authentizität des Hosts (...) kann nicht festgestellt werden“. Geben Sie **ja** ein. 1. Installieren Sie Systembibliotheken, um den Amazon Kinesis Video Streams Edge Agent auf der Instance zu erstellen. ``` wget -O- https://apt.corretto.aws/corretto.key | sudo apt-key add - sudo add-apt-repository 'deb https://apt.corretto.aws stable main' sudo apt-get update sudo apt-get install -y gcc libssl-dev libcurl4-openssl-dev liblog4cplus-dev \ libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \ gstreamer1.0-plugins-base-apps gstreamer1.0-plugins-bad \ gstreamer1.0-plugins-good gstreamer1.0-tools \ unzip java-11-amazon-corretto-jdk maven ``` **Wichtig** **Wenn Sie auf einem Bildschirm darüber informiert werden, dass einige Dienste neu gestartet werden müssen, drücken Sie die Eingabetaste, um Ok auszuwählen.** Weitere Informationen finden Sie im [https://docs.aws.amazon.com//corretto/latest/corretto-11-ug/generic-linux-install.html](https://docs.aws.amazon.com//corretto/latest/corretto-11-ug/generic-linux-install.html). # Richten Sie das AWS IoT Greengrass V2 Kerngerät auf dem Gerät ein Gehen Sie wie folgt vor, um die AWS IoT Greengrass Kern-Nucleus-Software auf der Amazon EC2 EC2-Instance zu installieren. **Richten Sie das AWS IoT Greengrass Core-Gerät ein** 1. Melden Sie sich bei AWS-Managementkonsole, an [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/). Stellen Sie sicher, dass die entsprechende Region ausgewählt ist. 1. Wählen Sie in der linken Navigation **Greengrass-Geräte**, **Core-Geräte** aus. 1. Wählen Sie **Ein Kerngerät einrichten** aus. 1. Führen Sie die Schritte auf dem Bildschirm aus. + **Schritt 1: Registrieren Sie ein Greengrass Core-Gerät**. Geben Sie einen Namen für das Gerät ein. + **Schritt 2: Zu einer Dinggruppe hinzufügen, um eine kontinuierliche Bereitstellung anzuwenden**. Wählen Sie **Keine Gruppe** aus. + **Schritt 3: Installieren Sie die Greengrass Core-Software**. Wählen Sie **Linux** aus. + **Schritt 3.1: Installieren Sie Java auf dem Gerät** Java ist als Teil von installiert[Erstellen Sie eine Ubuntu Amazon EC2 EC2-Instanz](gs-ubuntu.md). Kehren Sie zu diesem Schritt zurück, wenn Sie Java noch nicht installiert haben. + **Schritt 3.2: Kopieren Sie die AWS Anmeldeinformationen auf das Gerät** Öffnen Sie die `bash/zsh` Option und fügen Sie die Exportbefehle in die Amazon EC2 EC2-Instance ein. + **Schritt 3.3: Führen Sie das Installationsprogramm aus** 1. Kopieren Sie die Befehle Installer **herunterladen und Installer** **ausführen in der** Ubuntu Amazon EC2 EC2-Instance und führen Sie sie aus. **Anmerkung** Der Befehl **Run the installer** wird automatisch auf der Grundlage des Namens aktualisiert, den Sie in einem vorherigen Schritt ausgewählt haben. 1. Notieren Sie sich die Rolle des Token Exchange Service (TES), die erstellt wurde. Sie benötigen sie später. **Anmerkung** Standardmäßig heißt die erstellte Rolle **GreenGrassV2 TokenExchangeRole**. # Erstellen Sie die Amazon Kinesis Video Streams und AWS Secrets Manager Ressourcen für Ihre IP-Kamera RTSP URLs Gehen Sie wie folgt vor, um die Streams und Secrets zu erstellen, die in benötigt werden AWS Secrets Manager. Führen Sie diesen Schritt zuerst aus, da Sie ARNs die in den Richtlinien erstellten Ressourcen benötigen. ## Amazon Kinesis Video Streams erstellen Erstellen Sie Amazon Kinesis Video Streams mit der AWS-Managementkonsole AWS CLI, oder API. Öffnen Sie in der AWS-Managementkonsole die [Amazon Kinesis Video Streams Streams-Konsole](https://console.aws.amazon.com/kinesisvideo/home/). Wählen Sie in der linken Navigationsleiste **Videostreams** aus. Weitere Informationen finden Sie unter [Erstellen Sie einen Amazon Kinesis Kinesis-Videostream](gs-createstream.md). ## Erstelle Geheimnisse in AWS Secrets Manager Öffnen Sie in der AWS-Managementkonsole die [AWS Secrets Manager Konsole](https://console.aws.amazon.com/secretsmanager/landing). Wählen Sie in der linken Navigationsleiste **Secrets** aus. Vergewissern Sie sich, dass die entsprechende Region ausgewählt ist. 1. Wählen Sie **Store a new secret** (Ein neues Secret speichern). 1. **Schritt 1: Wählen Sie den geheimen Typ** + Wählen Sie **Anderer Geheimnistyp** aus. + Fügen Sie im Abschnitt **Schlüssel/Wert-Paare** ein Schlüssel-Wert-Paar hinzu. **Schlüssel**: `MediaURI` **Anmerkung** Der Schlüssel muss sein. `MediaURI` Dabei wird zwischen Groß- und Kleinschreibung unterschieden. Wenn Sie es falsch eingeben, funktioniert die Anwendung nicht. **Wert**:`Your MediaURI`. **Example** **Beispiel:**`rtsp://:/YourCameraMediaURI`. 1. **Schritt 2: Secret konfigurieren**. Geben Sie diesem Geheimnis einen Namen. Nennen Sie es, wie Sie wollen. 1. **Schritt 3: Rotation konfigurieren — optional**. Wählen Sie **Weiter** aus. 1. **Schritt 4: Überprüfen**. Wählen Sie **Store** (Speichern) aus. 1. Wenn Ihr Geheimnis nicht sofort angezeigt wird, klicken Sie auf die Schaltfläche „Aktualisieren“. Wählen Sie den Namen Ihres Geheimnisses. Notieren Sie sich den **geheimen ARN**. 1. Wiederholen Sie diesen Vorgang für jedes MediaURI, von dem Sie streamen möchten. **Anmerkung** Das AWS Netzwerk blockiert einige öffentliche RTSP-Quellen. Sie können nicht von der Amazon EC2 EC2-Instance aus darauf zugreifen oder wenn Sie unverwaltet laufen, während Sie mit dem VPN verbunden sind. Die RTSP-URL Ihrer Kamera sollte Videos im H.264-Format streamen. Die Fragmentdauer darf den unter genannten Grenzwert nicht überschreiten. [SDK-Kontingente für Produzenten](limits.md#producer-sdk-limits) Amazon Kinesis Video Streams Edge Agent unterstützt nur Video. Führen Sie `gst-discoverer-1.0 Your RtspUrl` das Programm aus, um sicherzustellen, dass Ihre Kamera von Ihrem Gerät aus erreichbar ist. Speichern Sie das ARNs für alle Streams und Geheimnisse, die Sie erstellt haben. Sie benötigen diese für den nächsten Schritt. # Fügen Sie der Rolle Token Exchange Service (TES) Berechtigungen hinzu Erteilen Sie dem Gerät, das die Rechte zum Einsehen der Geheimnisse annimmt, die Rolle des Token Exchange Service (TES). Dies ist erforderlich, damit die AWS Secrets Manager AWS IoT Greengrass Komponente ordnungsgemäß funktioniert. **Fügen Sie der TES-Rolle Berechtigungen hinzu** 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Wählen Sie im linken Navigationsbereich **Rollen** aus und suchen Sie nach der TES-Rolle, die Sie zuvor im Prozess erstellt haben. 1. Wählen Sie in der Dropdownliste **Berechtigungen hinzufügen** die Option **Richtlinien anhängen** aus. 1. Wählen Sie **Richtlinie erstellen** aus. 1. Scrollen Sie nach unten und wählen Sie **Bearbeiten** aus. 1. Wählen Sie im Richtlinieneditor **JSON** und bearbeiten Sie die Richtlinie. Ersetzen Sie die Richtlinie durch Folgendes: **Anmerkung** Ersetzen Sie `arn:aws:kinesisvideo:*:*:stream/streamName1/*` und `arn:aws:kinesisvideo:*:*:stream/streamName2/*` durch das ARNs für die Streams, die Sie in einem vorherigen Schritt erstellt haben. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "kinesisvideo:ListStreams" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "kinesisvideo:DescribeStream", "kinesisvideo:PutMedia", "kinesisvideo:TagStream", "kinesisvideo:GetDataEndpoint" ], "Resource": [ "arn:aws:kinesisvideo:*:*:stream/streamName1/*", "arn:aws:kinesisvideo:*:*:stream/streamName2/*" ] } ] } ``` ------ 1. Wählen Sie auf der Seite **Add tags** (Tags hinzufügen) die Option **Next: Review** (Weiter: Prüfen) aus. 1. Geben Sie Ihrer Richtlinie einen Namen und wählen Sie dann **Richtlinie erstellen** aus. Ein Beispiel für einen Richtliniennamen ist **KvsEdgeAccessPolicy**. 1. Schließen Sie die Registerkarte und kehren Sie zu der Registerkarte zurück, auf der Sie der TES-Rolle eine Richtlinie angehängt haben. Wählen Sie die Schaltfläche „Aktualisieren“ und suchen Sie dann nach der neu erstellten Richtlinie. Aktivieren Sie das Kontrollkästchen und wählen Sie **Richtlinien anhängen** aus. Auf dem nächsten Bildschirm sehen Sie den Hinweis, dass die **Richtlinie erfolgreich an die Rolle angehängt wurde.** 1. Erstellen Sie eine weitere Richtlinie und fügen Sie sie hinzu, diesmal für Ihre Geheimnisse. Ersetzen Sie die Richtlinie durch Folgendes: **Anmerkung** `arn:aws:secretsmanager:*:*:secret:*`Ersetzen Sie es durch das ARNs, das die MediaURI-Geheimnisse enthält, die Sie in erstellt haben. [Erstellen Sie die Amazon Kinesis Video Streams und AWS Secrets Manager Ressourcen für Ihre IP-Kamera RTSP URLs](gs-create-resources.md) ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "secretsmanager:GetSecretValue", "Resource": [ "arn:aws:secretsmanager:*:*:secret:*", "arn:aws:secretsmanager:*:*:secret:*" ] } ] } ``` ------ 1. Erstellen Sie eine weitere Richtlinie und fügen Sie sie hinzu, diesmal für Amazon CloudWatch Metriken. Ersetzen Sie die Richtlinie durch Folgendes: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "cloudwatch:PutMetricData" ], "Resource": [ "*" ] } ] } ``` ------ # Installieren Sie die AWS IoT Greengrass Secret Manager-Komponente auf dem Gerät Für den Amazon Kinesis Video Streams Edge Agent muss zuerst die AWS IoT Greengrass Secret Manager-Komponente auf dem Gerät installiert werden. **Installieren Sie die Secret Manager-Komponente** 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die AWS IoT Core Konsole unter [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/). Stellen Sie sicher, dass die entsprechende Region ausgewählt ist. 1. Wählen Sie in der linken Navigationsleiste **Greengrass-Geräte**, **Deployments** aus. Wählen Sie die Bereitstellung mit demselben Ziel wie die Bereitstellung, in der wir sie erstellt haben. [Richten Sie das AWS IoT Greengrass V2 Kerngerät auf dem Gerät ein](gs-setup-gg.md) 1. Wählen Sie in der Drop-down-Liste „**Aktionen**“ in der oberen rechten Ecke die Option **Überarbeiten** aus. Wählen Sie in dem daraufhin angezeigten Pop-up die Option Bereitstellung **überarbeiten** aus. 1. Füllen Sie die folgenden Abschnitte aus: + **Schritt 1: Geben Sie das Ziel an**. Wählen Sie **Weiter** aus. + **Schritt 2: Wählen Sie die Komponenten aus**. + Stellen Sie sicher, dass die **AWS.GreenGrass.cli-Komponente** ausgewählt ist. Deinstallieren Sie diese Komponente nicht. + Schalten Sie die Option **Nur ausgewählte Komponenten anzeigen** ein und suchen Sie nach **aws.greengrass. SecretManager**. + Markieren Sie das Kästchen neben **aws.greengrass. **SecretManager**und wählen Sie dann Weiter.** + **Schritt 3: Komponenten konfigurieren**. Konfigurieren Sie die AWS IoT Greengrass Secret Manager-Komponente so, dass sie die Secrets aus der AWS IoT Greengrass Umgebung herunterlädt. Wählen Sie **aws.greengrass aus. **SecretManager**Komponente und wählen Sie dann Komponente konfigurieren.** Aktualisieren Sie auf dem daraufhin angezeigten Bildschirm das AWS Secrets Manager ARNs Feld **Konfiguration zum Zusammenführen**. **Anmerkung** `arn:aws:secretsmanager:*:*:secret:*`Ersetzen Sie es durch das ARNs der Geheimnisse, die Sie in erstellt haben[Erstellen Sie die Amazon Kinesis Video Streams und AWS Secrets Manager Ressourcen für Ihre IP-Kamera RTSP URLs](gs-create-resources.md). ``` { "cloudSecrets": [ { "arn": "arn:aws:secretsmanager:*:*:secret:*" }, { "arn": "arn:aws:secretsmanager:*:*:secret:*" } ] } ``` **Anmerkung** `cloudSecrets`ist eine Liste von Objekten mit dem Schlüssel`arn`. Weitere Informationen finden Sie im Abschnitt zur [Secret Manager-Konfiguration](https://docs.aws.amazon.com//greengrass/v2/developerguide/secret-manager-component.html#secret-manager-component-configuration) im AWS IoT Greengrass Version 2 Entwicklerhandbuch. Wenn Sie fertig sind, wählen Sie **Bestätigen** und dann **Weiter**. + **Schritt 4: Konfigurieren Sie erweiterte Einstellungen**. Klicken Sie auf **Weiter**. + **Schritt 5: Überprüfen**. Wählen Sie **Bereitstellen** aus. 1. Vergewissern Sie sich, dass die AWS Secrets Manager Komponente und die Berechtigungen korrekt installiert wurden. Geben Sie auf der Ubuntu Amazon EC2 EC2-Instance ein, `sudo /greengrass/v2/bin/greengrass-cli component details --name aws.greengrass.SecretManager` um zu überprüfen, ob die Komponente die aktualisierte Konfiguration erhalten hat. 1. Untersuchen Sie die AWS IoT Greengrass Kernprotokolle. Geben Sie `sudo less /greengrass/v2/logs/greengrass.log` ein. Überprüfen Sie, ob Fehler bei der Bereitstellung vorliegen. Wenn ein Fehler aufgetreten ist, überarbeiten Sie die Bereitstellung, um die `aws.greengrass.SecretManager` Komponente zu entfernen. Geben Sie ein`sudo service greengrass restart`, um den AWS IoT Greengrass Hauptdienst neu zu starten. Wenn der Bereitstellungsfehler auf fehlende Berechtigungen zurückzuführen ist, überprüfen Sie den [Fügen Sie der Rolle Token Exchange Service (TES) Berechtigungen hinzu](gs-add-permissions.md) Abschnitt, um sicherzustellen, dass die TES-Rolle über die richtigen Berechtigungen verfügt. Wiederholen Sie dann diesen Abschnitt. 1. **Aktualisieren Sie die Secrets in der AWS IoT Greengrass Secret Manager-Komponente** **Wichtig** Die AWS IoT Greengrass Secret Manager-Komponente ruft Geheimnisse nur ab und speichert sie im Cache, wenn die Bereitstellung aktualisiert wird. Um die Geheimnisse der AWS IoT Greengrass Secret Manager-Komponente zu aktualisieren, folgen Sie den vorherigen Schritten 1—6 mit der folgenden Änderung. **Schritt 3: Komponenten konfigurieren**. Konfigurieren Sie die AWS IoT Greengrass Secret Manager-Komponente so, dass sie die Secrets aus der AWS IoT Greengrass Umgebung herunterlädt. Wählen Sie **aws.greengrass aus. **SecretManager**Komponente und wählen Sie dann Komponente konfigurieren.** Fügen Sie auf dem daraufhin angezeigten Bildschirm das `[""]` Feld **Pfade zurücksetzen** ein und aktualisieren Sie es AWS Secrets Manager ARNs im Feld **Konfiguration zum Zusammenführen**. Weitere Informationen finden Sie unter [Updates zurücksetzen](https://docs.aws.amazon.com//greengrass/v2/developerguide/update-component-configurations.html#reset-configuration-update). # 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](https://pages.awscloud.com/GLOBAL-launch-DL-KVS-Edge-2023-learn.html) aus. 1. Überprüfen Sie die Prüfsumme. 1. 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. 1. 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ält`pom.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` 1. 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. 1. **Optional**. Konfigurieren Sie Eigenschaften. Der Amazon Kinesis Video Streams Edge Agent akzeptiert die folgenden Umgebungsvariablen im AWS IoT Greengrass Modus: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kinesisvideostreams/latest/dg/gs-deploy-edge.html) Öffnen `kvs-edge-agent/KvsEdgeComponent/recipes/recipe.yaml` und ändern Sie das Run-Skript, um eine der obigen 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. 1. Stellen Sie die Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent-Komponente bereit. Type: ``` sudo /greengrass/v2/bin/greengrass-cli deployment create \ --recipeDir /kvs-edge-agent/KvsEdgeComponent/recipes/ \ --artifactDir /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:* + [AWS IoT Greengrass CLI-Befehle](https://docs.aws.amazon.com//greengrass/v2/developerguide/gg-cli-reference.html) + [Stellen Sie AWS IoT Greengrass Komponenten auf Geräten bereit](https://docs.aws.amazon.com//greengrass/v2/developerguide/manage-deployments.html) 1. 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](API_StartEdgeConfigurationUpdate.md). ``` { "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 } } } ``` 1. 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" ``` 1. Wiederholen Sie den vorherigen Schritt für jeden Stream für den Amazon Kinesis Video Streams Edge Agent. # Installieren Sie die AWS IoT Greengrass Log Manager-Komponente auf dem Gerät **Anmerkung** Beachten Sie die [CloudWatchKontingente](https://docs.aws.amazon.com//AmazonCloudWatch/latest/logs/cloudwatch_limits_cwl.html). Gehen Sie wie folgt vor, um die Amazon Kinesis Video Streams Edge Agent-Protokolle so zu konfigurieren, dass sie CloudWatch mithilfe der AWS IoT Greengrass Log-Manager-Komponente automatisch hochgeladen werden. Dieser Schritt ist optional. **Installieren Sie die AWS IoT Greengrass Log Manager-Komponente** 1. Vergewissern Sie sich, dass die AWS IoT Greengrass Geräterolle über die [entsprechenden Berechtigungen](https://docs.aws.amazon.com//greengrass/v2/developerguide/log-manager-component.html#log-manager-component-requirements) verfügt. 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Klicken Sie in der linken Navigationsleiste auf **Rollen**. 1. Wählen Sie den Namen der TES-Rolle, die in erstellt wurde[Richten Sie das AWS IoT Greengrass V2 Kerngerät auf dem Gerät ein](gs-setup-gg.md). Verwenden Sie bei Bedarf die Suchleiste. 1. Wählen Sie die `GreengrassV2TokenExchangeRoleAccess` Richtlinie aus. 1. Wählen Sie die Registerkarte JSON aus und vergewissern Sie sich, dass die Richtlinie wie folgt aussieht: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream", "logs:PutLogEvents", "logs:DescribeLogStreams", "s3:GetBucketLocation" ], "Resource": "*" } ] } ``` ------ 1. Wenn die `GreengrassV2TokenExchangeRoleAccess` Richtlinie nicht existiert oder einige erforderliche Berechtigungen fehlen, erstellen Sie eine neue IAM-Richtlinie mit diesen Berechtigungen und fügen Sie sie der TES-Rolle hinzu, die in [Richten Sie das AWS IoT Greengrass V2 Kerngerät auf dem Gerät ein](gs-setup-gg.md) erstellt wurde. 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die AWS IoT Core Konsole unter [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/). Stellen Sie sicher, dass die entsprechende Region ausgewählt ist. 1. Wählen Sie in der linken Navigationsleiste **Greengrass-Geräte**, **Deployments** aus. Wählen Sie die Bereitstellung mit demselben Ziel wie die Installation, in der Sie sie erstellt haben. [Richten Sie das AWS IoT Greengrass V2 Kerngerät auf dem Gerät ein](gs-setup-gg.md) 1. Wählen Sie in der oberen rechten Ecke **Aktionen** und anschließend **Überarbeiten** aus. Wählen Sie in dem daraufhin angezeigten Pop-up die Option Bereitstellung **überarbeiten** aus. 1. Füllen Sie die folgenden Abschnitte aus: 1. **Schritt 1: Geben Sie das Ziel an.** Wählen Sie **Weiter** aus. 1. **Schritt 2: Wählen Sie die Komponenten aus.** 1. **Stellen Sie sicher, dass die Komponente **aws.greengrass.cli und aws.greengrass vorhanden** sind. SecretManager**Komponenten sind immer noch ausgewählt. **Wichtig** Deinstallieren Sie diese Komponenten nicht. 1. Schalten Sie die Option **Nur ausgewählte Komponenten anzeigen** ein und suchen Sie nach **aws.greengrass. LogManager**. 1. Wählen Sie das Kästchen neben **aws.greengrass aus. **LogManager**und wählen Sie dann Weiter.** 1. **Schritt 3: Komponenten konfigurieren.** Konfigurieren Sie die AWS IoT Greengrass Log-Manager-Komponente so, dass sie die vom Amazon Kinesis Video Streams Edge Agent generierten Protokolle hochlädt. Wählen Sie **aws.greengrass aus. **LogManager**Komponente und wählen Sie dann Komponente konfigurieren.** Fügen Sie auf dem daraufhin angezeigten Bildschirm die folgende Log Manager-Konfiguration in das Feld **Zusammenzufügende Konfiguration** ein. ``` { "logsUploaderConfiguration": { "componentLogsConfigurationMap": { "aws.kinesisvideo.KvsEdgeComponent/java_kvs.log": { "diskSpaceLimit": "100", "diskSpaceLimitUnit": "MB", "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log", "logFileRegex": "java_kvs.log\\w*" }, "aws.kinesisvideo.KvsEdgeComponent/cpp_kvs_edge.log": { "diskSpaceLimit": "100", "diskSpaceLimitUnit": "MB", "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log", "logFileRegex": "cpp_kvs_edge.log\\w*" }, "aws.kinesisvideo.KvsEdgeComponent/cpp_kvssink.log": { "diskSpaceLimit": "100", "diskSpaceLimitUnit": "MB", "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log", "logFileRegex": "cpp_kvssink.log\\w*" }, "aws.kinesisvideo.KvsEdgeComponent/cpp_kvs_streams.log": { "diskSpaceLimit": "100", "diskSpaceLimitUnit": "MB", "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log", "logFileRegex": "cpp_kvs_streams.log\\w*" } } }, "periodicUploadIntervalSec": "1" } ``` **Wichtig** `logFileDirectoryPath`Bei der vorherigen Konfiguration wird davon ausgegangen, dass der Standardspeicherort für die Protokollausgabe verwendet wird. **Anmerkung** Weitere Informationen zu den einzelnen Parametern für die Log Manager-Konfiguration finden Sie im Abschnitt [Log Manager](https://docs.aws.amazon.com//greengrass/v2/developerguide/log-manager-component.html#log-manager-component-configuration) im AWS IoT Greengrass Version 2 Entwicklerhandbuch. Wenn Sie fertig sind, wählen Sie **Bestätigen** und dann **Weiter**. 1. **Schritt 4: Konfigurieren Sie erweiterte Einstellungen.** Klicken Sie auf **Weiter**. 1. **Schritt 5: Überprüfen.** Wählen Sie **Bereitstellen** aus. 1. Vergewissern Sie sich, dass die AWS Log Manager-Komponente und die entsprechenden Berechtigungen korrekt installiert wurden. 1. Geben Sie auf der Ubuntu Amazon EC2 EC2-Instance ein, `sudo /greengrass/v2/bin/greengrass-cli component details --name aws.greengrass.LogManager` um zu überprüfen, ob die Komponente die aktualisierte Konfiguration erhalten hat. 1. Untersuchen Sie die AWS IoT Greengrass Kernprotokolle. Geben Sie `sudo less /greengrass/v2/logs/greengrass.log` ein. Überprüfen Sie, ob Fehler bei der Bereitstellung vorliegen. Wenn ein Fehler aufgetreten ist, überarbeiten Sie die Bereitstellung, um die `aws.greengrass.LogManager` Komponente zu entfernen. Geben Sie ein`sudo service greengrass restart`, um den AWS IoT Greengrass Hauptdienst neu zu starten. Wenn der Bereitstellungsfehler auf fehlende Berechtigungen zurückzuführen ist, überprüfen [Fügen Sie der Rolle Token Exchange Service (TES) Berechtigungen hinzu](gs-add-permissions.md) Sie, ob die TES-Rolle über die erforderlichen Berechtigungen verfügt. Wiederholen Sie dann diesen Abschnitt.