supermq

Supermq

SuperMQ ist modern, skalierbar, sicher, Open-Source und patentfreie Cloud-Plattform für Messaging- und Event-gesteuerte Architektur (EDA), die in Go geschrieben wurden.

Es akzeptiert Benutzer- und Client- (Geräte, Benutzer, Anwendungs) Verbindungen über verschiedene Netzwerkprotokolle (dh HTTP, MQTT, WebSocket, COAP), wodurch eine nahtlose Brücke zwischen ihnen hergestellt wird. Es wird als Architektur -Rückgrat zum Aufbau komplexer verteilter Lösungen verwendet.

Weitere Informationen finden Sie in der offiziellen Dokumentation. Für zusätzliche Teile und Dienste finden Sie in unserem Beitrags -Repository.

Merkmale

• Multi-Protokoll-Konnektivität und -überbrückung (HTTP, MQTT, WebSocket und CoAp; siehe Repository für LORA und OPC UA)
• Gerätemanagement und Bereitstellung (Zero Touch Provisioning)
• Gegenseitige TLS -Authentifizierung (MTLS) unter Verwendung von X.509 -Zertifikaten
• Feinkörnige Zugangskontrolle (Richtlinien, ABAC/RBAC)
• Nachricht Persistenz (Timescale und Postgressql - Siehe Repository für Cassandra, InfluxDB und MongoDB -Unterstützung)
• Support für Plattformprotokollierung und Instrumentierung (Prometheus und Opentelemetrie)
• Ereignisbeschaffung
• Containerbasierte Bereitstellung mit Docker und Kubernetes
• Edge Agent und Exportdienste für Remote IoT Gateway Management und Edge Computing
• SDK
• Cli
• Kleiner Speicherausdruck und schnelle Ausführung
• Domänengesteuerte Designarchitektur, hochwertiger Code und Testabdeckung

Voraussetzungen

Das Folgende ist erforderlich, um Supermq auszuführen:

• Docker (Version 26.0.0)

Die Entwicklung von SuperMQ erfordert auch:

• Go (Version 1.21)
• Protobuf (Version 25.1)

Installieren

Sobald die Voraussetzungen installiert sind, führen Sie die folgenden Befehle aus dem Projekt des Projekts aus:

docker compose -f docker/docker-compose.yml --env-file docker/.env -p git_github_com_absmach_supermq_git_  up

Dadurch werden die Supermq Docker -Dienste angesprochen und diese miteinander verbunden. Dieser Befehl kann auch mit dem enthaltenen Projekt des Projekts ausgeführt werden: Makefile:

make run

Wenn Sie Dienste aus SMQ_RELEASE_TAG bestimmten Release -Checkout -Code von GitHub ausführen möchten, und sicherstellen

git checkout tags/ < release_number > -b < release_number >
# e.g. `git checkout tags/0.13.0 -b 0.13.0`

Überprüfen Sie, ob die Datei .env enthält:

SMQ_RELEASE_TAG= < release_number >

docker-compose sollte für die Entwicklung und das Testen von Bereitstellungen verwendet werden. Für die Produktion empfehlen wir Kubernetes.

Verwendung

Der schnellste Weg, um SuperMQ zu verwenden, ist über die CLI. Die neueste Version kann von der offiziellen Releases -Seite heruntergeladen werden.

Es kann auch aus dem Root -Verzeichnis des Projekts erstellt und verwendet werden:

make cli
./build/cli version

Weitere Details zur Verwendung der CLI finden Sie in der CLI -Dokumentation.

Dokumentation

Die offizielle Dokumentation wird auf der offiziellen Dokumentseite der Supermq gehostet. Die Dokumentation ist automatisch generiert. Checkout der Anweisungen zum offiziellen Dokumenten-Repository:

Wenn Sie einen Fehler oder die Notwendigkeit von Korrekturen erkennen, teilen Sie uns dies bitte mit - oder noch besser: Senden Sie uns eine PR.

Autoren

Hauptarchitekt und BDFL des SuperMQ -Projekts ist @Drkoko.

Darüber hinaus versicherten @NMarcetic und @Janko-Isidorovic die allgemeine Architektur und das Design, während @Manuio und @Darkodraskovic bei der Erstellung der ersten Implementierung geholfen und kontinuierlich an den Projektentwicklungen arbeiteten.

