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

Corretor 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 broker Moquette MQTT. Implante esse broker MQTT para executar um broker MQTT leve. Para obter mais informações sobre como escolher um corretor MQTT, consulteEscolha um corretor MQTT.

Esse corretor 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 cliente são dispositivos IoT locais que se conectam a um dispositivo central do Greengrass para enviar mensagens e dados MQTT para processamento. Para ter mais informações, consulte Interaja com dispositivos 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 reinicia 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 os registros.

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

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 corretores, 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 broker 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 corretor Moquette MQTT tem suporte para ser executado em uma VPC.

Dependências

Quando você implanta um componente, AWS IoT Greengrass também implanta versões compatíveis de suas dependências. Isso significa que você deve atender aos requisitos do componente e de todas as suas dependências para implantá-lo com êxito. Esta seção lista as dependências das versões lançadas desse componente e as restrições de versão semântica que definem as versões do componente para cada dependência. Você também pode visualizar as dependências de cada versão do componente no AWS IoT Greengrass console. 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 dependências de componentes, consulte a referência da receita do componente.

Configuração

Esse componente fornece os seguintes parâmetros de configuração que você pode personalizar ao implantar o componente.

moquette

(Opcional) A configuração do broker 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 corretor MQTT opera.

nota

Se você especificar uma porta diferente e usar o componente de ponte MQTT para retransmitir mensagens MQTT para outros corretores, 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 broker 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 corretor MQTT se vincula. Por exemplo, você pode alterar esse parâmetro para que o broker MQTT se vincule somente a uma rede local específica.

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

startupTimeoutSeconds

(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ções

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 do núcleo do Greengrass.

Para ver os registros 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 AWS IoT Greengrass raiz.
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 a versão 2.5.0 da autenticação do dispositivo cliente.
2.3.6	Correções de erros e melhorias Melhorias e correções de erros gerais.
2.3.5	Correções de erros e melhorias Moquette atualizado para a versão 0.17.
2.3.4	Correções de erros 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 `startupTimeoutSeconds` de configuração.
2.3.2	Versão atualizada para a versão 2.4.0 da autenticação do dispositivo cliente.
2.3.1	Correções de erros 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 erros 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 erros 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 `ssl_port` parâmetro.
2.0.1	Versão atualizada para a versão 2.4.0 do Greengrass nucleus.
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

Corretora MQTT 5 (EMQX)