Versions Type Système d’exploitation Prérequis Dépendances Configuration Fichier journal local Journal des modifications

Courtier MQTT 3.1.1 (Moquette)

Le composant broker Moquette MQTT (aws.greengrass.clientdevices.mqtt.Moquette) gère les messages MQTT entre les appareils clients et un périphérique principal de Greengrass. Ce composant fournit une version modifiée du broker Moquette MQTT. Déployez ce broker MQTT pour exécuter un broker MQTT léger. Pour plus d'informations sur le choix d'un courtier MQTT, consultezChoisissez un courtier MQTT.

Ce broker implémente le protocole MQTT 3.1.1. Il inclut la prise en charge des messages conservés QoS 0, QoS 1, QoS 2, des messages de dernier testament et des sessions persistantes.

Note

Les appareils clients sont des appareils IoT locaux qui se connectent à un appareil principal de Greengrass pour envoyer des messages MQTT et des données à traiter. Pour plus d’informations, consultez Interagissez avec les appareils IoT locaux.

Versions

Les versions de ce composant sont les suivantes :

2.3.x
2.2.x
2,1x
2,0.x

Type

Ce composant est un composant de plugin (aws.greengrass.plugin). Le noyau Greengrass exécute ce composant dans la même machine virtuelle Java (JVM) que le noyau. Le noyau redémarre lorsque vous modifiez la version de ce composant sur le périphérique principal.

Ce composant utilise le même fichier journal que le noyau Greengrass. Pour plus d’informations, consultez AWS IoT GreengrassJournaux de surveillance.

Pour plus d’informations, consultez Types de composants.

Système d’exploitation

Ce composant peut être installé sur les appareils principaux qui exécutent les systèmes d'exploitation suivants :

Linux
Windows

Prérequis

Ce composant répond aux exigences suivantes :

Le périphérique principal doit être en mesure d'accepter des connexions sur le port où fonctionne le broker MQTT. Ce composant exécute le broker MQTT sur le port 8883 par défaut. Vous pouvez spécifier un port différent lorsque vous configurez ce composant.

Si vous spécifiez un port différent et que vous utilisez le composant pont MQTT pour relayer les messages MQTT à d'autres courtiers, vous devez utiliser le pont MQTT v2.1.0 ou version ultérieure. Configurez-le pour utiliser le port sur lequel le broker MQTT fonctionne.

Si vous spécifiez un port différent et que vous utilisez le composant de détection IP pour gérer les points de terminaison du broker MQTT, vous devez utiliser le détecteur IP v2.1.0 ou version ultérieure. Configurez-le pour signaler le port sur lequel le broker MQTT fonctionne.
Le composant broker Moquette MQTT est compatible pour fonctionner dans un VPC.

Dépendances

Lorsque vous déployez un composant, il déploie AWS IoT Greengrass également des versions compatibles de ses dépendances. Cela signifie que vous devez satisfaire aux exigences relatives au composant et à toutes ses dépendances pour réussir le déploiement du composant. Cette section répertorie les dépendances des versions publiées de ce composant et les contraintes de version sémantiques qui définissent les versions des composants pour chaque dépendance. Vous pouvez également consulter les dépendances de chaque version du composant dans la AWS IoT Greengrass console. Sur la page de détails du composant, recherchez la liste des dépendances.

2.3.7

Le tableau suivant répertorie les dépendances pour la version 2.3.7 de ce composant.

Dépendance	Versions compatibles	Type de dépendance
Authentification de l'appareil client	>=2,2,0 <2,6,0	Stricte

2.3.2 – 2.3.6

Le tableau suivant répertorie les dépendances pour les versions 2.3.2 à 2.3.6 de ce composant.

Dépendance	Versions compatibles	Type de dépendance
Authentification de l'appareil client	>=2,2,0 <2,5,0	Stricte

2.3.0 and 2.3.1

Le tableau suivant répertorie les dépendances pour les versions 2.3.0 et 2.3.1 de ce composant.

Dépendance	Versions compatibles	Type de dépendance
Authentification de l'appareil client	>=2,2,0 <2,4,0	Stricte

2.2.0

Le tableau suivant répertorie les dépendances pour la version 2.2.0 de ce composant.

Dépendance	Versions compatibles	Type de dépendance
Authentification de l'appareil client	>=2,2,0 <2,3,0	Stricte

2.1.0

Le tableau suivant répertorie les dépendances pour la version 2.1.0 de ce composant.

Dépendance	Versions compatibles	Type de dépendance
Authentification de l'appareil client	>=2,0.0 <2,2.0	Stricte

2.0.0 - 2.0.2

Le tableau suivant répertorie les dépendances pour les versions 2.0.0 à 2.0.2 de ce composant.

