Endpunkte von Kerngeräten verwalten - AWS IoT Greengrass

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.

Endpunkte von Kerngeräten verwalten

Wenn Sie Cloud Discovery verwenden, speichern Sie MQTT Broker-Endpunkte für Kerngeräte im AWS IoT Greengrass Cloud-Dienst. Client-Geräte stellen eine Verbindung her AWS IoT Greengrass , um diese Endpunkte und andere Informationen für die zugehörigen Kerngeräte abzurufen.

Für jedes Kerngerät können Sie Endpunkte automatisch oder manuell verwalten.

  • Automatische Verwaltung von Endpunkten mit dem IP-Detektor

    Sie können die IP-Detektorkomponente einsetzen, um die Endpunkte der Kerngeräte automatisch für Sie zu verwalten, wenn Sie über eine nicht komplexe Netzwerkkonfiguration verfügen, z. B. wenn sich die Client-Geräte im selben Netzwerk wie das Kerngerät befinden. Sie können die IP-Detektorkomponente nicht verwenden, wenn sich das Kerngerät beispielsweise hinter einem Router befindet, der den MQTT Broker-Port an das Kerngerät weiterleitet.

    Die IP-Detektorkomponente ist auch nützlich, wenn Sie sie in Dinggruppen bereitstellen, da sie die Endpunkte für alle Kerngeräte in der Dinggruppe verwaltet. Weitere Informationen finden Sie unter Verwenden Sie den IP-Detektor, um Endpunkte automatisch zu verwalten.

  • Manuelles Verwalten von Endpunkten

    Wenn Sie die IP-Detektorkomponente nicht verwenden können, müssen Sie die Endpunkte der Kerngeräte manuell verwalten. Sie können diese Endpunkte mit der Konsole oder dem aktualisieren. API Weitere Informationen finden Sie unter Manuelles Verwalten von Endpunkten.

Verwenden Sie den IP-Detektor, um Endpunkte automatisch zu verwalten

Wenn Sie über ein einfaches Netzwerk-Setup verfügen, z. B. wenn sich die Client-Geräte im selben Netzwerk wie das Kerngerät befinden, können Sie die IP-Detektorkomponente einsetzen, um Folgendes zu tun:

  • Überwachen Sie die lokalen Netzwerkverbindungsinformationen des Greengrass Core-Geräts. Zu diesen Informationen gehören die Netzwerkendpunkte des Kerngeräts und der Port, an dem der MQTT Broker tätig ist.

  • Melden Sie die Konnektivitätsinformationen des Kerngeräts an den AWS IoT Greengrass Cloud-Dienst.

Die IP-Detektorkomponente überschreibt Endpunkte, die Sie manuell festlegen.

Wichtig

Die AWS IoT Richtlinie des Kerngeräts muss die greengrass:UpdateConnectivityInfo Erlaubnis zur Verwendung der IP-Detektorkomponente zulassen. Weitere Informationen erhalten Sie unter AWS IoT-Richtlinien für Operationen auf Datenebene und Konfigurieren der AWS IoT Objektrichtlinie.

