View a markdown version of this page

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 principale di Greengrass. Questo componente fornisce una versione modificata del broker Moquette MQTT. https://github.com/moquette-io/moquette Implementa questo broker MQTT per eseguire 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 QoS 0, QoS 1, QoS 2, i messaggi lastwill e le sessioni persistenti.

Nota

I dispositivi client sono dispositivi IoT locali che si connettono a un dispositivo principale di Greengrass per inviare messaggi e dati MQTT 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.0.x

Tipo

Questo componente è un componente plug-in (aws.greengrass.plugin). Il nucleo di 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 di Greengrass. Per ulteriori informazioni, consulta Monitora AWS IoT Greengrass i registri.

Per ulteriori informazioni, consulta Tipi di componenti.

Sistema operativo

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

  • Linux

  • Windows

Requisiti

Questo componente ha 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 successivo. 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 successivo. 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, vengono distribuite AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti del 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 semantici della versione che definiscono le versioni dei componenti per ciascuna dipendenza. È inoltre possibile visualizzare le dipendenze per ciascuna 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. ComponentDependencies

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 di Moqeutte in questo componente. Per ulteriori informazioni, consultate i commenti in linea nel file di configurazione di Moquette. https://github.com/moquette-io/moquette/blob/main/distribution/src/main/resources/moquette.conf

Questo oggetto contiene le seguenti informazioni:

ssl_port

(Facoltativo) La porta su 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 successivo. 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 successivo. Configuralo per segnalare la porta su cui opera il broker MQTT.

Impostazione predefinita: 8883

host

(Opzionale) 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.

Predefinito: 0.0.0.0 (si lega a tutte le interfacce di rete)

avvio TimeoutSeconds

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

Impostazione predefinita: 120

Esempio Esempio: aggiornamento dell'unione delle configurazioni

La seguente configurazione di esempio 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 ciascuna versione del componente.

Versione

Modifiche

2.3.7

Versione aggiornata per la versione 2.5.0 di autenticazione del dispositivo client.

2.3.6

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

2.3.5

Correzioni di bug e miglioramenti
  • Moquette è stato aggiornato alla versione 0.17.

2.3.4

Correzioni di bug e miglioramenti
  • Risolve un problema a causa del quale 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 cliente.

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 del dispositivo client.

2.3.1

Correzioni di bug e miglioramenti
  • Risolve una situazione in cui i client potrebbero 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 del dispositivo client.

2.1.0

Correzioni di bug e miglioramenti
  • Aggiorna questo componente per utilizzare la versione 0.16 di Moquette, che migliora le prestazioni e include diversi altri miglioramenti.

  • Risolve un problema a causa del quale il certificato del server MQTT locale ruota più spesso del previsto in determinati scenari.

    Per applicare questa correzione, è necessario utilizzare anche la versione 2.1.0 o successiva del componente di autenticazione del dispositivo client. Autenticazione del dispositivo client

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 del messaggio include le intestazioni dei messaggi.

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

2.0.1

Versione aggiornata per Greengrass nucleus versione 2.4.0.

2.0.0

Versione iniziale.