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. # Planen Sie die Videoaufnahme und Speicherung mit dem Amazon Kinesis Video Streams Edge Agent Amazon Kinesis Video Streams bietet eine effiziente und kostengünstige Möglichkeit, eine Verbindung zu IP-Kameras vor Ort beim Kunden herzustellen. Mit dem Amazon Kinesis Video Streams Edge Agent können Sie Videos von den Kameras lokal aufnehmen und speichern und Videos nach einem vom Kunden definierten Zeitplan für die langfristige Speicherung, Wiedergabe und analytische Verarbeitung in die Cloud streamen. **Anmerkung** Füllen Sie dieses [kurze Formular](https://pages.awscloud.com/GLOBAL-launch-DL-KVS-Edge-2023-learn.html) aus, um auf den Amazon Kinesis Video Streams Edge Agent zuzugreifen. Sie können den Amazon Kinesis Video Streams Edge Agent herunterladen und ihn auf Ihren lokalen Edge-Computing-Geräten bereitstellen. Sie können sie auch problemlos in Docker-Containern bereitstellen, die auf Amazon EC2 EC2-Instances ausgeführt werden. Nach der Bereitstellung können Sie die Amazon Kinesis Video Streams Streams-API verwenden, um die Konfigurationen für Videoaufzeichnung und Cloud-Upload zu aktualisieren. Die Funktion funktioniert mit jeder IP-Kamera, die über das RTSP-Protokoll streamen kann. Es ist keine zusätzliche Firmware-Bereitstellung für die Kameras erforderlich. Wir bieten die folgenden Installationen für den Amazon Kinesis Video Streams Edge Agent an: + **Als AWS IoT Greengrass V2 Komponente:** Sie können den Amazon Kinesis Video Streams Edge Agent als AWS IoT Greengrass Komponente auf jedem AWS IoT Greengrass zertifizierten Gerät installieren. Weitere Informationen AWS IoT Greengrass dazu finden Sie im [AWS IoT Greengrass Version 2 Entwicklerhandbuch](https://docs.aws.amazon.com/greengrass/v2/developerguide/). + **An AWS Snowball Edge:** Sie können den Amazon Kinesis Video Streams Edge Agent auf Snowball Edge-Geräten ausführen. Weitere Informationen finden Sie im [AWS Snowball Edge Edge-Entwicklerhandbuch](https://docs.aws.amazon.com/snowball/latest/developer-guide/). + **Bei einer nativen AWS IoT Bereitstellung:** Sie können den Amazon Kinesis Video Streams Edge Agent nativ auf jeder Recheninstanz installieren. Das Edge SDK verwendet [AWS IoT Core](https://docs.aws.amazon.com//iot/latest/developerguide/iot-gs.html)für die Verwaltung von Edge über den. [Amazon Kinesis Video Streams](API_Operations_Amazon_Kinesis_Video_Streams.md) Um mit Amazon Kinesis Video Streams Edge Agent zu beginnen, fahren Sie mit den unten aufgeführten Verfahren fort. **Topics** + [ ## API-Operationen für Amazon Kinesis Video Streams Edge Agent ](#edge-apis) + [ ## Überwachen des Amazon Kinesis Video Streams Edge-Agenten ](#edge-monitoring) + [ # Im AWS IoT Greengrass Nicht-Modus bereitstellen ](gs-edge-outside.md) + [ # Stellen Sie den Amazon Kinesis Video Streams Edge Agent bereit für AWS IoT Greengrass ](gs-edge-gg.md) + [ # Häufig gestellte Fragen zu Amazon Kinesis Video Streams Edge Agent ](edge-faq.md) ## API-Operationen für Amazon Kinesis Video Streams Edge Agent Verwenden Sie die folgenden API-Operationen, um den Amazon Kinesis Video Streams Edge Agent zu konfigurieren: + [StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md) + [DescribeEdgeConfiguration](API_DescribeEdgeConfiguration.md) + [DeleteEdgeConfiguration](API_DeleteEdgeConfiguration.md) + [ListEdgeAgentConfigurations](API_ListEdgeAgentConfigurations.md) ## Überwachen des Amazon Kinesis Video Streams Edge-Agenten Informationen zur Überwachung Ihres Amazon Kinesis Video Streams Edge-Agenten finden Sie unter[Überwachen Sie den Amazon Kinesis Video Streams Edge Agent mit CloudWatch](monitoring-edge-cloudwatch.md). # Im AWS IoT Greengrass Nicht-Modus bereitstellen Dieser Abschnitt enthält eine umfassende Anleitung zur Verwendung von Amazon Kinesis Video Streams außerhalb der AWS IoT Greengrass Umgebung. Unabhängig davon, ob Sie mit Edge-Geräten oder anderen Plattformen arbeiten, helfen Ihnen diese Informationen dabei, Kinesis Video Streams effektiv einzurichten und zu nutzen. Sie finden detaillierte Informationen zu: + Einrichtung der -Entwicklungsumgebung + Einen Kinesis-Videostream erstellen + Herunterladen und Kompilieren des Kinesis Video Streams Producer SDK + Schreiben und Prüfen einer Beispielanwendung + Die Beispielanwendung ausführen Fahren Sie mit den folgenden Schritten fort, um den Amazon Kinesis Video Streams Edge Agent mit AWS IoT MQTT als eigenständige Bereitstellung auszuführen. **Topics** + [ # Abhängigkeiten installieren ](gs-install-dependencies.md) + [ # Erstellen Sie Ressourcen für Ihre IP-Kamera RTSP URLs ](gs-create-resources-standalone.md) + [ # Erstellen Sie eine IAM-Berechtigungsrichtlinie ](gs-iam-role.md) + [ # Erstellen einer IAM-Rolle ](gs-create-role.md) + [ # Erstellen Sie den Rollenalias AWS IoT ](gs-create-role-alias.md) + [ # Erstellen Sie die AWS IoT Richtlinie ](gs-create-policy.md) + [ # Erstelle ein AWS IoT Ding und erhalte AWS IoT Core Zugangsdaten ](gs-create-thing.md) + [ # Erstellen Sie den Amazon Kinesis Video Streams Edge Agent ](gs-build-agent.md) + [ # Installieren Sie den CloudWatch Agenten auf dem Gerät ](gs-install-cloudwatch.md) + [ # Führen Sie den Amazon Kinesis Video Streams Edge Agent als nativen Prozess aus ](gs-run.md) # Abhängigkeiten installieren Bevor Sie das Amazon Kinesis Video Streams Streams-Producer-SDK verwenden können, müssen Sie Ihre Entwicklungsumgebung mit den erforderlichen Abhängigkeiten einrichten. Diese Seite führt Sie durch den Prozess der Installation der erforderlichen Softwarekomponenten und Bibliotheken auf Ihrem System. **Anmerkung** Eine Liste der unterstützten Betriebssysteme finden Sie unter[Welche Betriebssysteme unterstützt Amazon Kinesis Video Streams Edge Agent?](edge-faq.md#edge-faq-os). **Installieren Sie Abhängigkeiten auf dem Gerät** 1. Um den Amazon Kinesis Video Streams Edge Agent auszuführen, installieren Sie die folgenden geeigneten Bibliotheken auf Ihrem Gerät: ------ #### [ Ubuntu ] Type: ``` 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 ``` ------ #### [ Amazon Linux 2 ] Type: ``` sudo yum update -y && sudo yum upgrade -y && sudo yum clean all -y sudo yum install -y gcc-c++ openssl-devel libcurl-devel gstreamer1* wget \ java-11-amazon-corretto tar ``` Installieren Sie `log4cplus-2.1.0` von der Quelle aus. ``` wget https://github.com/log4cplus/log4cplus/releases/download/REL_2_1_0/log4cplus-2.1.0.tar.gz tar -xzvf log4cplus-2.1.0.tar.gz cd log4cplus-2.1.0 && \ mkdir build && \ cd build && \ cmake .. && \ sudo make && \ sudo make install ``` `apache-maven-3.9.2`Von der Quelle aus installieren. ``` wget https://dlcdn.apache.org/maven/maven-3/3.9.2/binaries/apache-maven-3.9.2-bin.tar.gz RUN tar -xzvf apache-maven-3.9.2-bin.tar.gz -C /opt ``` ------ **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). 1. Installieren Sie das. AWS Command Line Interface Informationen zur [Installation oder Aktualisierung der neuesten Version der AWS CLI](https://docs.aws.amazon.com//cli/latest/userguide/getting-started-install.html) Verfahren finden Sie im *AWS Command Line Interface Benutzerhandbuch*. # Erstellen Sie Ressourcen für Ihre IP-Kamera RTSP URLs Gehen Sie wie folgt vor, um die Streams und Secrets zu erstellen, die in AWS Secrets Manager benötigt werden. 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. # Erstellen Sie eine IAM-Berechtigungsrichtlinie Gehen Sie wie folgt vor, um eine IAM-Richtlinie zu erstellen. Diese Berechtigungsrichtlinie ermöglicht die selektive Zugriffskontrolle (eine Teilmenge der unterstützten Operationen) für eine AWS Ressource. In diesem Fall handelt es sich bei den AWS Ressourcen um die Videostreams, zu denen der Amazon Kinesis Video Streams Edge Agent streamen soll. Zu den Ressourcen gehören auch die AWS Secrets Manager Geheimnisse, die der Amazon Kinesis Video Streams Edge Agent abrufen kann. Weitere Informationen finden Sie unter [IAM-Richtlinien](https://docs.aws.amazon.com//IAM/latest/UserGuide/access_policies.html). **Erstellen Sie eine Richtlinie mithilfe des JSON-Richtlinien-Editors** 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 **Richtlinien** aus. Wenn Sie zum ersten Mal **Policies (Richtlinien)** auswählen, erscheint die Seite **Welcome to Managed Policies (Willkommen bei verwalteten Richtlinien)**. Wählen Sie **Get Started**. 1. Wählen Sie oben auf der Seite **Create policy (Richtlinie erstellen)** aus. 1. Wählen Sie im Bereich **Policy editor** (Richtlinien-Editor) die Option **JSON** aus. 1. Geben Sie folgendes JSON-Richtliniendokument ein: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "cloudwatch:PutMetricData", "kinesisvideo:ListStreams", "iot:Connect", "iot:Publish", "iot:Subscribe", "iot:Receive" ], "Resource": [ "*" ] }, { "Effect": "Allow", "Action": [ "kinesisvideo:DescribeStream", "kinesisvideo:PutMedia", "kinesisvideo:TagStream", "kinesisvideo:GetDataEndpoint" ], "Resource": [ "arn:aws:kinesisvideo:*:*:stream/streamName1/*", "arn:aws:kinesisvideo:*:*:stream/streamName2/*" ] }, { "Effect": "Allow", "Action": "secretsmanager:GetSecretValue", "Resource": [ "arn:aws:secretsmanager:*:*:secret:*", "arn:aws:secretsmanager:*:*:secret:*" ] } ] } ``` ------ **Anmerkung** Ersetzen Sie `arn:aws:kinesisvideo:*:*:stream/streamName1/*` und `arn:aws:kinesisvideo:*:*:stream/streamName2/*` durch das ARNs für die Videostreams und `arn:aws:secretsmanager:*:*:secret:*` ersetzen Sie es durch das, ARNs das die MediaURI-Secrets enthält, die Sie in erstellt haben. [Erstellen Sie Ressourcen für Ihre IP-Kamera RTSP URLs](gs-create-resources-standalone.md) Verwenden Sie die ARNs für die Geheimnisse, auf die der Amazon Kinesis Video Streams Edge Agent zugreifen soll. 1. Wählen Sie **Weiter** aus. **Anmerkung** Sie können jederzeit zwischen den Editoroptionen **Visual** und **JSON** wechseln. Wenn Sie jedoch Änderungen vornehmen oder im **Visual**-Editor **Weiter** wählen, strukturiert IAM Ihre Richtlinie möglicherweise um, um sie für den visuellen Editor zu optimieren. Weitere Informationen finden Sie unter [Policy-Restrukturierung](https://docs.aws.amazon.com//IAM/latest/UserGuide/troubleshoot_policies.html#troubleshoot_viseditor-restructure) im IAM-Benutzerhandbuch. 1. Geben Sie auf der Seite **Überprüfen und erstellen** einen **Richtliniennamen** und optional eine **Beschreibung** für die Richtlinie ein, die Sie erstellen. Überprüfen Sie **Permissions defined in this policy** (In dieser Richtlinie definierte Berechtigungen), um die Berechtigungen einzusehen, die von Ihrer Richtlinie gewährt werden. 1. Wählen Sie **Create policy** (Richtlinie erstellen) aus, um Ihre neue Richtlinie zu speichern. # Erstellen einer IAM-Rolle Die Rolle, die Sie in diesem Schritt erstellen, kann von AWS IoT übernommen werden, um temporäre Anmeldeinformationen von AWS -Security-Token-Service (AWS STS) zu erhalten. Dies erfolgt bei der Ausführung von Autorisierungsanfragen für Anmeldeinformationen vom Amazon Kinesis Video Streams Edge Agent. **Erstellen Sie die Servicerolle für Amazon Kinesis Video Streams (IAM-Konsole)** 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 im Navigationsbereich der IAM-Konsole auf **Rollen**, und wählen Sie dann **Rolle erstellen**. 1. Wählen Sie den Rollentyp **Benutzerdefinierte Vertrauensrichtlinie** und fügen Sie die folgende Richtlinie ein: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": { "Effect": "Allow", "Principal": { "Service": "credentials.iot.amazonaws.com" }, "Action": "sts:AssumeRole" } } ``` ------ 1. Wählen Sie das Kästchen neben der IAM-Richtlinie aus, die Sie in [Erstellen Sie eine IAM-Berechtigungsrichtlinie](gs-iam-role.md) erstellt haben. 1. Wählen Sie **Weiter** aus. 1. Geben Sie einen Rollennamen oder ein Rollennamensuffix ein, damit Sie den Zweck dieser Rolle leichter erkennen können. **Example** **Beispiel**: `KvsEdgeAgentRole` 1. (Optional) Geben Sie unter **Role description** (Rollenbeschreibung) eine Beschreibung für die neue Rolle ein. 1. (Optional) Fügen Sie der Rolle Metadaten hinzu, indem Sie Tags als Schlüssel/Wert-Paare anhängen. Weitere Informationen zur Verwendung von Tags in IAM finden Sie unter [Tagging IAM-Ressourcen im IAM-Benutzerhandbuch](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_tags.html). 1. Prüfen Sie die Rolle und klicken Sie dann auf **Rolle erstellen**. # Erstellen Sie den Rollenalias AWS IoT Gehen Sie wie folgt vor, um einen AWS IoT Rollenalias für die IAM-Rolle zu erstellen, die Sie in erstellt haben. [Erstellen einer IAM-Rolle](gs-create-role.md) Ein Rollenalias ist ein alternatives Datenmodell, das auf die IAM-Rolle verweist. Eine Anfrage eines Anbieters für AWS IoT Anmeldeinformationen muss einen Rollenalias enthalten, der angibt, welche IAM-Rolle übernommen werden soll, um temporäre Anmeldeinformationen von AWS -Security-Token-Service ()AWS STS zu erhalten. Weitere Informationen finden Sie unter [So verwenden Sie ein Zertifikat, um ein Sicherheitstoken zu erhalten](https://docs.aws.amazon.com//iot/latest/developerguide/authorizing-direct-aws.html#authorizing-direct-aws.walkthrough). **Erstellen Sie den AWS IoT Rollenalias** 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/). 1. Stellen Sie sicher, dass die entsprechende Region ausgewählt ist. 1. Wählen Sie in der linken Navigationsleiste **Sicherheit** und dann **Rollenaliase** aus. 1. Wählen Sie **Rollenalias erstellen** aus. 1. Geben Sie einen Namen für Ihren Rollenalias ein. **Example** **Beispiel**: `KvsEdgeAgentRoleAlias` 1. Wählen Sie in der Dropdownliste **Rolle** die IAM-Rolle aus, in der Sie sie erstellt haben. [Erstellen einer IAM-Rolle](gs-create-role.md) 1. Wählen Sie **Erstellen** aus. Auf der nächsten Seite sehen Sie einen Hinweis, dass Ihr Rollenalias erfolgreich erstellt wurde. 1. Suchen Sie nach dem neu erstellten Rollenalias und wählen Sie ihn aus. Notieren Sie sich den **Rollenalias ARN**. Sie benötigen dies für die AWS IoT Richtlinie im nächsten Schritt. # Erstellen Sie die AWS IoT Richtlinie Gehen Sie wie folgt vor, um eine AWS IoT Richtlinie zu erstellen, die an das Gerätezertifikat angehängt wird. Dadurch erhalten Sie Berechtigungen für AWS IoT Funktionen und können mithilfe des Zertifikats den Rollenalias übernehmen. Mithilfe von AWS IoT Core Richtlinien können Sie den Zugriff auf die AWS IoT Core Datenebene steuern. Die AWS IoT Core Datenebene besteht aus Operationen, mit denen Sie Folgendes ausführen können: + Connect zum AWS IoT Core Message Broker her + Senden und Empfangen von MQTT-Nachrichten + Ruft den Geräteschatten eines Dings ab oder aktualisiert ihn Weitere Informationen finden Sie unter [AWS IoT Core Richtlinien](https://docs.aws.amazon.com//iot/latest/developerguide/iot-policies.html). **Verwenden Sie den AWS IoT Richtlinien-Editor, um eine AWS IoT Richtlinie zu erstellen** 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/). 1. Wählen Sie im linken Navigationsbereich **Sicherheit** und dann **Richtlinien** aus. 1. Wählen Sie **Richtlinie erstellen** aus. 1. Geben Sie einen Namen für Ihre Richtlinie ein. **Example** Ein Beispiel für einen Richtliniennamen ist **KvsEdgeAccessIoTPolicy**. 1. (Optional) Fügen Sie der Richtlinie Metadaten hinzu, indem Sie Tags als Schlüssel-Wert-Paare anfügen. Weitere Informationen zur Verwendung von Tags in IAM finden Sie unter [Tagging your AWS IoT resources](https://docs.aws.amazon.com//iot/latest/developerguide/tagging-iot.html) im *AWS IoT Core Developer* Guide. 1. Wählen Sie den Tab **JSON**. 1. Fügen Sie das folgende JSON-Richtliniendokument ein: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:Connect", "iot:Publish", "iot:Subscribe", "iot:Receive" ], "Resource": [ "*" ] }, { "Effect": "Allow", "Action": [ "sts:AssumeRoleWithWebIdentity" ], "Resource": "arn:aws:iot:us-west-2:123456789012:rolealias/your-role-alias" } ] } ``` ------ **Anmerkung** `your-role-alias-arn`Ersetzen Sie es durch den ARN des Rollenalias, in dem Sie ihn erstellt haben[Erstellen Sie den Rollenalias AWS IoT](gs-create-role-alias.md). 1. Wählen Sie **Erstellen**, um Ihre Arbeit zu speichern. # Erstelle ein AWS IoT Ding und erhalte AWS IoT Core Zugangsdaten Zu diesem Zeitpunkt haben Sie Folgendes erstellt: + Eine IAM-Berechtigungsrichtlinie. Siehe [Erstellen Sie eine IAM-Berechtigungsrichtlinie](gs-iam-role.md). + Eine IAM-Rolle mit angehängter Berechtigungsrichtlinie. Siehe [Erstellen einer IAM-Rolle](gs-create-role.md). + Ein AWS IoT Rollenalias für die IAM-Rolle. Siehe [Erstellen Sie den Rollenalias AWS IoT](gs-create-role-alias.md). + Eine AWS IoT Richtlinie, die derzeit keiner AWS Ressource zugeordnet ist. Siehe [Erstellen Sie die AWS IoT Richtlinie](gs-create-policy.md). **Um eine AWS IoT Sache zu erstellen und zu registrieren und AWS IoT Core Zugangsdaten zu erhalten** 1. Registrieren Sie das Gerät als ein AWS IoT Ding und generieren Sie das X.509-Zertifikat für das Gerät. 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/). 1. Wählen Sie die entsprechende Region aus. 1. Wählen Sie in der linken Navigationsleiste **Alle Geräte** und dann **Dinge** aus. 1. Wähle „**Dinge erstellen**“. 1. Wähle „**Einzelnes Ding erstellen**“ und dann „**Weiter**“. 1. **Schritt 1. Geben Sie die Eigenschaften der Dinge an** Geben Sie einen Namen für Ihr Ding ein und wählen Sie dann **Weiter**. 1. **Schritt 2. Gerätezertifikat konfigurieren** Wählen Sie **Neues Zertifikat automatisch generieren (empfohlen)** und dann **Weiter** aus. 1. **Schritt 3. Ordnen Sie dem Zertifikat Richtlinien zu** Suchen Sie nach der Berechtigungsrichtlinie, die Sie in erstellt haben[Erstellen Sie die AWS IoT Richtlinie](gs-create-policy.md). Aktivieren Sie das Kontrollkästchen neben Ihrer Richtlinie und wählen Sie **Ding erstellen** aus. 1. Laden Sie in dem daraufhin angezeigten Fenster die folgenden Dateien herunter: + Gerätezertifikat. Dies ist das X.509-Zertifikat. + Öffentliche Schlüsseldatei + Datei mit privatem Schlüssel + Amazon Trust Services-Endpunkt (RSA 2048-Bit-Schlüssel: Amazon Root CA 1) Notieren Sie sich den Speicherort jeder dieser Dateien für einen späteren Schritt. 1. Wählen Sie **Fertig** aus. Auf der nächsten Seite sehen Sie eine Notiz, dass Ihr Ding erfolgreich erstellt wurde. 1. Übertrage die oben heruntergeladenen Dateien auf dein AWS IoT Ding, falls sie nicht schon da sind. 1. Besorgen Sie sich den Endpunkt des Credential Providers für Ihr AWS Konto. ------ #### [ AWS CLI ] Führen Sie den folgenden Befehl aus: ``` aws iot describe-endpoint --endpoint-type iot:CredentialProvider ``` ------ #### [ AWS-Managementkonsole ] Führen Sie in [AWS CloudShell](https://docs.aws.amazon.com//cloudshell/latest/userguide/getting-started.html)den folgenden Befehl aus: ``` aws iot describe-endpoint --endpoint-type iot:CredentialProvider ``` ------ Notieren Sie sich diese Informationen für einen späteren Schritt. 1. Besorgen Sie sich den Gerätedatenendpunkt für Ihr AWS Konto. ------ #### [ AWS CLI ] Führen Sie den folgenden Befehl aus: ``` aws iot describe-endpoint --endpoint-type iot:Data-ATS ``` ------ #### [ AWS-Managementkonsole ] Gehen Sie wie folgt vor: 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/). 1. Wählen Sie in der linken Navigationsleiste **Einstellungen** aus. 1. Suchen Sie den **Endpunkt Gerätedaten**. ------ Notieren Sie sich diese Informationen für einen späteren Schritt. 1. (Optional) Vergewissern Sie sich, dass Ihre Zertifikate korrekt generiert wurden. Führen Sie den folgenden Befehl aus, um zu überprüfen, ob Ihre Elemente korrekt generiert wurden. ``` curl --header "x-amzn-iot-thingname:your-thing-name" \ --cert /path/to/certificateID-certificate.pem.crt \ --key /path/to/certificateID-private.pem.key \ --cacert /path/to/AmazonRootCA1.pem \ https://your-credential-provider-endpoint/role-aliases/your-role-alias-name/credentials ``` Weitere Informationen finden Sie unter [So verwenden Sie ein Zertifikat, um ein Sicherheitstoken zu erhalten](https://docs.aws.amazon.com//iot/latest/developerguide/authorizing-direct-aws.html#authorizing-direct-aws.walkthrough). # 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](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 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ä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 `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. Legen Sie Umgebungsvariablen mit den Werten aus den vorherigen Schritten fest. Die folgende Tabelle enthält Beschreibungen der Variablen. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kinesisvideostreams/latest/dg/gs-build-agent.html) 1. Leeren Sie den GStreamer Cache. Type: ``` rm ~/.cache/gstreamer-1.0/registry.your-os-architecture.bin ``` Weitere Informationen finden Sie in der [GStreamer Registrierungsdokumentation](https://gstreamer.freedesktop.org/documentation/gstreamer/gstregistry.html?gi-language=c). 1. Bereiten Sie den Java-Befehl vor und führen Sie ihn aus. Der Amazon Kinesis Video Streams Edge Agent akzeptiert die folgenden Argumente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kinesisvideostreams/latest/dg/gs-build-agent.html) 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`. 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. 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" ``` 1. Wiederholen Sie den vorherigen Schritt für jeden Stream für den Amazon Kinesis Video Streams Edge Agent. # Installieren Sie den CloudWatch Agenten auf dem Gerät **Anmerkung** Seien Sie sich der [CloudWatchKontingente](https://docs.aws.amazon.com//AmazonCloudWatch/latest/logs/cloudwatch_limits_cwl.html) bewusst. Gehen Sie wie folgt vor, um den CloudWatch Agenten so zu installieren und zu konfigurieren, dass die vom Amazon Kinesis Video Streams Edge-Agent generierten Protokolle automatisch hochgeladen werden. CloudWatch Dieser Schritt ist optional. Anweisungen [zur](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html) Installation des CloudWatch Agenten auf Ihrem Gerät finden Sie im CloudWatch Amazon-Benutzerhandbuch. Wenn Sie zur Eingabe der Konfiguration aufgefordert werden, wählen Sie **eine** der folgenden Konfigurationen aus. **Wichtig** `file_path`Bei den folgenden Konfigurationen wird davon ausgegangen, dass der Standardspeicherort für die Protokollausgabe verwendet wird. Der verwendete Dateipfad setzt voraus, dass Sie den Amazon Kinesis Video Streams Edge Agent vom folgenden Standort aus ausführen:`download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/version`. + Um den CloudWatch Agenten so zu konfigurieren, dass er Protokolle hochlädt und RAM- und CPU-Metriken auf das Gerät zurücksendet, fügen Sie Folgendes in die Konfigurationsdatei ein. ``` { "agent": { "run_as_user": "ubuntu", "metrics_collection_interval": 60 }, "metrics": { "metrics_collected": { "mem": { "measurement": [ "mem_used_percent" ], "append_dimensions": { "IotThing": "YourIotThingName" } }, "cpu": { "resources": [ "*" ], "measurement": [ "usage_active" ], "totalcpu": true, "append_dimensions": { "IotThing": "YourIotThingName" } } } }, "logs": { "logs_collected": { "files": { "collect_list": [ { "file_path": "download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/version/log/java_kvs.log", "log_group_name": "/aws/kinesisvideo/EdgeRuntimeAgent", "log_stream_name": "YourIotThingName-java_kvs.log" }, { "file_path": "download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/version/log/cpp_kvs_edge.log*", "log_group_name": "/aws/kinesisvideo/EdgeRuntimeAgent", "log_stream_name": "YourIotThingName-cpp_kvs_edge.log" }, { "file_path": "download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/version/log/cpp_kvs_streams.log*", "log_group_name": "/aws/kinesisvideo/EdgeRuntimeAgent", "log_stream_name": "YourIotThingName-cpp_kvs_streams.log" }, { "file_path": "download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/version/log/cpp_kvssink.log*", "log_group_name": "/aws/kinesisvideo/EdgeRuntimeAgent", "log_stream_name": "YourIotThingName-cpp_kvssink.log" } ] } } } } ``` + Verwenden Sie die folgende Konfiguration, um nur die Protokolle hochzuladen und nicht die RAM- und CPU-Daten des Geräts zu erfassen: ``` { "logs": { "logs_collected": { "files": { "collect_list": [ { "file_path": "download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/version/log/java_kvs.log", "log_group_name": "/aws/kinesisvideo/EdgeRuntimeAgent", "log_stream_name": "YourIotThingName-java_kvs.log" }, { "file_path": "download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/version/log/cpp_kvs_edge.log*", "log_group_name": "/aws/kinesisvideo/EdgeRuntimeAgent", "log_stream_name": "YourIotThingName-cpp_kvs_edge.log" }, { "file_path": "download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/version/log/cpp_kvs_streams.log*", "log_group_name": "/aws/kinesisvideo/EdgeRuntimeAgent", "log_stream_name": "YourIotThingName-cpp_kvs_streams.log" }, { "file_path": "download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/version/log/cpp_kvssink.log*", "log_group_name": "/aws/kinesisvideo/EdgeRuntimeAgent", "log_stream_name": "YourIotThingName-cpp_kvssink.log" } ] } } } } ``` # Führen Sie den Amazon Kinesis Video Streams Edge Agent als nativen Prozess aus Richten Sie den Amazon Kinesis Video Streams Edge Agent als Systemd-Service ein. Dieser Schritt ist optional. `systemd`ist ein System- und Servicemanager auf Linux-Geräten. `systemd`ist die empfohlene Methode zur Verwaltung des Prozesses, da der Amazon Kinesis Video Streams Edge Agent neu gestartet wird, falls die Anwendung auf einen Fehler stößt oder das Gerät, auf dem die Anwendung ausgeführt wird, Strom verliert. Gehen Sie wie folgt vor: **Führen Sie den Amazon Kinesis Video Streams Edge Agent als nativen Prozess aus** 1. Erstellen Sie eine neue Datei in `/etc/systemd/system` und geben Sie ihr `aws.kinesisvideo.edge-runtime-agent.service` einen Namen. Fügen Sie Folgendes ein: ``` [Unit] Description=AWS Kinesis Video Streams edge agent After=network.target StartLimitBurst=3 StartLimitInterval=30 [Service] Type=simple Restart=on-failure RestartSec=10 WorkingDirectory=/download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion Environment="GST_PLUGIN_PATH=/download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion" Environment="LD_LIBRARY_PATH=/download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib" ... Environment="AWS_IOT_CORE_DATA_ATS_ENDPOINT=data-account-specific-prefix.iot.aws-region.amazonaws.com" ExecStart=/usr/lib/jvm/java-11-amazon-corretto/bin/java --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 [Install] WantedBy=multi-user.target ``` Weitere Informationen zu den von der `systemd` Dienstkonfigurationsdatei akzeptierten Parametern finden Sie in der [Dokumentation](https://www.freedesktop.org/software/systemd/man/systemd.unit.html#%5BUnit%5D%20Section%20Options). **Anmerkung** Fügen Sie die erforderlichen Umgebungsvariablen am `...` Speicherort hinzu, wie unter beschrieben[Erstellen Sie den Amazon Kinesis Video Streams Edge Agent](gs-build-agent.md). 1. Laden Sie die Servicedateien neu, um den neuen Dienst einzubeziehen. Geben Sie `sudo systemctl daemon-reload` ein. 1. Starten Sie den Service. Geben Sie `sudo systemctl start aws.kinesisvideo.edge-runtime-agent.service` ein. 1. Überprüfen Sie den Status des Amazon Kinesis Video Streams Edge Agent-Dienstes, um sicherzustellen, dass er ausgeführt wird. Geben Sie `sudo systemctl status aws.kinesisvideo.edge-runtime-agent.service` ein. Im Folgenden finden Sie ein Beispiel für die Ausgabe, die Sie sehen werden. ``` aws.kinesisvideo.edge-runtime-agent.service - AWS Kinesis Video Streams edge agent Loaded: loaded (/etc/systemd/system/aws.kinesisvideo.edge-runtime-agent.service; disabled; vendor preset: enabled) Active: active (running) since Thu 2023-06-08 19:15:02 UTC; 6s ago Main PID: 506483 (java) Tasks: 23 (limit: 9518) Memory: 77.5M CPU: 4.214s CGroup: /system.slice/aws.kinesisvideo.edge-runtime-agent.service └─506483 /usr/lib/jvm/java-11-amazon-corretto/bin/java -cp kvs-edge-agent.jar:libs.jar com.amazonaws.kinesisvideo.edge.controller.ControllerApp ``` 1. Untersuchen Sie die Protokolle auf Fehler. Geben Sie `journalctl -e -u aws.kinesisvideo.edge-runtime-agent.service` ein. 1. Geben Sie `systemctl --help` ein, um die vollständige Liste der Optionen anzuzeigen, mit denen der Prozess verwaltet werden soll`systemctl`. Im Folgenden finden Sie einige häufig verwendete Befehle zur Verwaltung des Amazon Kinesis Video Streams Edge Agent: + Um neu zu starten, geben `sudo systemctl restart aws.kinesisvideo.edge-runtime-agent.service` Sie ein. + Um zu beenden, geben Sie ein`sudo systemctl stop aws.kinesisvideo.edge-runtime-agent.service`. + Um bei jedem Neustart des Geräts automatisch zu starten, geben Sie ein`sudo systemctl enable aws.kinesisvideo.edge-runtime-agent.service`. # 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. # Häufig gestellte Fragen zu Amazon Kinesis Video Streams Edge Agent Im Folgenden finden Sie einige häufig gestellte Fragen zum Amazon Kinesis Video Streams Edge Agent-Service. ## Welche Betriebssysteme unterstützt Amazon Kinesis Video Streams Edge Agent? Amazon Kinesis Video Streams Edge Agent unterstützt derzeit die folgenden Betriebssysteme: **Ubuntu ** + 2.x + AMD64 + 18.x + ARM **AL2** + amzn2 + AMD64 amazonlinux:2.0.20210219.0-amd64 (Snowball) ## Unterstützt der Amazon Kinesis Video Streams Edge Agent H.265-Medien? Amazon Kinesis Video Streams Edge Agent unterstützt nur elementare H.264-Streams. ## Funktioniert der Amazon Kinesis Video Streams Edge Agent in AL2? Ja. ## Wie kann ich mehrere Streams innerhalb des Objekts oder AWS IoT Geräts ausführen? Senden Sie ein weiteres [StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md) an denselben`HubDeviceArn`, aber anderen Amazon Kinesis Video Streams AWS Secrets Manager ARNs Streams/. ## Wie kann ich eine bearbeiten, `StartEdgeConfigurationUpdate` nachdem sie gesendet wurde? Senden Sie eine Aktualisierung [StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md) desselben `HubDeviceArn` mit demselben Amazon Kinesis Video Streams Streams-ARN. Wenn die Anwendung die Nachricht von Amazon Kinesis Video Streams empfängt, überschreibt sie die vorherige Konfiguration für diesen Stream. Die Änderungen werden dann stattfinden. ## Haben Sie Beispiele für Gemeinsamkeiten`ScheduleConfigs`? Der Amazon Kinesis Video Streams Edge Agent verwendet die Systemzeit des Geräts, auf dem er ausgeführt wird. | Description | ScheduleExpression | DurationInSeconds | | --- |--- |--- | | Aufzeichnung rund um die Uhr, stündliches Hochladen | (null ScheduleConfig) | | Jeden Tag von 9:00:00 Uhr bis 16:59:59 Uhr | 0 0 9-16 \$1 \$1 ? \$1 | 3599 | | An Wochentagen von 9:00:00 Uhr bis 16:59:59 Uhr | 0 0 9-16 ? \$1 2-6 \$1 | 3599 | | `0 0 9-16 ? * 2,3,4,5,6 *` | 3599 | | `0 0 9-16 ? * MON-FRI *` | 3599 | | `0 0 9-16 ? * MON,TUE,WED,THU,FRI *` | 3599 | | 9:00:00 Uhr — 16:59:59 Uhr am Wochenende | `0 0 9-16 ? * SAT,SUN *` | 3599 | | An Wochentagen von 22:00:00 Uhr bis 23:59:59 Uhr | `0 0 22,23 ? * MON-FRI *` | 3599 | | 9:00:00 Uhr — 10:00:00 Uhr jeden Tag | `0 0 9 * * ? *` | 3600 | | Jeden Tag von 16:00:00 Uhr bis 17:59:59 Uhr | `0 0 16-17 * * ? *` | 3599 | Weitere Beispiele finden Sie in der [Quartz-Dokumentation](https://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html). ## Gibt es ein maximales Stream-Limit? Der Amazon Kinesis Video Streams Edge Agent hat derzeit ein festes Limit von 16 Streams pro Gerät. Verwenden Sie die [DeleteEdgeConfiguration](API_DeleteEdgeConfiguration.md) API, um Streams von einem Gerät zu löschen. Durch das Aktualisieren einer Konfiguration für denselben Stream mithilfe von [StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md) wird die Anzahl der Streams des Geräts nicht erhöht. ## Wie starte ich einen Job neu, bei dem ein Fehler aufgetreten ist? Wenn ein Fehler auftritt, versucht der Amazon Kinesis Video Streams Edge Agent, den Job neu zu starten. Bei einigen Fehlern (z. B. Konfigurationsfehlern) müssen Sie den Job jedoch manuell neu starten. Informationen dazu, welche Jobs manuell neu gestartet werden müssen, finden Sie in [Überwachen Sie den Amazon Kinesis Video Streams Edge Agent mit CloudWatch](monitoring-edge-cloudwatch.md) der **FatalError**Metrik unter. Senden Sie den erneut[StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md), um den Job für den Stream neu zu starten. ## Wie überwache ich den Zustand meines Amazon Kinesis Video Streams Edge Agent? Weitere Informationen finden Sie unter [Überwachen Sie den Amazon Kinesis Video Streams Edge Agent mit CloudWatch](monitoring-edge-cloudwatch.md).