Dépendance	Versions compatibles	Type de dépendance
Authentification de l'appareil client	>=2,0.0 <2,10	Stricte

Pour plus d'informations sur les dépendances des composants, consultez la référence de la recette des composants.

Configuration

Ce composant fournit les paramètres de configuration suivants que vous pouvez personnaliser lorsque vous déployez le composant.

moquette

(Facultatif) La configuration du broker Moquette MQTT à utiliser. Vous pouvez configurer un sous-ensemble d'options de configuration de Moqeutte dans ce composant. Pour plus d'informations, consultez les commentaires intégrés dans le fichier de configuration de Moquette.

Cet objet contient les informations suivantes :

ssl_port

(Facultatif) Le port sur lequel le broker MQTT fonctionne.

Note

Si vous spécifiez un port différent et que vous utilisez le composant pont MQTT pour relayer les messages MQTT à d'autres courtiers, vous devez utiliser le pont MQTT v2.1.0 ou version ultérieure. Configurez-le pour utiliser le port sur lequel le broker MQTT fonctionne.

Si vous spécifiez un port différent et que vous utilisez le composant de détection IP pour gérer les points de terminaison du broker MQTT, vous devez utiliser le détecteur IP v2.1.0 ou version ultérieure. Configurez-le pour signaler le port sur lequel le broker MQTT fonctionne.

Par défaut : 8883

host

(Facultatif) Interface à laquelle le broker MQTT se lie. Par exemple, vous pouvez modifier ce paramètre afin que le broker MQTT se lie uniquement à un réseau local spécifique.

Par défaut : 0.0.0.0 (se lie à toutes les interfaces réseau)

startupTimeoutSeconds

(Facultatif) Durée maximale en secondes pendant laquelle le composant démarre. L'état du composant passe à BROKEN s'il dépasse ce délai d'attente.

Par défaut : 120

Exemple : mise à jour de la fusion de configurations

L'exemple de configuration suivant indique de faire fonctionner le broker MQTT sur le port 443.


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

Fichier journal local

Ce composant utilise le même fichier journal que le composant Greengrass nucleus.

Pour consulter les journaux de ce composant

Exécutez la commande suivante sur le périphérique principal pour afficher le fichier journal de ce composant en temps réel. Remplacez /greengrass/v2 C:\greengrass\v2 par le chemin d'accès au dossier AWS IoT Greengrass racine.
Linux
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
Windows (PowerShell)
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```

Journal des modifications

Le tableau suivant décrit les modifications apportées à chaque version du composant.

Version	Modifications
2.3.7	Version mise à jour pour la version 2.5.0 d'authentification du périphérique client.
2.3.6	Corrections de bogues et améliorations Correction et amélioration de bogues généraux
2.3.5	Corrections de bogues et améliorations Mise à jour de Moquette vers la version 0.17.
2.3.4	Corrections de bogues et améliorations Résout un problème selon lequel les clients pouvaient rencontrer des erreurs de session non valides lors de l'envoi ou de la réception de messages, en raison d'identifiants clients dupliqués. Ce problème a entraîné la fermeture de la session du client.
2.3.3	Nouvelles fonctionnalités Ajoute une nouvelle option `startupTimeoutSeconds` de configuration.
2.3.2	Version mise à jour pour la version 2.4.0 d'authentification du périphérique client.
2.3.1	Corrections de bogues et améliorations Corrige une situation de course dans laquelle les clients peuvent être déconnectés après avoir tenté de se reconnecter, en raison d'une session non valide.
2.3.0	Ajoute la prise en charge des chaînes de certificats.
2.2.0	Version mise à jour pour la version 2.2.0 d'authentification du périphérique client.
2.1.0	Corrections de bogues et améliorations Met à jour ce composant pour utiliser la version 0.16 de Moquette, qui améliore les performances et inclut plusieurs autres améliorations. Résout un problème selon lequel le certificat du serveur MQTT local change plus souvent que prévu dans certains scénarios. Pour appliquer ce correctif, vous devez également utiliser la version 2.1.0 ou ultérieure du composant d'authentification du périphérique client.
2.0.2	Corrections de bogues et améliorations Augmente la taille maximale des messages MQTT de 8 092 octets à 128 kilo-octets. La limite de charge utile effective des messages MQTT est légèrement inférieure, car la limite de taille des messages inclut les en-têtes de message. Ajoute la prise en charge des valeurs entières dans le `ssl_port` paramètre.
2.0.1	Version mise à jour pour la version 2.4.0 de Greengrass Nucleus.
2.0.0	Première version.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Pont MQTT

Courtier MQTT 5 (EMQX)