

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

# Pialang MQTT 3.1.1 (Moquette)
<a name="mqtt-broker-moquette-component"></a>

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](https://github.com/moquette-io/moquette). Terapkan broker MQTT ini untuk menjalankan broker MQTT ringan. Untuk informasi lebih lanjut tentang cara memilih broker MQTT, lihat[Pilih broker MQTT](choose-local-mqtt-broker.md).

Broker ini mengimplementasikan protokol MQTT 3.1.1. Ini termasuk dukungan untuk QoS 0, QoS 1, QoS 2 pesan yang dipertahankan, pesan terakhir, dan sesi persisten.

**catatan**  <a name="client-device-component-context"></a>
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](interact-with-local-iot-devices.md).

**Topics**
+ [Versi](#mqtt-broker-moquette-component-versions)
+ [Tipe](#mqtt-broker-moquette-component-type)
+ [Sistem operasi](#mqtt-broker-moquette-component-os-support)
+ [Persyaratan](#mqtt-broker-moquette-component-requirements)
+ [Dependensi](#mqtt-broker-moquette-component-dependencies)
+ [Konfigurasi](#mqtt-broker-moquette-component-configuration)
+ [File log lokal](#mqtt-broker-moquette-component-log-file)
+ [Changelog](#mqtt-broker-moquette-component-changelog)

## Versi
<a name="mqtt-broker-moquette-component-versions"></a>

Komponen ini memiliki versi berikut:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Tipe
<a name="mqtt-broker-moquette-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Komponen ini adalah komponen plugin (`aws.greengrass.plugin`). [Inti Greengrass](greengrass-nucleus-component.md) menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini pada perangkat inti.

<a name="public-component-type-plugin-para2"></a>Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md).

<a name="public-component-type-more-information"></a>Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types).

## Sistem operasi
<a name="mqtt-broker-moquette-component-os-support"></a>

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

## Persyaratan
<a name="mqtt-broker-moquette-component-requirements"></a>

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.

  <a name="mqtt-broker-configuration-mqtt-bridge-requirement"></a>Jika Anda menentukan port yang berbeda, dan Anda menggunakan komponen jembatan [ MQTT untuk menyampaikan pesan MQTT ](mqtt-bridge-component.md) ke broker lain, Anda harus menggunakan MQTT bridge v2.1.0 atau yang lebih baru. Konfigurasikan untuk menggunakan port tempat broker MQTT beroperasi.

  <a name="mqtt-broker-configuration-ip-detector-requirement"></a>Jika Anda menentukan port yang berbeda, dan Anda menggunakan komponen detektor [ IP ](ip-detector-component.md) untuk mengelola titik akhir broker MQTT, Anda harus menggunakan detektor IP v2.1.0 atau yang lebih baru. Konfigurasikan untuk melaporkan port tempat broker MQTT beroperasi.
+ Komponen broker Moquette MQTT didukung untuk berjalan di VPC.

## Dependensi
<a name="mqtt-broker-moquette-component-dependencies"></a>

Saat Anda menerapkan komponen, AWS IoT Greengrass juga menerapkan 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](#mqtt-broker-moquette-component-changelog) 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](https://console.aws.amazon.com/greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**.

------
#### [ 2.3.7 ]

Tabel berikut mencantumkan dependensi untuk versi 2.3.7 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Auth perangkat klien ](client-device-auth-component.md) | > = 2.2.0 <2.6.0 | Keras | 

------
#### [ 2.3.2 – 2.3.6 ]

Tabel berikut mencantumkan dependensi untuk versi 2.3.2 hingga 2.3.6 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Auth perangkat klien ](client-device-auth-component.md) | > =2.2.0 <2.5.0 | Keras | 

------
#### [ 2.3.0 and 2.3.1 ]

Tabel berikut mencantumkan dependensi untuk versi 2.3.0 dan 2.3.1 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Auth perangkat klien ](client-device-auth-component.md) | >=2.2.0 <2.4.0 | Keras | 

------
#### [ 2.2.0 ]

Tabel berikut mencantumkan dependensi untuk versi 2.2.0 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Auth perangkat klien ](client-device-auth-component.md) | >=2.2.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 ](client-device-auth-component.md) | >=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 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Auth perangkat klien ](client-device-auth-component.md) | >=2.0.0 <2.1.0 | Keras | 

------

Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies).

## Konfigurasi
<a name="mqtt-broker-moquette-component-configuration"></a>

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

