Broker MQTT 3.1.1 (Moquette) - AWS IoT Greengrass

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Broker MQTT 3.1.1 (Moquette)

Il componente broker Moquette MQTT (aws.greengrass.clientdevices.mqtt.Moquette) gestisce i messaggi MQTT tra i dispositivi client e un dispositivo core Greengrass. Questo componente fornisce una versione modificata del broker Moquette MQTT. Implementa questo broker MQTT per gestire un broker MQTT leggero. Per ulteriori informazioni su come scegliere un broker MQTT, consulta. Scegli un broker MQTT

Questo broker implementa il protocollo MQTT 3.1.1. Include il supporto per i messaggi conservati di QoS 0, QoS 1, QoS 2, i messaggi di ultima volontà e le sessioni persistenti.

Nota

I dispositivi client sono dispositivi IoT locali che si connettono a un dispositivo core Greengrass per inviare messaggi MQTT e dati da elaborare. Per ulteriori informazioni, consulta Interagisci con dispositivi IoT locali.

Versioni

Questo componente ha le seguenti versioni:

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2,0x

Type

Questo componente è un componente del plugin ()aws.greengrass.plugin. Il nucleo Greengrass esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

Questo componente utilizza lo stesso file di registro del nucleo Greengrass. Per ulteriori informazioni, consulta Monitora AWS IoT Greengrass i registri.

Per ulteriori informazioni, consultare Tipi di componenti.

Sistema operativo

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:

  • Linux

  • Windows

Requisiti

Questo componente presenta i seguenti requisiti:

  • Il dispositivo principale deve essere in grado di accettare connessioni sulla porta in cui opera il broker MQTT. Per impostazione predefinita, questo componente esegue il broker MQTT sulla porta 8883. È possibile specificare una porta diversa quando si configura questo componente.

    Se si specifica una porta diversa e si utilizza il componente bridge MQTT per inoltrare messaggi MQTT ad altri broker, è necessario utilizzare MQTT bridge v2.1.0 o versione successiva. Configuralo per utilizzare la porta su cui opera il broker MQTT.

    Se si specifica una porta diversa e si utilizza il componente IP detector per gestire gli endpoint del broker MQTT, è necessario utilizzare IP detector v2.1.0 o versione successiva. Configuralo per segnalare la porta su cui opera il broker MQTT.

  • Il componente broker Moquette MQTT è supportato per l'esecuzione in un VPC.

Dipendenze

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le versioni rilasciate di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass Nella pagina dei dettagli del componente, cerca l'elenco delle dipendenze.

2.3.7

La tabella seguente elenca le dipendenze per la versione 2.3.7 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Autenticazione del dispositivo client >=2.2.0 <2.6.0 Rigidi
2.3.2 – 2.3.6

La tabella seguente elenca le dipendenze per le versioni da 2.3.2 a 2.3.6 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Autenticazione del dispositivo client >=2.2.0 <2.5.0 Rigidi
2.3.0 and 2.3.1

La tabella seguente elenca le dipendenze per le versioni 2.3.0 e 2.3.1 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Autenticazione del dispositivo client >=2.2.0 <2.4.0 Rigidi
2.2.0

La tabella seguente elenca le dipendenze per la versione 2.2.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Autenticazione del dispositivo client >=2.2.0 <2.3.0 Rigidi
2.1.0

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Autenticazione del dispositivo client >=2.0.0 <2.2.0 Rigidi
2.0.0 - 2.0.2

La tabella seguente elenca le dipendenze per le versioni da 2.0.0 a 2.0.2 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Autenticazione del dispositivo client >=2.0.0 <2.1.0 Rigidi

Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.

Configurazione

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

moquette

(Facoltativo) La configurazione del broker Moquette MQTT da utilizzare. È possibile configurare un sottoinsieme di opzioni di configurazione Moquette in questo componente. Per ulteriori informazioni, consultate i commenti in linea nel file di configurazione di Moquette.

Questo oggetto contiene le seguenti informazioni:

ssl_port

(Facoltativo) La porta in cui opera il broker MQTT.

Nota

Se si specifica una porta diversa e si utilizza il componente bridge MQTT per inoltrare messaggi MQTT ad altri broker, è necessario utilizzare MQTT bridge v2.1.0 o versione successiva. Configuralo per utilizzare la porta su cui opera il broker MQTT.

Se si specifica una porta diversa e si utilizza il componente IP detector per gestire gli endpoint del broker MQTT, è necessario utilizzare IP detector v2.1.0 o versione successiva. Configuralo per segnalare la porta su cui opera il broker MQTT.

Impostazione predefinita: 8883

host

(Facoltativo) L'interfaccia a cui si collega il broker MQTT. Ad esempio, è possibile modificare questo parametro in modo che il broker MQTT si colleghi solo a una rete locale specifica.

Impostazione predefinita: 0.0.0.0 (si collega a tutte le interfacce di rete)

startupTimeoutSeconds

(Facoltativo) Il tempo massimo, in secondi, di avvio del componente. Lo stato del componente cambia BROKEN se supera questo timeout.

Impostazione predefinita: 120

Esempio: fusione e aggiornamento della configurazione

La configurazione di esempio seguente specifica di utilizzare il broker MQTT sulla porta 443.

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

File di registro locale

Questo componente utilizza lo stesso file di registro del componente Greengrass nucleus.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Per visualizzare i log di questo componente
  • Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci /greengrass/v2 o C:\greengrass\v2 con il percorso della cartella AWS IoT Greengrass principale.

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

Changelog

La tabella seguente descrive le modifiche in ogni versione del componente.

Versione

Modifiche

2.3.7

Versione aggiornata per la versione 2.5.0 di autenticazione dei dispositivi client.

2.3.6

Correzioni di bug e miglioramenti
  • Correzioni di bug generali e miglioramenti.

2.3.5

Correzioni di bug e miglioramenti
  • Moquette aggiornata alla versione 0.17.

2.3.4

Correzioni di bug e miglioramenti
  • Risolve un problema per cui i client potrebbero riscontrare errori di sessione non validi durante l'invio o la ricezione di messaggi, a causa di ID client duplicati. Questo problema ha causato la chiusura della sessione del client.

2.3.3

Nuove funzionalità

Aggiunge una nuova opzione startupTimeoutSeconds di configurazione.

2.3.2

Versione aggiornata per la versione 2.4.0 di autenticazione dei dispositivi client.

2.3.1

Correzioni di bug e miglioramenti
  • Risolve una condizione di gara in cui i client potevano essere disconnessi dopo aver tentato di riconnettersi a causa di una sessione non valida.

2.3.0

Aggiunge il supporto per le catene di certificati.

2.2.0

Versione aggiornata per la versione 2.2.0 di autenticazione dei dispositivi client.

2.1.0

Correzioni di bug e miglioramenti

2.0.2

Correzioni di bug e miglioramenti
  • Aumenta la dimensione massima dei messaggi MQTT da 8.092 byte a 128 kilobyte. Il limite effettivo di payload dei messaggi MQTT è leggermente inferiore, poiché il limite di dimensione dei messaggi include le intestazioni dei messaggi.

  • Aggiunge il supporto per i valori interi nel parametro. ssl_port

2.0.1

Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.

2.0.0

Versione iniziale.