Sie können einen der folgenden Schritte ausführen, um die IP-Detektorkomponente bereitzustellen:

  • Verwenden Sie die Seite Discovery konfigurieren in der Konsole. Weitere Informationen finden Sie unter Konfigurieren der Cloud-Erkennung (Konsole).

  • Erstellen und überarbeiten Sie Bereitstellungen, um den IP-Detektor einzubeziehen. Sie können die Konsole oder AWS API zur Verwaltung von AWS CLI Bereitstellungen verwenden. Weitere Informationen finden Sie unter Erstellen von Bereitstellungen.

  1. Wählen Sie im Navigationsmenü der AWS IoT Greengrass Konsole die Option Komponenten aus.

  2. Wählen Sie auf der Seite Komponenten die Registerkarte Öffentliche Komponenten und wählen Sie dann aws.greengrass.clientdevices.IPDetector.

  3. Wählen Sie auf der aws.greengrass.clientdevices.IPDetector Seite Bereitstellen aus.

  4. Wählen Sie unter Zur Bereitstellung hinzufügen eine vorhandene Bereitstellung aus, die Sie überarbeiten möchten, oder erstellen Sie eine neue Bereitstellung und klicken Sie dann auf Weiter.

  5. Wenn Sie eine neue Bereitstellung erstellen möchten, wählen Sie das Ziel-Core-Gerät oder die Dinggruppe für die Bereitstellung aus. Wählen Sie auf der Seite „Ziel angeben“ unter Bereitstellungsziel ein Kerngerät oder eine Dinggruppe aus, und klicken Sie dann auf Weiter.

  6. Vergewissern Sie sich auf der Seite „Komponenten auswählen“, dass die aws.greengrass.clientdevices.IPDetectorKomponente ausgewählt ist, und klicken Sie auf Weiter.

  7. Wählen Sie auf der Seite Komponenten konfigurieren die Option aus aws.greengrass.clientdevices.IPDetector, und gehen Sie dann wie folgt vor:

    1. Wählen Sie Komponente konfigurieren aus.

    2. Im aws.greengrass.clientdevices.IPDetector Modal konfigurieren können Sie unter Konfigurationsupdate unter Konfiguration zum Zusammenführen ein Konfigurationsupdate eingeben, um die IP-Detektorkomponente zu konfigurieren. Sie können eine der folgenden Konfigurationsoptionen angeben:

      • defaultPort(Optional) Der MQTT Broker-Port, der gemeldet werden soll, wenn diese Komponente IP-Adressen erkennt. Sie müssen diesen Parameter angeben, wenn Sie den MQTT Broker so konfigurieren, dass er einen anderen Port als den Standardport 8883 verwendet.

      • includeIPv4LoopbackAddrs(Optional) Sie können diese Option aktivieren, um IPv4 Loopback-Adressen zu erkennen und zu melden. Dies sind IP-Adressen, mit denen ein Gerät localhost beispielsweise mit sich selbst kommunizieren kann. Verwenden Sie diese Option in Testumgebungen, in denen das Kerngerät und das Client-Gerät auf demselben System ausgeführt werden.

      • includeIPv4LinkLocalAddrs(Optional) Sie können diese Option aktivieren, um IPv4 Link-Local-Adressen zu erkennen und zu melden. Verwenden Sie diese Option, wenn das Netzwerk des Kerngeräts nicht über das Dynamic Host Configuration Protocol (DHCP) oder statisch zugewiesene IP-Adressen verfügt.

      • includeIPv6LoopbackAddrs(Optional) Sie können diese Option aktivieren, um IPv6 Loopback-Adressen zu erkennen und zu melden. Dies sind IP-Adressen, mit denen ein Gerät localhost beispielsweise mit sich selbst kommunizieren kann. Verwenden Sie diese Option in Testumgebungen, in denen das Kerngerät und das Client-Gerät auf demselben System ausgeführt werden. Sie müssen includeIPv4Addrs auf false und auf einstellenincludeIPv6Addrs, true um diese Option verwenden zu können. Sie benötigen IP Detector v2.2.0 oder höher, um diese Option verwenden zu können.

      • includeIPv6LinkLocalAddrs(Optional) Sie können diese Option aktivieren, um IPv6 Link-Local-Adressen zu erkennen und zu melden. Verwenden Sie diese Option, wenn das Netzwerk des Kerngeräts nicht über das Dynamic Host Configuration Protocol (DHCP) oder statisch zugewiesene IP-Adressen verfügt. Sie müssen includeIPv4Addrs auf false und auf einstellen, includeIPv6Addrs true um diese Option verwenden zu können. Sie benötigen IP Detector v2.2.0 oder höher, um diese Option verwenden zu können.

      • includeIPv4Addrs(Optional) Die Standardeinstellung ist auf true gesetzt. Sie können diese Option aktivieren, um IPv4 Adressen zu veröffentlichen, die auf dem Core-Gerät gefunden wurden. Sie benötigen IP Detector v2.2.0 oder höher, um diese Option verwenden zu können.

      • includeIPv6Addrs(Optional) Sie können diese Option aktivieren, um IPv6 Adressen zu veröffentlichen, die auf dem Core-Gerät gefunden wurden. Stellen Sie includeIPv4Addrs auf false ein, um diese Option zu verwenden. Sie benötigen IP Detector v2.2.0 oder höher, um diese Option verwenden zu können.

      Das Konfigurationsupdate könnte dem folgenden Beispiel ähneln.

      { "defaultPort": "8883", "includeIPv4LoopbackAddrs": false, "includeIPv4LinkLocalAddrs": false }
    3. Wählen Sie Bestätigen, um das Modal zu schließen, und wählen Sie dann Weiter.

  8. Behalten Sie auf der Seite Erweiterte Einstellungen konfigurieren die Standardkonfigurationseinstellungen bei und wählen Sie Weiter.

  9. Wählen Sie auf der Seite Review (Prüfen) die Option Deploy (Bereitstellen) aus.

    Es kann bis zu einer Minute dauern, bis die Bereitstellung abgeschlossen ist.

