Verwalten von -Core-Geräteendpunkten - AWS IoT Greengrass
Verwenden Sie den IP-Detektor, um Endpunkte automatisch zu verwaltenManuelles Verwalten von Endpunkten

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.

Verwalten von -Core-Geräteendpunkten

Wenn Sie Cloud Discovery verwenden, speichern Sie MQTT-Broker-Endpunkte für -Core-Geräte im AWS IoT Greengrass Cloud-Service. Client-Geräte stellen eine Verbindung zu herAWS IoT Greengrass, um diese Endpunkte und andere Informationen für ihre zugehörigen Core-Geräte abzurufen.

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

  • Automatische Verwaltung von Endpunkten mit IP-Detektor

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

    Die IP-Detektorkomponente ist auch nützlich, wenn Sie in Objektgruppen bereitstellen, da sie die Endpunkte für alle Core-Geräte in der Objektgruppe 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 des Core-Geräts manuell verwalten. Sie können diese Endpunkte mit der Konsole oder der API aktualisieren. Weitere Informationen finden Sie unter Manuelles Verwalten von Endpunkten.

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

Wenn Sie eine einfache Netzwerkeinrichtung haben, z. B. die Client-Geräte im selben Netzwerk wie das Core-Gerät, können Sie die IP-Detektorkomponente bereitstellen, um Folgendes zu tun:

  • Überwachen Sie die lokalen Netzwerkkonnektivitätsinformationen des Greengrass-Core-Geräts. Zu diesen Informationen gehören die Netzwerkendpunkte des Core-Geräts und der Port, an dem der MQTT-Broker arbeitet.

  • Melden Sie die Konnektivitätsinformationen des Core-Geräts an den AWS IoT Greengrass Cloud-Service.

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

Wichtig

Die AWS IoT Richtlinie des Core-Geräts muss der greengrass:UpdateConnectivityInfo Berechtigung zur Verwendung der IP-Detektorkomponente erteilen. Weitere Informationen finden 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 Erkennung konfigurieren in der -Konsole. Weitere Informationen finden Sie unter Konfigurieren der Cloud-Erkennung (Konsole).

  • Erstellen und überarbeiten Sie Bereitstellungen, um den IP-Detektor einzuschließen. Sie können die Konsole, oder AWS API verwendenAWS CLI, um Bereitstellungen zu verwalten. Weitere Informationen finden Sie unter Erstellen von Bereitstellungen.

  1. Wählen Sie im Navigationsmenü der AWS IoT GreengrassKonsole Komponenten aus.

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

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

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

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

  6. Überprüfen Sie auf der Seite Komponenten auswählen, ob die aws.greengrass.clientdevices.IPDetector Komponente ausgewählt ist, und wählen Sie Weiter aus.

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

    1. Wählen Sie Komponente konfigurieren aus.

    2. Im Modal konfigurieren aws.greengrass.clientdevices.IPDetector können Sie unter Konfigurationsaktualisierung unter Konfiguration zum Zusammenführen von 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, wie z. B. localhost, bei denen ein Gerät mit sich selbst kommunizieren kann. Verwenden Sie diese Option in Testumgebungen, in denen das Core-Gerät und das Client-Gerät auf demselben System ausgeführt werden.

      • includeIPv4LinkLocalAddrs – (Optional) Sie können diese Option aktivieren, um Link-lokale IPv4-Adressen zu erkennen und zu melden. https://en.wikipedia.org/wiki/Link-local_address Verwenden Sie diese Option, wenn das Netzwerk des Core-Geräts nicht über das Dynamic Host Configuration Protocol (DHCP) oder statisch zugewiesene IP-Adressen verfügt.

      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 aus.

  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.

    Die Bereitstellung kann bis zu einer Minute dauern.

Um die IP-Detektorkomponente bereitzustellen, erstellen Sie ein Bereitstellungsdokument, das aws.greengrass.clientdevices.IPDetector in das components Objekt einschließt, und geben Sie das Konfigurationsupdate für die Komponente an. Folgen Sie den Anweisungen unter Erstellen von Bereitstellungen, um eine neue Bereitstellung zu erstellen oder eine vorhandene Bereitstellung zu überarbeiten.

Sie können beim Erstellen 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, wie z. B. localhost, bei denen ein Gerät mit sich selbst kommunizieren kann. Verwenden Sie diese Option in Testumgebungen, in denen das Core-Gerät und das Client-Gerät auf demselben System ausgeführt werden.

  • includeIPv4LinkLocalAddrs – (Optional) Sie können diese Option aktivieren, um Link-lokale IPv4-Adressen zu erkennen und zu melden. https://en.wikipedia.org/wiki/Link-local_address Verwenden Sie diese Option, wenn das Netzwerk des Core-Geräts nicht über das Dynamic Host Configuration Protocol (DHCP) oder statisch zugewiesene IP-Adressen verfügt.

Das folgende Beispiel für ein partielles Bereitstellungsdokument gibt an, Port 8883 als MQTT-Broker-Port zu melden.

{
  ...,
  "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 -Core-Geräte manuell verwalten.

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

Endpunkt (HostAddress)

Eine IP-Adresse oder DNS-Adresse, an der 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 Core-Gerät arbeitet.

Sie können diesen Port auf der Moquette-MQTT-Brokerkomponente konfigurieren, die standardmäßig Port 8883 verwendet.

Metadaten (Metadata)

Zusätzliche Metadaten, die Client-Geräten bereitgestellt werden, die eine Verbindung zu diesem Endpunkt herstellen.

Verwalten von Endpunkten (Konsole)

Sie können die AWS IoT Greengrass Konsole verwenden, um Endpunkte für ein Core-Gerät anzuzeigen, zu aktualisieren und zu entfernen.

So verwalten Sie Endpunkte für ein Core-Gerät (Konsole)

  1. Wählen Sie Core-Geräte aus.

  2. Wählen Sie das zu verwaltende Core-Gerät aus.

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

  4. Im Abschnitt MQTT-Broker-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 Core-Gerät hinzu oder entfernen Sie sie.

  6. Wählen Sie Aktualisieren.

Verwalten von Endpunkten (AWS CLI)

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

Anmerkung

Da die Client-Geräteunterstützung in abwärtskompatibel mit AWS IoT Greengrass V2 istAWS IoT Greengrass V1, können Sie - AWS IoT Greengrass V2 oder AWS IoT Greengrass V1-API-Operationen verwenden, um Core-Geräteendpunkte zu verwalten.

So rufen Sie Endpunkte für ein Core-Gerät ab (AWS CLI)
So aktualisieren Sie Endpunkte für ein Core-Gerät (AWS CLI)

Verwalten von Endpunkten (API)

Sie können die AWS-API verwenden, um Endpunkte für ein Core-Gerät zu verwalten.

Anmerkung

Da die Client-Geräteunterstützung in abwärtskompatibel mit AWS IoT Greengrass V2 istAWS IoT Greengrass V1, können Sie - AWS IoT Greengrass V2 oder AWS IoT Greengrass V1-API-Operationen verwenden, um Core-Geräteendpunkte zu verwalten.

So rufen Sie Endpunkte für ein Core-Gerät ab (AWS-API)
So aktualisieren Sie Endpunkte für ein Core-Gerät (AWS-API)