Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

El componente agente MQTT de Moquette (`aws.greengrass.clientdevices.mqtt.Moquette`) gestiona los mensajes MQTT entre los dispositivos de cliente y un dispositivo principal de Greengrass. Este componente proporciona una versión modificada del [agente MQTT de Moquette](https://github.com/moquette-io/moquette). Implemente este agente MQTT para ejecutar un agente de MQTT ligero. Para más información sobre cómo elegir un agente MQTT, consulte [Elección de un agente MQTT](choose-local-mqtt-broker.md).

Este agente implementa el protocolo MQTT 3.1.1. Incluye compatibilidad con mensajes retenidos por QoS 0, QoS 1, QoS 2 y sesiones persistentes.

**nota**  <a name="client-device-component-context"></a>
Los dispositivos de cliente son dispositivos IoT locales que se conectan a un dispositivo principal de Greengrass para enviar mensajes MQTT y datos para su procesamiento. Para obtener más información, consulte [Interacción con dispositivos IoT locales](interact-with-local-iot-devices.md).

**Topics**
+ [Versiones](#mqtt-broker-moquette-component-versions)
+ [Tipo](#mqtt-broker-moquette-component-type)
+ [Sistema operativo](#mqtt-broker-moquette-component-os-support)
+ [Requisitos](#mqtt-broker-moquette-component-requirements)
+ [Dependencias](#mqtt-broker-moquette-component-dependencies)
+ [Configuración](#mqtt-broker-moquette-component-configuration)
+ [Archivo de registro local](#mqtt-broker-moquette-component-log-file)
+ [Registros de cambios](#mqtt-broker-moquette-component-changelog)

## Versiones
<a name="mqtt-broker-moquette-component-versions"></a>

Este componente tiene las siguientes versiones:
+ 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 es un componente de complemento (`aws.greengrass.plugin`). El [núcleo de Greengrass](greengrass-nucleus-component.md) ejecuta este componente en la misma máquina virtual Java (JVM) que el núcleo. El núcleo se reinicia al cambiar la versión de este componente en el dispositivo principal.

<a name="public-component-type-plugin-para2"></a>Este componente usa el mismo archivo de registro que el núcleo de Greengrass. Para obtener más información, consulte [Supervisión de los registros de AWS IoT Greengrass](monitor-logs.md).

<a name="public-component-type-more-information"></a>Para obtener más información, consulte [Tipos de componentes](develop-greengrass-components.md#component-types).

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

Este componente se puede instalar en los dispositivos principales que ejecutan los siguientes sistemas operativos:
+ Linux
+ Windows

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

Este componente tiene los siguientes requisitos:
+ El dispositivo principal debe poder aceptar conexiones en el puerto en el que opera el agente MQTT. Este componente ejecuta el agente MQTT en el puerto 8883 de forma predeterminada. O puede especificar un puerto diferente al configurar este componente.

  <a name="mqtt-broker-configuration-mqtt-bridge-requirement"></a>Si especifica un puerto diferente y utiliza el [componente de puente MQTT](mqtt-bridge-component.md) para retransmitir mensajes MQTT a otros intermediarios, debe utilizar el puente de MQTT versión 2.1.0 o posterior. Configúrelo para que use el puerto en el que opera el agente MQTT.

  <a name="mqtt-broker-configuration-ip-detector-requirement"></a>Si especifica un puerto diferente y utiliza el [componente IP detector](ip-detector-component.md) para administrar los puntos de conexión del agente MQTT, debe utilizar la versión 2.1.0 o posterior del detector IP. Configúrelo para que informe el puerto en el que opera el agente MQTT.
+ El componente de agente MQTT de Moquette puede ejecutarse en una VPC.

## Dependencias
<a name="mqtt-broker-moquette-component-dependencies"></a>

Al implementar un componente, AWS IoT Greengrass también despliega versiones compatibles de sus dependencias. Esto significa que debe cumplir los requisitos del componente y de todas sus dependencias para poder implementar el componente correctamente. En esta sección, se enumeran las dependencias de las [versiones publicadas](#mqtt-broker-moquette-component-changelog) de este componente y las restricciones de las versiones semánticas que definen las versiones de los componentes para cada dependencia. También puede ver las dependencias de cada versión del componente en la [consola de AWS IoT Greengrass](https://console.aws.amazon.com//greengrass). En la página de detalles del componente, busque la lista de **Dependencias**.

------
#### [ 2.3.7 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.3.7 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Autenticación del dispositivo de cliente](client-device-auth-component.md) | >=2.2.0 <2.6.0 | Rígido | 

------
#### [ 2.3.2 – 2.3.6 ]

En la siguiente tabla, se muestran las dependencias de las versiones 2.3.2 a 2.3.6 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Autenticación del dispositivo de cliente](client-device-auth-component.md) | >=2.2.0 <2.5.0 | Rígido | 

------
#### [ 2.3.0 and 2.3.1 ]

En la siguiente tabla, se muestran las dependencias de las versiones 2.3.0 y 2.3.1 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Autenticación del dispositivo de cliente](client-device-auth-component.md) | >=2.2.0 <2.4.0 | Rígido | 

------
#### [ 2.2.0 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.2.0 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Autenticación del dispositivo de cliente](client-device-auth-component.md) | >=2.2.0 <2.3.0 | Rígido | 

------
#### [ 2.1.0 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.1.0 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Autenticación del dispositivo de cliente](client-device-auth-component.md) | >=2.0.0 <2.2.0 | Rígido | 

------
#### [ 2.0.0 - 2.0.2 ]

En la siguiente tabla, se muestran las dependencias de las versiones 2.0.0 a 2.0.2 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Autenticación del dispositivo de cliente](client-device-auth-component.md) | >=2.0.0 <2.1.0 | Rígido | 

------

Para obtener más información sobre las dependencias del componente, consulte la [referencia de receta de componentes](component-recipe-reference.md#recipe-reference-component-dependencies).

## Configuración
<a name="mqtt-broker-moquette-component-configuration"></a>

Este componente ofrece los siguientes parámetros de configuración que puede personalizar cuando implemente el componente.

`moquette`  
(Opcional) La configuración del [agente MQTT de Moquette](https://github.com/moquette-io/moquette) que se va a utilizar. Puede configurar las opciones de configuración de Moquette en este componente. Para obtener más información, consulte los comentarios en línea en el [archivo de configuración de Moquette](https://github.com/moquette-io/moquette/blob/main/distribution/src/main/resources/moquette.conf).  
Este objeto contiene la siguiente información:    
`ssl_port`  
(Opcional) El puerto en el que opera el agente de MQTT.  
<a name="mqtt-broker-configuration-mqtt-bridge-requirement"></a>Si especifica un puerto diferente y utiliza el [componente de puente MQTT](mqtt-bridge-component.md) para retransmitir mensajes MQTT a otros intermediarios, debe utilizar el puente de MQTT versión 2.1.0 o posterior. Configúrelo para que use el puerto en el que opera el agente MQTT.  
<a name="mqtt-broker-configuration-ip-detector-requirement"></a>Si especifica un puerto diferente y utiliza el [componente IP detector](ip-detector-component.md) para administrar los puntos de conexión del agente MQTT, debe utilizar la versión 2.1.0 o posterior del detector IP. Configúrelo para que informe el puerto en el que opera el agente MQTT.
Valor predeterminado: `8883`  
`host`  
(Opcional) La interfaz a la que se enlaza el agente MQTT. Por ejemplo, puede cambiar este parámetro para que el agente MQTT se vincule únicamente a una red local específica.  
Predeterminado: `0.0.0.0` (enlaza con todas las interfaces de red)

startupTimeoutSeconds  
(Opcional) El tiempo máximo en segundos para que se inicie el componente. El estado del componente cambia a `BROKEN` si supera este tiempo de espera.  
Valor predeterminado: `120`

**Example Ejemplo: actualización de la combinación de configuraciones**  
El siguiente ejemplo de configuración especifica el funcionamiento del agente de MQTT en el puerto 443.  

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

## Archivo de registro local
<a name="mqtt-broker-moquette-component-log-file"></a>

Este componente utiliza el mismo archivo de registro que el componente [núcleo de Greengrass](greengrass-nucleus-component.md).

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

```
/greengrass/v2/logs/greengrass.log
```

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

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

------

**Visualización de los registros de este componente**
+ Ejecute el siguiente comando en el dispositivo de núcleo para ver el archivo de registro de este componente en tiempo real. Sustituya `/greengrass/v2` o *C:\$1greengrass\$1v2* por la ruta a la carpeta AWS IoT Greengrass raíz.

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

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Registros de cambios
<a name="mqtt-broker-moquette-component-changelog"></a>

En la siguiente tabla, se describen los cambios en cada versión del componente.


|  **Versión**  |  **Cambios**  | 
| --- | --- | 
|  2.3.7  |  Versión actualizada para la versión 2.5.0 de [autenticación de dispositivos de cliente](client-device-auth-component.md).  | 
|  2.3.6  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
|  2.3.5  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
|  2.3.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/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/es_es/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
|  2.3.2  |  Versión actualizada para la versión 2.4.0 de [autenticación de dispositivos de cliente](client-device-auth-component.md).  | 
|  2.3.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
|  2.3.0  |  Se agregó compatibilidad con las cadenas de certificados.  | 
|  2.2.0  |  Versión actualizada para la versión 2.2.0 de [autenticación de dispositivos de cliente](client-device-auth-component.md).  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
|  2.0.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
|  2.0.1  |  Versión actualizada para el lanzamiento de la versión 2.4.0 del núcleo de Greengrass.  | 
|  2.0.0  |  Versión inicial.  |