supermq

Supermq

SuperMQ est moderne, évolutif, sécurisé, open-source et cloud-plateforme sans brevet pour la messagerie et l'architecture axée sur les événements (EDA) écrite dans Go.

Il accepte les connexions utilisateur et client (périphérique, utilisateur, application) sur divers protocoles de réseau (c.-à-d. HTTP, MQTT, WebSocket, COAP), faisant ainsi un pont transparent entre eux. Il est utilisé comme squelette d'architecture pour construire des solutions distribuées complexes.

Pour plus de détails, consultez la documentation officielle. Pour des bits et services supplémentaires, consultez notre référentiel contrib.

Caractéristiques

• Connectivité et pontage multi-protocole (HTTP, MQTT, WebSocket et COAP; voir le référentiel contrib pour Lora et OPC UA)
• Gestion et provisionnement des appareils (provisionnement Zero Touch)
• Authentification mutuelle TLS (MTLS) à l'aide de certificats X.509
• Contrôle d'accès à grains fins (politiques, ABAC / RBAC)
• Persistance des messages (Timescale et Postgressql - Voir Contrib Repository pour Cassandra, affluxDB et MongoDB Support)
• Plateforme de journalisation et de support d'instrumentation (Prométhée et OpenTelemetry)
• Sourcing d'événements
• Déploiement basé sur les conteneurs à l'aide de Docker et Kubernetes
• Services d'agent et d'exportation Edge pour la gestion distante de la passerelle IoT et l'informatique Edge
• SDK
• CLI
• Petite empreinte mémoire et exécution rapide
• Architecture de conception axée sur le domaine, code de haute qualité et couverture de test

Condition préalable

Les éléments suivants sont nécessaires pour exécuter SuperMQ:

• Docker (version 26.0.0)

Le développement de SuperMQ nécessitera également:

• GO (version 1.21)
• Protobuf (version 25.1)

Installer

Une fois les conditions préalables installées, exécutez les commandes suivantes à partir de la racine du projet:

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

Cela affichera les services Docker SuperMQ et les interconnectera. Cette commande peut également être exécutée à l'aide de la Makefile inclus du projet:

make run

Si vous souhaitez exécuter des services à partir du code de contrôle de version spécifique de GitHub et assurez-vous que SMQ_RELEASE_TAG dans .env est défini pour correspondre à la version de version

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

Vérifiez que le fichier .env contient:

SMQ_RELEASE_TAG= < release_number >

docker-compose doit être utilisé pour les déploiements de développement et de test. Pour la production, nous suggérons d'utiliser Kubernetes.

Usage

La façon la plus rapide de commencer à utiliser SuperMQ est via la CLI. La dernière version peut être téléchargée à partir de la page des versions officielles.

Il peut également être construit et utilisé à partir du répertoire racine du projet:

make cli
./build/cli version

Des détails supplémentaires sur l'utilisation de la CLI peuvent être trouvés dans la documentation de la CLI.

Documentation

La documentation officielle est hébergée sur la page officielle de SuperMQ. La documentation est générée automatiquement, consultez les instructions sur le référentiel officiel des documents:

Si vous apercevez une erreur ou un besoin de corrections, veuillez nous en informer - ou encore mieux: envoyez-nous un PR.

Auteurs

L'architecte principal et le projet BDFL du SuperMQ est @DRasko.

De plus, @NMarcetic et @ Janko-Isidorovic ont assuré l'architecture et la conception globales, tandis que @manuio et @DarkoDaSkovic ont aidé à créer une implémentation initiale et ont continué à travailler en permanence sur les évolutions du projet.

Outre eux, SuperMQ est constamment amélioré et activement développé par @ anovakovic01, @ DUSANB94, @Srados, @Gsaleh, @Blokovi, @Chombium, @Mteodor, @rodneyosodo et un grand ensemble de contributeurs.

Les responsables sont répertoriés dans le fichier des responsables.

L'équipe de SuperMQ tient à remercier particulièrement @MIJicd pour son travail monumental sur la conception et la mise en œuvre d'une version très améliorée et optimisée de la plate-forme, et @malidukica pour ses efforts sur la mise en œuvre de l'interface utilisateur initiale.

Soutien professionnel

De nombreuses entreprises offrent un soutien professionnel pour le système SuperMQ.

Si vous avez besoin de ce type de soutien, le mieux est de contacter directement @drasko, et il vous indiquera l'équipe de soutien de la meilleure correspondance.

Contributif

Merci pour votre intérêt pour Supermq et le désir de contribuer!

1. Jetez un œil à nos problèmes ouverts. L'étiquette de bon problème est spécifiquement pour des problèmes qui sont parfaits pour commencer.
2. Découvrez le guide de contribution pour en savoir plus sur notre style et nos conventions.
3. Rendez vos modifications compatibles avec notre flux de travail.

Explorez également notre référentiel Contrib pour des services supplémentaires tels que Cassandra, InfluxDB, MongoDB Readers and Writers, LORA, OPC UA Support, Digital Twins, etc. Si vous avez une contribution qui ne convient pas au Core Monorepo (il est spécifique à votre cas d'utilisation, c'est une fonctionnalité supplémentaire ou un nouveau service, il est facultatif ou un module complémentaire), c'est un excellent endroit pour soumettre la demande de traction.

Nous embauchons

Vous aimez Supermq et vous aimeriez en faire votre travail de jour? Nous recherchons toujours des ingénieurs talentueux intéressés par les systèmes open-source, IoT et distribués. Si vous vous reconnaissez, contactez @Drasko - il vous contactera.

La meilleure façon d'attirer notre attention est, bien sûr, en envoyant des PR ?.

Communauté

• Groupe Google
• Givreuse
• Gazouillement

Licence

Apache-2.0

Collecte de données pour Supermq

SuperMQ s'engage à améliorer continuellement ses services et à assurer une expérience transparente pour ses utilisateurs. Pour y parvenir, nous collectons certaines données de vos déploiements. Rassurez-vous, ces données sont collectées uniquement dans le but d'améliorer le SuperMQ et ne sont pas utilisées avec une intention malveillante. Le résumé du déploiement se trouve sur notre site Web.

Les données collectées comprennent:

• Adresse IP - Utilisé pour les informations de localisation approximatives sur les déploiements.
• Services utilisés - pour comprendre quelles fonctionnalités sont populaires et hiérarchiser les développements futurs.
• Dernière heure due - pour assurer la stabilité et la disponibilité de Supermq.
• SuperMQ Version - Pour suivre la version logicielle et fournir des mises à jour pertinentes.

Nous prenons au sérieux votre confidentialité et votre sécurité des données. Toutes les données recueillies sont gérées conformément à nos politiques de confidentialité strictes et aux meilleures pratiques de l'industrie.

La collecte de données est allumée par défaut et peut être désactivée en définissant la variable Env: SMQ_SEND_TELEMETRY=false

En utilisant Supermq, vous contribuez activement à son amélioration. Ensemble, nous pouvons construire une plate-forme plus robuste et efficace. Merci pour votre confiance dans Supermq!