As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Agente MQTT 3.1.1 (Moquette)
<a name="mqtt-broker-moquette-component"></a>

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](https://github.com/moquette-io/moquette). 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](choose-local-mqtt-broker.md).

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**  <a name="client-device-component-context"></a>
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 obter mais informações, consulte [Interagir com dispositivos de IoT locais](interact-with-local-iot-devices.md).

**Topics**
+ [Versões](#mqtt-broker-moquette-component-versions)
+ [Tipo](#mqtt-broker-moquette-component-type)
+ [Sistema operacional](#mqtt-broker-moquette-component-os-support)
+ [Requisitos](#mqtt-broker-moquette-component-requirements)
+ [Dependências](#mqtt-broker-moquette-component-dependencies)
+ [Configuração](#mqtt-broker-moquette-component-configuration)
+ [Arquivo de log local](#mqtt-broker-moquette-component-log-file)
+ [Changelog](#mqtt-broker-moquette-component-changelog)

## Versões
<a name="mqtt-broker-moquette-component-versions"></a>

Esse componente tem as seguintes versões:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Tipo
<a name="mqtt-broker-moquette-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Este componente é um componente de plug-in (`aws.greengrass.plugin`). O [Greengrass nucleus](greengrass-nucleus-component.md) 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.

<a name="public-component-type-plugin-para2"></a>Esse componente usa o mesmo arquivo de log do Greengrass nucleus. Para obter mais informações, consulte [Monitore AWS IoT Greengrass logs](monitor-logs.md).

<a name="public-component-type-more-information"></a>Para obter mais informações, consulte [Tipos de componente](develop-greengrass-components.md#component-types).

## Sistema operacional
<a name="mqtt-broker-moquette-component-os-support"></a>

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

## Requisitos
<a name="mqtt-broker-moquette-component-requirements"></a>

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. É possível especificar uma porta diferente ao configurar esse componente.

  <a name="mqtt-broker-configuration-mqtt-bridge-requirement"></a>Se você especificar uma porta diferente e usar o [componente de ponte MQTT](mqtt-bridge-component.md) 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.

  <a name="mqtt-broker-configuration-ip-detector-requirement"></a>Se você especificar uma porta diferente e usar o [componente detector de IP](ip-detector-component.md) 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
<a name="mqtt-broker-moquette-component-dependencies"></a>

Quando você implanta um componente, AWS IoT Greengrass também implanta versões compatíveis de suas dependências. 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](#mqtt-broker-moquette-component-changelog) 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](https://console.aws.amazon.com//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](client-device-auth-component.md) | >=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](client-device-auth-component.md) | >=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](client-device-auth-component.md) | >=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](client-device-auth-component.md) | >=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](client-device-auth-component.md) | >=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](client-device-auth-component.md) | >=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](component-recipe-reference.md#recipe-reference-component-dependencies).

## Configuração
<a name="mqtt-broker-moquette-component-configuration"></a>

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](https://github.com/moquette-io/moquette) 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](https://github.com/moquette-io/moquette/blob/main/distribution/src/main/resources/moquette.conf).  
Esse objeto contém as informações a seguir:    
`ssl_port`  
(Opcional) A porta em que o agente MQTT opera.  
<a name="mqtt-broker-configuration-mqtt-bridge-requirement"></a>Se você especificar uma porta diferente e usar o [componente de ponte MQTT](mqtt-bridge-component.md) 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.  
<a name="mqtt-broker-configuration-ip-detector-requirement"></a>Se você especificar uma porta diferente e usar o [componente detector de IP](ip-detector-component.md) 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)

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`

**Example 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
<a name="mqtt-broker-moquette-component-log-file"></a>

Esse componente usa o mesmo arquivo de log do componente de [Greengrass nucleus](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
{{/greengrass/v2}}/logs/greengrass.log
```

------
#### [ Windows ]

```
{{C:\greengrass\v2}}\logs\greengrass.log
```

------

**Para ver 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 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 name="mqtt-broker-moquette-component-changelog"></a>

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


|  **Versão**  |  **Alterações**  | 
| --- | --- | 
| 2.3.7 | Versão atualizada para [autenticação de dispositivo cliente](client-device-auth-component.md) versão 2.5.0. | 
| 2.3.6 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
| 2.3.5 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
| 2.3.4 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
| 2.3.3 |  <a name="changelog-mqtt-broker-moquette-2.3.3"></a>[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
| 2.3.2 | Versão atualizada para [autenticação de dispositivo cliente](client-device-auth-component.md) versão 2.4.0. | 
| 2.3.1 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
| 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](client-device-auth-component.md). | 
| 2.1.0 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
| 2.0.2 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
| 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. |