supermq

Supermq

SuperMQ adalah platform cloud yang modern, dapat diskalakan, aman, open-source, dan bebas paten untuk pesan dan arsitektur berbasis acara (EDA) yang ditulis dalam Go.

Ini menerima koneksi pengguna dan klien (perangkat, pengguna, aplikasi) atas berbagai protokol jaringan (yaitu HTTP, MQTT, WebSocket, CoAP), sehingga membuat jembatan yang mulus di antara mereka. Ini digunakan sebagai tulang punggung arsitektur untuk membangun solusi terdistribusi yang kompleks.

Untuk detail lebih lanjut, lihat dokumentasi resmi. Untuk bit dan layanan tambahan, lihat Repositori Kontrib kami.

Fitur

• Konektivitas dan Bridging Multi-Protokol (HTTP, MQTT, WebSocket dan Coap; lihat Repositori Kontrib untuk LORA dan OPC UA)
• Manajemen dan penyediaan perangkat (penyediaan nol sentuh)
• Mutual TLS Authentication (MTLS) menggunakan sertifikat X.509
• Kontrol akses berbutir halus (Kebijakan, ABAC/RBAC)
• Pesan Persistensi (Timescale dan PostgressQL - Lihat Kontrib Repositori untuk Cassandra, InfluxDB, dan Dukungan MongoDB)
• Platform Logging dan Dukungan Instrumentasi (Prometheus dan OpenTelemetry)
• Sumber Acara
• Penempatan berbasis kontainer menggunakan Docker dan Kubernetes
• EDGE AGEN DAN LAYANAN EKSPOR UNTUK REMOTE IOT GATEWAY MANAJEMEN DAN EDGE Computing
• SDK
• Cli
• Jejak kaki memori kecil dan eksekusi cepat
• Arsitektur desain berbasis domain, kode berkualitas tinggi dan cakupan pengujian

Prasyarat

Berikut ini diperlukan untuk menjalankan supermq:

• Docker (Versi 26.0.0)

Mengembangkan SuperMQ juga akan membutuhkan:

• Go (versi 1.21)
• Protobuf (Versi 25.1)

Memasang

Setelah prasyarat diinstal, jalankan perintah berikut dari root proyek:

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

Ini akan memunculkan layanan SuperMQ Docker dan menghubungkannya. Perintah ini juga dapat dieksekusi dengan menggunakan Makefile yang disertakan proyek:

make run

Jika Anda ingin menjalankan layanan dari kode checkout rilis tertentu dari GitHub dan pastikan bahwa SMQ_RELEASE_TAG di .env sedang diatur untuk mencocokkan versi rilis

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

Periksa file .env itu berisi:

SMQ_RELEASE_TAG= < release_number >

docker-compose harus digunakan untuk pengembangan dan pengujian penyebaran. Untuk produksi, kami sarankan menggunakan Kubernetes.

Penggunaan

Cara tercepat untuk mulai menggunakan SuperMQ adalah melalui CLI. Versi terbaru dapat diunduh dari halaman Rilis Resmi.

Itu juga dapat dibangun dan digunakan dari direktori root proyek:

make cli
./build/cli version

Rincian tambahan tentang penggunaan CLI dapat ditemukan dalam dokumentasi CLI.

Dokumentasi

Dokumentasi resmi di -host di halaman dokumen resmi SuperMQ. Dokumentasi dihasilkan secara otomatis, checkout instruksi pada repositori dokumen resmi:

Jika Anda menemukan kesalahan atau kebutuhan akan koreksi, beri tahu kami - atau bahkan lebih baik: kirimi kami PR.

Penulis

Arsitek utama dan BDFL dari Proyek SuperMQ adalah @Drasko.

Selain itu, @NMarcetic dan @Janko-Isidorovic meyakinkan arsitektur dan desain secara keseluruhan, sementara @manuio dan @darkodraskovic membantu menyusun implementasi awal dan terus bekerja pada evolusi proyek.

