Versões Tipo Sistema operacional Requisitos Dependências Configuração Arquivo de log local Changelog

Agente MQTT 3.1.1 (Moquette)

O componente de agente Moquette MQTT (aws.greengrass.clientdevices.mqtt.Moquette) manipula mensagens MQTT entre dispositivos cliente e um dispositivo principal do Greengrass. Esse componente fornece uma versão modificada do agente Moquette MQTT. Implante esse agente MQTT para executar um agente MQTT leve. Para obter mais informações sobre como escolher um agente MQTT, consulte Escolher um agente MQTT.

Este agente implementa o protocolo MQTT 3.1.1. Inclui suporte para QoS 0, QoS 1, mensagens retidas de QoS 2, mensagens de última vontade e sessões persistentes.

nota

Os dispositivos clientes são dispositivos IoT locais que se conectam a um dispositivo central do Greengrass para enviar mensagens MQTT e dados para processamento. Para ter mais informações, consulte Interagir com dispositivos de IoT locais.

Versões

Esse componente tem as seguintes versões:

2.3.x
2.2.x
2.1.x
2.0.x

Tipo

Este componente é um componente de plug-in (aws.greengrass.plugin). O núcleo do Greengrass executa esse componente na mesma Java Virtual Machine (JVM) do núcleo. O núcleo é reiniciado quando você altera a versão desse componente no dispositivo principal.

Esse componente usa o mesmo arquivo de log do núcleo do Greengrass. Para ter mais informações, consulte Monitore AWS IoT Greengrass logs.

Para ter mais informações, consulte Tipos de componente.

Sistema operacional

Esse componente pode ser instalado em dispositivos principais que executam os seguintes sistemas operacionais:

Linux
Windows

Requisitos

Esse componente tem os seguintes requisitos:

O dispositivo principal deve ser capaz de aceitar conexões na porta em que o agente MQTT opera. Esse componente executa o agente MQTT na porta 8883 por padrão. Você pode especificar uma porta diferente ao configurar esse componente.

Se você especificar uma porta diferente e usar o componente de ponte MQTT para retransmitir mensagens MQTT para outros agentes, deverá usar a ponte MQTT v2.1.0 ou posterior. Configure-o para usar a porta em que o agente MQTT opera.

Se você especificar uma porta diferente e usar o componente detector de IP para gerenciar os endpoints do agente MQTT, deverá usar o detector de IP v2.1.0 ou posterior. Configure-o para relatar a porta em que o agente MQTT opera.
O componente de agente Moquette MQTT tem suporte para ser executado em uma VPC.

Dependências

Quando você implanta um componente, o AWS IoT Greengrass também implanta versões compatíveis das dependências dele. Isso significa que é preciso atender aos requisitos do componente e de todas as dependências dele para implantá-lo com êxito. Nesta seção, há uma lista de todas as dependências das versões lançadas desse componente e as restrições de versão semântica que definem as versões dos componentes para cada dependência. Também é possível visualizar as dependências de cada versão do componente no console do AWS IoT Greengrass. Na página de detalhes do componente, procure a lista de dependências.

2.3.7

A tabela a seguir lista as dependências da versão 2.3.7 desse componente.

Dependência	Versões compatíveis	Tipo de dependência
Autenticação do dispositivo cliente	>=2.2.0 <2.6.0	Rígido

2.3.2 – 2.3.6

A tabela a seguir lista as dependências das versões 2.3.2 a 2.3.6 desse componente.

Dependência	Versões compatíveis	Tipo de dependência
Autenticação do dispositivo cliente	>=2.2.0 <2.5.0	Rígido

2.3.0 and 2.3.1

A tabela a seguir lista as dependências das versões 2.3.0 e 2.3.1 desse componente.

Dependência	Versões compatíveis	Tipo de dependência
Autenticação do dispositivo cliente	>=2.2.0 <2.4.0	Rígido

2.2.0

A tabela a seguir lista as dependências da versão 2.2.0 desse componente.

Dependência	Versões compatíveis	Tipo de dependência
Autenticação do dispositivo cliente	>=2.2.0 <2.3.0	Rígido

2.1.0

A tabela a seguir lista as dependências da versão 2.1.0 desse componente.

Dependência	Versões compatíveis	Tipo de dependência
Autenticação do dispositivo cliente	>=2.0.0 <2.2.0	Rígido

2.0.0 - 2.0.2

A tabela a seguir lista as dependências das versões 2.0.0 a 2.0.2 desse componente.