Um die IP-Detektorkomponente bereitzustellen, erstellen Sie ein Bereitstellungsdokument, das das components Objekt enthältaws.greengrass.clientdevices.IPDetector, und geben Sie das Konfigurationsupdate für die Komponente an. Folgen Sie den Anweisungen unterErstellen von Bereitstellungen, um eine neue Einrichtung zu erstellen oder eine bestehende Einrichtung zu überarbeiten.

Sie können bei der Erstellung des Bereitstellungsdokuments eine der folgenden Optionen angeben, um die IP-Detektorkomponente zu konfigurieren:

  • defaultPort(Optional) Der MQTT Broker-Port, der gemeldet werden soll, wenn diese Komponente IP-Adressen erkennt. Sie müssen diesen Parameter angeben, wenn Sie den MQTT Broker so konfigurieren, dass er einen anderen Port als den Standardport 8883 verwendet.

  • includeIPv4LoopbackAddrs(Optional) Sie können diese Option aktivieren, um IPv4 Loopback-Adressen zu erkennen und zu melden. Dies sind IP-Adressen, mit denen ein Gerät localhost beispielsweise mit sich selbst kommunizieren kann. Verwenden Sie diese Option in Testumgebungen, in denen das Kerngerät und das Client-Gerät auf demselben System ausgeführt werden.

  • includeIPv4LinkLocalAddrs(Optional) Sie können diese Option aktivieren, um IPv4 Link-Local-Adressen zu erkennen und zu melden. Verwenden Sie diese Option, wenn das Netzwerk des Kerngeräts nicht über das Dynamic Host Configuration Protocol (DHCP) oder statisch zugewiesene IP-Adressen verfügt.

  • includeIPv6LoopbackAddrs(Optional) Sie können diese Option aktivieren, um IPv6 Loopback-Adressen zu erkennen und zu melden. Dies sind IP-Adressen, mit denen ein Gerät localhost beispielsweise mit sich selbst kommunizieren kann. Verwenden Sie diese Option in Testumgebungen, in denen das Kerngerät und das Client-Gerät auf demselben System ausgeführt werden. Sie müssen includeIPv4Addrs auf false und auf einstellenincludeIPv6Addrs, true um diese Option verwenden zu können. Sie benötigen IP Detector v2.2.0 oder höher, um diese Option verwenden zu können.

  • includeIPv6LinkLocalAddrs(Optional) Sie können diese Option aktivieren, um IPv6 Link-Local-Adressen zu erkennen und zu melden. Verwenden Sie diese Option, wenn das Netzwerk des Kerngeräts nicht über das Dynamic Host Configuration Protocol (DHCP) oder statisch zugewiesene IP-Adressen verfügt. Sie müssen includeIPv4Addrs auf false und auf einstellen, includeIPv6Addrs true um diese Option verwenden zu können. Sie benötigen IP Detector v2.2.0 oder höher, um diese Option verwenden zu können.

  • includeIPv4Addrs(Optional) Die Standardeinstellung ist auf true gesetzt. Sie können diese Option aktivieren, um IPv4 Adressen zu veröffentlichen, die auf dem Core-Gerät gefunden wurden. Sie benötigen IP Detector v2.2.0 oder höher, um diese Option verwenden zu können.

  • includeIPv6Addrs(Optional) Sie können diese Option aktivieren, um IPv6 Adressen zu veröffentlichen, die auf dem Core-Gerät gefunden wurden. Stellen Sie includeIPv4Addrs auf false ein, um diese Option zu verwenden. Sie benötigen IP Detector v2.2.0 oder höher, um diese Option verwenden zu können.