`moquette`  
(Opsional) KOnfigurasi [broker Moquette MQTT](https://github.com/moquette-io/moquette) yang akan digunakan. Anda dapat mengonfigurasi subset dari opsi konfigurasi Moqeutte dalam komponen ini. Untuk informasi selengkapnya, lihat komentar sebaris pada [file konfigurasi Moquette](https://github.com/moquette-io/moquette/blob/main/distribution/src/main/resources/moquette.conf).  
Objek ini berisi informasi berikut:    
`ssl_port`  
(Opsional) Port tempat broker MQTT beroperasi.  
<a name="mqtt-broker-configuration-mqtt-bridge-requirement"></a>Jika Anda menentukan port yang berbeda, dan Anda menggunakan komponen jembatan [ MQTT untuk menyampaikan pesan MQTT ](mqtt-bridge-component.md) ke broker lain, Anda harus menggunakan MQTT bridge v2.1.0 atau yang lebih baru. Konfigurasikan untuk menggunakan port tempat broker MQTT beroperasi.  
<a name="mqtt-broker-configuration-ip-detector-requirement"></a>Jika Anda menentukan port yang berbeda, dan Anda menggunakan komponen detektor [ IP ](ip-detector-component.md) untuk mengelola titik akhir broker MQTT, Anda harus menggunakan detektor IP v2.1.0 atau yang 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)

startup TimeoutSeconds  
(Opsional) Waktu maksimum dalam detik untuk memulai komponen. Status komponen berubah menjadi `BROKEN` jika melebihi batas waktu ini.  
Default: `120`

**Example Contoh: Pembaruan gabungan konfigurasi**  
Contoh konfigurasi berikut menentukan untuk mengoperasikan broker MQTT pada port 443.  

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

## File log lokal
<a name="mqtt-broker-moquette-component-log-file"></a>

Komponen ini menggunakan file log yang sama dengan [ komponen inti ](greengrass-nucleus-component.md) Greengrass.

------
#### [ 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/v2}}` atau {{C:\\greengrass\\v2}} dengan jalur ke folder AWS IoT Greengrass root.

------
#### [ Linux ]

  ```
  sudo tail -f {{/greengrass/v2}}/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content {{C:\greengrass\v2}}\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="mqtt-broker-moquette-component-changelog"></a>

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.


|  **Versi **  |  **Perubahan **  | 
| --- | --- | 
| 2.3.7 | Versi diperbarui untuk ril [ is autentikasi perangkat klien ](client-device-auth-component.md) versi 2.5.0. | 
| 2.3.6 |  **Perbaikan bug dan peningkatan**<br />   Perbaikan bug umum dan perbaikan.     | 
| 2.3.5 |  **Perbaikan bug dan peningkatan**<br />   Diperbarui Moquette ke versi 0.17.     | 
| 2.3.4 |  **Perbaikan bug dan peningkatan**<br />   Memperbaiki masalah di mana klien mungkin mengalami kesalahan sesi yang tidak valid saat mengirim atau menerima pesan, karena duplikat ID klien. Masalah ini menyebabkan sesi klien ditutup.     | 
| 2.3.3 |  <a name="changelog-mqtt-broker-moquette-2.3.3"></a>**Fitur baru**<br /> Menambahkan opsi `startupTimeoutSeconds` konfigurasi baru.   | 
| 2.3.2 | Versi diperbarui untuk ril [ is autentikasi perangkat klien ](client-device-auth-component.md) versi 2.4.0. | 
| 2.3.1 |  **Perbaikan bug dan peningkatan**<br />   Memperbaiki kondisi balapan di mana klien mungkin terputus setelah mencoba menyambung kembali, karena sesi yang tidak valid.     | 
| 2.3.0 | Menambahkan dukungan untuk rantai sertifikat. | 
| 2.2.0 | Versi diperbarui untuk ril [ is autentikasi perangkat klien ](client-device-auth-component.md) versi 2.2.0. | 
| 2.1.0 |  **Perbaikan bug dan peningkatan**<br />   Memperbarui komponen ini untuk menggunakan [ Moquette ](https://github.com/moquette-io/moquette) versi 0.16, yang meningkatkan kinerja dan menyertakan beberapa peningkatan lainnya.   Memperbaiki masalah di mana sertifikat server MQTT lokal berputar lebih sering daripada yang dimaksudkan dalam skenario tertentu. <br />Untuk menerapkan perbaikan ini, Anda juga harus menggunakan v2.1.0 atau yang lebih baru dari komponen [ autentikasi perangkat klien. ](client-device-auth-component.md)     | 
| 2.0.2 |  **Perbaikan bug dan peningkatan**<br />   Meningkatkan ukuran pesan MQTT maksimum dari 8.092 byte menjadi 128 kilobyte. Batas payload pesan MQTT yang efektif sedikit kurang, karena batas ukuran pesan mencakup header pesan.   Menambahkan dukungan untuk nilai integer dalam `ssl_port` parameter.     | 
| 2.0.1 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | 
| 2.0.0 | Versi awal. | 