MQTT 3.1.1 broker (Moquette) - AWS IoT Greengrass

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

MQTT 3.1.1 broker (Moquette)

Komponen broker Moquette MQTT (aws.greengrass.clientdevices.mqtt.Moquette) menangani pesan MQTT antara perangkat klien dan perangkat inti Greengrass. Komponen ini menyediakan versi modifikasi broker Moquette MQTT. Menyebarkan broker MQTT ini untuk menjalankan broker MQTT ringan. Untuk informasi selengkapnya tentang cara memilih broker MQTT, lihatPilih broker MQTT.

Broker ini mengimplementasikan protokol MQTT 3.1.1. Termasuk di dalamnya dukungan untuk QoS 0, QoS 1, QoS 1, QoS 2, pesan yang dipertahankan, pesan kehendak terakhir, dan sesi terus-menerus.

catatan

Perangkat klien adalah perangkat IoT lokal yang terhubung ke perangkat inti Greengrass untuk mengirim pesan MQTT dan data yang akan diproses. Untuk informasi selengkapnya, lihat Berinteraksilah dengan perangkat IoT lokal.

Versi

Komponen ini memiliki versi berikut:

  • 2.2.x

  • 2.1.x

  • 2.0.x

Tipe

Komponen ini adalah komponen plugin (aws.greengrass.plugin). Inti Greengrass menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nucleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti.

Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat PemantauanAWS IoT Greengrasslog.

Untuk informasi selengkapnya, lihat Jenis komponen.

Sistem operasi

Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut:

  • Linux

  • Windows

Persyaratan

Komponen ini memiliki persyaratan sebagai berikut:

  • Perangkat inti harus dapat menerima koneksi pada port tempat broker MQTT beroperasi. Komponen ini menjalankan broker MQTT pada port 8883 secara default. Anda dapat menentukan port yang berbeda saat Anda mengonfigurasi komponen ini.

    Jika Anda menentukan port yang berbeda, dan Anda menggunakanKomponen jembatan MQTTuntuk menyampaikan pesan MQTT ke broker lain, Anda harus menggunakan jembatan MQTT v2.1.0 atau yang lebih baru. Konfigurasikan untuk menggunakan port tempat broker MQTT beroperasi.

    Jika Anda menentukan port yang berbeda, dan Anda menggunakanKomponen detektor IPuntuk mengelola titik akhir broker MQTT, Anda harus menggunakan detektor IP v2.1.0 atau lebih baru. Konfigurasikan untuk melaporkan port tempat broker MQTT beroperasi.

Dependensi

Saat Anda men-deploy komponen, AWS IoT Greengrass juga men-deploy versi dependensinya yang kompatibel. Ini berarti bahwa Anda harus memenuhi persyaratan untuk komponen dan semua dependensinya untuk berhasil men-deploy komponen. Bagian ini berisi daftar dependensi untuk versi yang dirilis dari komponen ini dan kendala versi semantik yang menentukan versi komponen untuk setiap dependensi. Anda juga dapat melihat dependensi untuk setiap versi komponen di konsol AWS IoT Greengrass tersebut. Pada halaman detail komponen, cari daftar Dependensi.

2.2.0

Tabel berikut mencantumkan dependensi untuk versi 2.2.0 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Auth perangkat klien >=2.0.0 <2.3.0 Keras
2.1.0

Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Auth perangkat klien >=2.0.0 <2.2.0 Keras
2.0.0 - 2.0.2

Tabel berikut mencantumkan dependensi untuk versi 2.0.0 hingga 2.0.2 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Auth perangkat klien >=2.0.0 <2.1.0 Keras

Untuk informasi selengkapnya tentang dependensi komponen, lihat referensi resep komponen.

Konfigurasi

Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen.

moquette

(Opsional) KOnfigurasi broker Moquette MQTT yang akan digunakan. Anda dapat mengonfigurasi subset dari opsi konfigurasi Moqeutte dalam komponen ini. Untuk informasi selengkapnya, lihat komentar sebaris pada file konfigurasi Moquette.

Objek ini berisi informasi berikut:

ssl_port

(Opsional) Port tempat broker MQTT beroperasi.

catatan

Jika Anda menentukan port yang berbeda, dan Anda menggunakanKomponen jembatan MQTTuntuk menyampaikan pesan MQTT ke broker lain, Anda harus menggunakan jembatan MQTT v2.1.0 atau yang lebih baru. Konfigurasikan untuk menggunakan port tempat broker MQTT beroperasi.

Jika Anda menentukan port yang berbeda, dan Anda menggunakanKomponen detektor IPuntuk mengelola titik akhir broker MQTT, Anda harus menggunakan detektor IP v2.1.0 atau lebih baru. Konfigurasikan untuk melaporkan port tempat broker MQTT beroperasi.

Default: 8883

host

(Opsional) Antarmuka tempat broker MQTT terikat. Misalnya, Anda dapat mengubah parameter ini sehingga broker MQTT terikat hanya pada jaringan lokal tertentu.

Default: 0.0.0.0 (terikat pada semua antarmuka jaringan)

contoh Contoh: Pembaruan gabungan konfigurasi

Contoh konfigurasi berikut menentukan untuk mengoperasikan broker MQTT pada port 443.

{ "moquette": { "ssl_port": "443" } }

File log lokal

Komponen ini menggunakan file log yang sama sepertiInti Greengrasskomponen.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log

Untuk melihat log komponen ini

  • Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti/greengrass/v2atauC:\greengrass\v2dengan jalur keAWS IoT Greengrassfolder akar.

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Changelog

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.

Versi

Perubahan

2.2.0

Versi diperbarui untukAuth perangkat klienrilis versi 2.2.0

2.1.0

Perbaikan bug dan peningkatan
  • Memperbarui komponen ini untuk digunakanMoketversi 0.16, yang meningkatkan kinerja dan mencakup beberapa perbaikan lainnya.

  • Memperbaiki masalah di mana sertifikat server MQTT lokal berputar lebih sering daripada yang dimaksudkan dalam skenario tertentu.

    Untuk menerapkan perbaikan ini, Anda juga harus menggunakan v2.1.0 atau lebih baru darikomponen auth perangkat klien.

2.0.2

Perbaikan bug dan peningkatan
  • Meningkatkan ukuran pesan MQTT maksimum dari 8.092 byte menjadi 128 kilobyte. Batas muatan pesan MQTT yang efektif sedikit kurang, karena batas ukuran pesan mencakup header pesan.

  • Menambahkan dukungan untuk nilai integer dissl_portparameter.

2.0.1

Versi yang diperbarui untuk rilis inti Greengrass versi 2.4.0

2.0.0

Versi awal.