Im folgenden Beispieldokument zur teilweisen Bereitstellung wird angegeben, dass Port 8883 als Broker-Port gemeldet werden soll. MQTT

{ ..., "components": { ..., "aws.greengrass.clientdevices.IPDetector": { "componentVersion": "2.1.1", "configurationUpdate": { "merge": "{\"defaultPort\":\"8883\",}" } } } }

Manuelles Verwalten von Endpunkten

Sie können MQTT Broker-Endpunkte für Kerngeräte manuell verwalten.

Jeder MQTT Broker-Endpunkt enthält die folgenden Informationen:

Endpunkt (HostAddress)

Eine IP-Adresse oder DNS Adresse, über die Client-Geräte eine Verbindung zu einem MQTT Broker auf dem Core-Gerät herstellen können.

Port (PortNumber)

Der Port, an dem der MQTT Broker auf dem Kerngerät arbeitet.

Sie können diesen Port in der MQTTMoquette-Broker-Komponente konfigurieren, die standardmäßig Port 8883 verwendet.

Metadaten () Metadata

Zusätzliche Metadaten, die den Client-Geräten zur Verfügung gestellt werden, die eine Verbindung zu diesem Endpunkt herstellen.

Endgeräte verwalten (Konsole)

Sie können die AWS IoT Greengrass Konsole verwenden, um Endgeräte für ein Kerngerät anzuzeigen, zu aktualisieren und zu entfernen.

Um Endpunkte für ein Kerngerät (Konsole) zu verwalten
  1. Wählen Sie Core-Geräte.

  2. Wählen Sie das zu verwaltende Kerngerät aus.

  3. Wählen Sie auf der Detailseite des Kerngeräts die Registerkarte Client-Geräte aus.

  4. Im Abschnitt MQTTBroker-Endpunkte können Sie die MQTT Broker-Endpunkte des Core-Geräts sehen. Wählen Sie Endpunkte verwalten aus.

  5. Fügen Sie im Modal „Endpunkte verwalten“ MQTT Broker-Endpunkte für das Kerngerät hinzu oder entfernen Sie sie.

  6. Wählen Sie Aktualisieren.

Endgeräte verwalten ()AWS CLI

Sie können das AWS Command Line Interface (AWS CLI) verwenden, um Endpunkte für ein Kerngerät zu verwalten.

Anmerkung

Da die Unterstützung von Client-Geräten in abwärtskompatibel AWS IoT Greengrass V2 ist, können Sie die AWS IoT Greengrass V1 API Operationen AWS IoT Greengrass V2 or verwenden AWS IoT Greengrass V1, um die Endpunkte von Kerngeräten zu verwalten.

Um Endpunkte für ein Kerngerät abzurufen ()AWS CLI
Um Endpunkte für ein Kerngerät zu aktualisieren ()AWS CLI

Endpunkte verwalten () API

Sie können den verwenden AWS API, um Endpunkte für ein Kerngerät zu verwalten.

Anmerkung

Da die Unterstützung von Client-Geräten in abwärtskompatibel AWS IoT Greengrass V2 ist AWS IoT Greengrass V1, können Sie AWS IoT Greengrass V2 Or AWS IoT Greengrass V1 API Operations zur Verwaltung von Kerngeräteendpunkten verwenden.

Um Endpunkte für ein Kerngerät abzurufen ()AWS API
Um Endpunkte für ein Kerngerät zu aktualisieren ()AWS API