Dependência	Versões compatíveis	Tipo de dependência
Autenticação do dispositivo cliente	>=2.0.0 <2.1.0	Rígido

Para obter mais informações sobre as dependências dos componentes, consulte referência de fórmula do componente.

Configuração

Esse componente fornece os seguintes parâmetros de configuração que podem ser personalizados ao implantar o componente.

moquette

(Opcional) A configuração do agente Moquette MQTT a ser usada. Você pode configurar um subconjunto das opções de configuração do Moqeutte neste componente. Para obter mais informações, consulte os comentários embutidos no arquivo de configuração do Moquette.

Esse objeto contém as seguintes informações:

ssl_port

(Opcional) A porta em que o agente MQTT opera.

nota

Se você especificar uma porta diferente e usar o componente de ponte MQTT para retransmitir mensagens MQTT para outros agentes, deverá usar a ponte MQTT v2.1.0 ou posterior. Configure-o para usar a porta em que o agente MQTT opera.

Se você especificar uma porta diferente e usar o componente detector de IP para gerenciar os endpoints do agente MQTT, deverá usar o detector de IP v2.1.0 ou posterior. Configure-o para relatar a porta em que o agente MQTT opera.

Padrão: 8883

host

(Opcional) A interface na qual o agente MQTT se vincula. Por exemplo, você pode alterar esse parâmetro para que o agente MQTT se vincule somente a uma rede local específica.

Padrão: 0.0.0.0 (vincula a todas as interfaces de rede)

Tempo limite de inicialização em segundos

(Opcional) O tempo máximo em segundos para o componente iniciar. O estado do componente muda para BROKEN se ele exceder esse tempo limite.

Padrão: 120

exemplo Exemplo: atualização da mesclagem de configuração

O exemplo de configuração a seguir especifica a operação do agente MQTT na porta 443.


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

Arquivo de log local

Esse componente usa o mesmo arquivo de log do componente de núcleo do Greengrass.

Para exibir os logs desse componente

Execute o comando a seguir no dispositivo principal para visualizar o arquivo de log desse componente em tempo real. Substitua /greengrass/v2 ou C:\greengrass\v2 pelo caminho para a pasta raiz do AWS IoT Greengrass.
Linux
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
Windows (PowerShell)
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```

Changelog

A tabela a seguir descreve as alterações em cada versão do componente.

Version (Versão)	Alterações
2.3.7	Versão atualizada para autenticação de dispositivo cliente versão 2.5.0.
2.3.6	Correções de bugs e melhorias Melhorias e correções de erros gerais.
2.3.5	Correções de bugs e melhorias Moquette atualizado para a versão 0.17.
2.3.4	Correções de bugs e melhorias Corrige um problema em que os clientes podem enfrentar erros de sessão inválidos ao enviar ou receber mensagens, devido a IDs de clientes duplicados. Esse problema fez com que a sessão do cliente fosse encerrada.
2.3.3	Novos atributos Adiciona uma nova opção de configuração `startupTimeoutSeconds`.
2.3.2	Versão atualizada para autenticação de dispositivo cliente versão 2.4.0.
2.3.1	Correções de bugs e melhorias Corrige uma condição de corrida em que os clientes podem ser desconectados após tentarem se reconectar, devido a uma sessão inválida.
2.3.0	Adiciona suporte para cadeias de certificados.
2.2.0	Versão atualizada para a versão 2.2.0 da autenticação do dispositivo cliente.
2.1.0	Correções de bugs e melhorias Atualiza esse componente para usar a versão 0.16 do Moquette, que melhora o desempenho e inclui várias outras melhorias. Corrige um problema em que o certificado do servidor MQTT local gira com mais frequência do que o pretendido em determinados cenários. Para aplicar essa correção, você também deve usar a versão 2.1.0 ou posterior do componente de autenticação do dispositivo cliente.
2.0.2	Correções de bugs e melhorias Aumenta o tamanho máximo da mensagem MQTT de 8.092 bytes para 128 kilobytes. O limite efetivo de carga útil da mensagem MQTT é um pouco menor, porque o limite de tamanho da mensagem inclui cabeçalhos de mensagens. Adiciona suporte para valores inteiros no parâmetro `ssl_port`.
2.0.1	Versão atualizada para o lançamento da versão 2.4.0 do núcleo do Greengrass.
2.0.0	Versão inicial.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Ponte MQTT

MQTT5 corretor (sEMQX)