Veröffentlichung der neuen MongoDB-basierten Geräteregistrierung in Eclipse Hono

Eclipse Hono ist, wie auf seiner offiziellen Website beschrieben, eine IoT-Konnektivitätsplattform, die eine einheitliche API zum Verbinden einer großen Anzahl von IoT-Geräten mit einem Backend bietet, unabhängig von den verschiedenen Kommunikationsprotokollen, die von den Geräten verwendet werden. Hono bietet Out-of-the-Box-Unterstützung für Geräte, die über Protokolle wie AMQP, COAP, HTTP und MQTT kommunizieren. Eclipse Hono besteht aus mehreren Microservices, die als Docker-Container verpackt und in einem Container-Orchestrierungssystem wie Kubernetes bereitgestellt werden.

Die Geräteregistrierung ist eine dieser Komponenten, in der Hono alle seine Mieter, Geräte und Geräteanmeldeinformationen verfolgt. Dies ist für Hono von entscheidender Bedeutung, da die Protokolladapter die Geräteregistrierung verwenden, um zu überprüfen, ob ein Mandant und ein Gerät registriert und aktiviert sind. Darüber hinaus verwenden die Protokolladapter die Geräteregistrierung, um Geräte zu authentifizieren, bevor sie Telemetrie-, Ereignis- oder Befehlsantwortnachrichten akzeptieren. Die Geräteregistrierung implementiert auch HTTP-basierte Geräteverwaltungs-APIs, um den Speicher von Mandanten, Geräten und Anmeldeinformationen zu verwalten.

Bis Version 1.3.0 bot Hono nur eine Implementierung der Geräteregistrierung an, die das zugrunde liegende lokale Dateisystem verwendet, um die Daten zu speichern. Diese dateibasierte Geräteregistrierung hat ihren Zweck als Demo-Geräteregistrierung gut erfüllt. Der Einsatz in Produktionsumgebungen ist jedoch nicht vorgesehen, da die Komponenten nicht ohne weiteres horizontal skaliert werden können. Daher mussten die Benutzer ihre eigene Geräteregistrierung implementieren, um Hono in Produktions-Setups zu verwenden. Mit der Veröffentlichung von Hono 1.3.0 wurde dies berücksichtigt und Sie müssen keine eigene Geräteregistrierung implementieren, um Hono in Produktionsumgebungen zu verwenden.

Neue MongoDB-basierte Geräteregistrierung

Jetzt bietet Hono eine weitere Implementierung der Geräteregistrierung, die eine MongoDB-Datenbank verwendet, um die Daten beizubehalten. Im Gegensatz zum dateibasierten Gegenstück soll diese MongoDB-basierte Geräteregistrierung sowohl in der Produktion als auch in Demo-Setups verwendet werden. Es speichert Informationen zu Mandanten, Geräten und Anmeldeinformationen in separaten Sammlungen in der zugrunde liegenden MongoDB-Datenbank. MongoDB unterstützt horizontales Skalieren mit Techniken wie Sharding und Datenverteilung. Dadurch kann diese Registry die Skalierbarkeit der MongoDB nutzen, um sich ohne Schwierigkeiten selbst zu skalieren.

Darüber hinaus können Sie die HTTP-Endpunkte in der MongoDB-Geräteregistrierung einfach mithilfe des grundlegenden Authentifizierungsmechanismus sichern. Dies bedeutet, dass sich die Clients bei der MongoDB-basierten Geräteregistrierung authentifizieren müssen, indem sie einen Benutzernamen und ein Kennwort angeben, um Mandanten, Geräte und Anmeldeinformationen zu verwalten. Sie können den Authentifizierungsmechanismus aktivieren oder deaktivieren, indem Sie die Konfigurationseigenschaft hono.registry.http.authenticationRequired . festlegen zu wahr oder falsch . Weitere Informationen zur Konfiguration der MongoDB-basierten Geräteregistrierung finden Sie unter MongoDB-basierte Geräteregistrierungskonfiguration.

Installieren Sie Eclipse Hono mit der MongoDB-Geräteregistrierung mithilfe des Helmdiagramms

Das Eclipse IoT-Paket-Repository hostet Helm-Charts, mit denen Sie Hono in einem Kubernetes-Cluster installieren können. Standardmäßig stellt das Helm-Diagramm von Hono die dateibasierte Geräteregistrierung bereit. Ich zeige Ihnen, wie Sie Hono mit der MongoDB-basierten Geräteregistrierung mithilfe von Honos Helmchart installieren. Ich gehe davon aus, dass Sie bereits über einen laufenden Kubernetes-Cluster verfügen.

Der erste Schritt besteht darin, das Eclipse-IoT-Paket-Diagramm-Repository mit dem folgenden Befehl hinzuzufügen. Dieser Befehl fügt das Repository mit dem Namen eclipse-iot . hinzu .

$ Helm Repo Eclipse-iot hinzufügen https://eclipse.org/packages/charts

Verwenden Sie nun den folgenden Befehl, um Hono mit der MongoDB-basierten Geräteregistrierung im Namespace hono . bereitzustellen .

$ helm install --set deviceRegistryExample.type=mongodb,mongodb.createInstance=true --dependency-update -n hono eclipse-hono eclipse-iot/hono

Wie Sie oben sehen können, habe ich den Wert für die Eigenschaft deviceRegistryExample.type . gesetzt zu mongodb . Dadurch wird das Diagramm so konfiguriert, dass die MongoDB-basierte Registrierung anstelle der standardmäßigen dateibasierten Registrierung bereitgestellt wird.

Im obigen Befehl habe ich die Eigenschaft mongodb.createInstance . gesetzt zu wahr . Der Standardwert ist false und wenn es auf true gesetzt ist , dann stellt das Diagramm eine neue MongoDB-Datenbankinstanz als separaten Mikrodienst bereit und verwendet diese Datenbankinstanz zum Speichern der Geräteregistrierungsdaten. Wenn Sie es vorziehen, eine bereits vorhandene MongoDB-Datenbankinstanz zu verwenden und keine neue Instanz zu erstellen, dann setzen Sie mongodb.createInstance falsch . Verwenden Sie in diesem Fall die folgenden Eigenschaften der MongoDB-Verbindungskonfiguration, um auf die bereits vorhandene MongoDB-Datenbank zu verweisen.

mongodb:host:# Der Hostname oder die IP-Adresse der MongoDB-Instanz. port:# Der Port, den die MongoDB-Instanz überwacht. dbName:# Der Name der MongoDB-Datenbank, die von der Geräteregistrierungsanwendung verwendet werden soll. username:# Der Benutzername für die Authentifizierung bei der MongoDB-Instance. password:# Das für die Authentifizierung bei der MongoDB-Instanz zu verwendende Kennwort.

Mit den obigen Schritten sollten Sie Hono bereits mit der MongoDB-basierten Geräteregistrierung im angegebenen Kubernetes-Cluster installiert haben. Sie können die Installation auch überprüfen. Weitere Informationen zur Überprüfung der Installation finden Sie auf der README-Seite von Honos Steuertabelle.