Selain mereka, SuperMQ terus -menerus ditingkatkan dan dikembangkan secara aktif oleh @anovakovic01, @dusanb94, @srados, @gsaleh, @blokovi, @chombium, @mteodor, @rodneyosodo dan satu set besar kontributor.

Pemelihara terdaftar dalam file pengelola.

Tim SuperMQ ingin mengucapkan terima kasih khusus kepada @MijICD untuk pekerjaannya yang monumental dalam merancang dan mengimplementasikan versi platform yang sangat ditingkatkan dan dioptimalkan, dan @Malidukica atas upayanya dalam mengimplementasikan antarmuka pengguna awal.

Dukungan profesional

Ada banyak perusahaan yang menawarkan dukungan profesional untuk sistem SuperMQ.

Jika Anda membutuhkan dukungan semacam ini, yang terbaik adalah menjangkau @Drasko secara langsung, dan ia akan menunjukkan Anda ke tim pendukung yang paling cocok.

Berkontribusi

Terima kasih atas minat Anda pada SuperMQ dan keinginan untuk berkontribusi!

1. Lihatlah masalah terbuka kami. Label edisi pertama yang baik khusus untuk masalah yang bagus untuk memulai.
2. CHECKOUT Panduan Kontribusi untuk mempelajari lebih lanjut tentang gaya dan konvensi kami.
3. Jadikan perubahan Anda kompatibel dengan alur kerja kami.

Juga, jelajahi repositori kontribusi kami untuk layanan tambahan seperti Cassandra, InfluxDB, pembaca dan penulis MongoDB, Lora, dukungan OPC UA, kembar digital, dan banyak lagi. Jika Anda memiliki kontribusi yang tidak cocok untuk monorepo inti (khusus untuk kasus penggunaan Anda, ini adalah fitur tambahan atau layanan baru, ini opsional atau add-on), ini adalah tempat yang bagus untuk mengirimkan permintaan tarik.

Kami sedang merekrut

Anda menyukai SuperMQ dan Anda ingin menjadikannya pekerjaan harian Anda? Kami selalu mencari insinyur berbakat yang tertarik dengan open-source, IoT, dan sistem terdistribusi. Jika Anda mengenali diri sendiri, hubungi @Drasko - dia akan menghubungi Anda kembali.

Cara terbaik untuk menarik perhatian kita adalah, tentu saja, dengan mengirim PR?

Masyarakat

• Google Group
• Gitter
• Twitter

Lisensi

Apache-2.0

Pengumpulan data untuk supermq

SuperMQ berkomitmen untuk terus meningkatkan layanannya dan memastikan pengalaman yang mulus bagi penggunanya. Untuk mencapai ini, kami mengumpulkan data tertentu dari penyebaran Anda. Yakinlah, data ini dikumpulkan semata -mata untuk tujuan meningkatkan SuperMQ dan tidak digunakan dengan niat jahat apa pun. Ringkasan penempatan dapat ditemukan di situs web kami.

Data yang dikumpulkan meliputi:

• Alamat IP - Digunakan untuk perkiraan informasi lokasi tentang penyebaran.
• Layanan yang digunakan - untuk memahami fitur mana yang populer dan memprioritaskan perkembangan di masa depan.
• Waktu yang terlihat terakhir - untuk memastikan stabilitas dan ketersediaan SuperMQ.
• Versi SuperMQ - Untuk melacak versi perangkat lunak dan memberikan pembaruan yang relevan.

Kami menanggapi privasi dan keamanan data Anda dengan serius. Semua data yang dikumpulkan ditangani sesuai dengan kebijakan privasi kami yang ketat dan praktik terbaik industri.

Pengumpulan data aktif secara default dan dapat dinonaktifkan dengan mengatur variabel env: SMQ_SEND_TELEMETRY=false

Dengan memanfaatkan SuperMQ, Anda secara aktif berkontribusi pada peningkatannya. Bersama -sama, kita dapat membangun platform yang lebih kuat dan efisien. Terima kasih atas kepercayaan Anda pada SuperMQ!