Außerdem wird Supermq ständig verbessert und aktiv von @anovakovic01, @dusanb94, @srados, @gsaleh, @blokovi, @chombium, @mteodor, @Rodneyosodo und einem großen Teil von Mitwirkenden entwickelt.

Die Wartenden sind in der Warteurdatei aufgeführt.

Das SuperMQ -Team möchte @mijicd für seine monumentale Arbeit zum Entwerfen und Implementieren einer hoch verbesserten und optimierten Version der Plattform sowie @malidukica für seine Bemühungen zur Implementierung der anfänglichen Benutzeroberfläche besonders bedanken.

Professionelle Unterstützung

Es gibt viele Unternehmen, die das SuperMQ -System professionell unterstützen.

Wenn Sie diese Art von Support benötigen, besteht das Beste, um @Dkoko direkt zu erreichen, und er wird Sie auf das bestinkostende Support-Team hinweisen.

Beitragen

Vielen Dank für Ihr Interesse an Supermq und den Wunsch, einen Beitrag zu leisten!

1. Schauen Sie sich unsere offenen Probleme an. Das Label für das Gute zum ersten Mal ist speziell für Themen geeignet, die sich hervorragend für den Einstieg eignen.
2. Schauen Sie sich den Beitragsführer an, um mehr über unseren Stil und unseren Konventionen zu erfahren.
3. Machen Sie Ihre Änderungen für unseren Workflow kompatibel.

Erforschen Sie auch unser Beitrags -Repository für zusätzliche Dienste wie Cassandra, InfluxDB, MongoDB -Leser und Schriftsteller, Lora, OPC UA -Unterstützung, digitale Zwillinge und vieles mehr. Wenn Sie einen Beitrag haben, der nicht gut für den Kernmonorepo passt (er ist spezifisch für Ihren Anwendungsfall, ist es eine zusätzliche Funktion oder ein neuer Service. Es ist optional oder ein Add-On). Dies ist ein großartiger Ort, um die Pull-Anfrage einzureichen.

Wir stellen ein

Sie mögen Supermq und möchten es zu Ihrem Tagesjob machen? Wir sind immer auf der Suche nach talentierten Ingenieuren, die sich für Open-Source-, IoT- und Distributed Systems interessieren. Wenn Sie sich selbst erkennen, wenden Sie sich an @Dkoko, er wird Sie zurück in Verbindung setzen.

Der beste Weg, unsere Aufmerksamkeit zu erregen, ist natürlich, PRS zu senden?

Gemeinschaft

• Google -Gruppe
• Gitter
• Twitter

Lizenz

Apache-2.0

Datenerfassung für SuperMQ

SuperMQ setzt sich dafür ein, seine Dienste kontinuierlich zu verbessern und eine nahtlose Erfahrung für seine Benutzer zu gewährleisten. Um dies zu erreichen, sammeln wir bestimmte Daten aus Ihren Bereitstellungen. Seien Sie versichert, diese Daten werden ausschließlich zum Zweck der Verbesserung des SuperMQ erfasst und nicht mit böswilliger Absicht verwendet. Die Bereitstellungszusammenfassung finden Sie auf unserer Website.

Die gesammelten Daten umfassen:

• IP -Adresse - Wird für ungefähre Standortinformationen zu Bereitstellungen verwendet.
• Dienste verwendet - um zu verstehen, welche Funktionen beliebt sind, und zukünftige Entwicklungen priorisieren.
• Zuletzt Zeit - um die Stabilität und Verfügbarkeit von SuperMQ zu gewährleisten.
• Supermq -Version - So verfolgen Sie die Softwareversion und liefern relevante Updates.

Wir nehmen Ihre Privatsphäre und Datensicherheit ernst. Alle gesammelten Daten werden gemäß unseren strengen Datenschutzrichtlinien und Best Practices der Branche behandelt.

Die Datenerfassung ist standardmäßig eingeschaltet und kann deaktiviert werden, indem die Env -Variable festgelegt wird: SMQ_SEND_TELEMETRY=false

Durch die Verwendung von SuperMQ tragen Sie aktiv zur Verbesserung bei. Gemeinsam können wir eine robustere und effizientere Plattform aufbauen. Vielen Dank für Ihr Vertrauen in Supermq!