

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.

# Creación y configuración de una red de agentes de Amazon MQ
<a name="amazon-mq-creating-configuring-network-of-brokers"></a>

Una *red de agentes* está compuesta por varios [agentes de una sola instancia](amazon-mq-broker-architecture.md#single-broker-deployment) activos al mismo tiempo o [agentes activos/en espera](amazon-mq-broker-architecture.md#active-standby-broker-deployment). En este tutorial, obtendrá información acerca de cómo crear una red de dos agentes con una topología de *origen y receptor*. 

Para obtener información general de conceptos e información detallada de la configuración, consulte los siguientes temas:
+ [Red de agentes de Amazon MQ](network-of-brokers.md)
+ [Configurar la red de agentes correctamente](best-practices-activemq.md#network-of-brokers-configure-correctly)
+ `networkConnector`
+ `networkConnectionStartAsincrónico`
+ [Redes de agentes](http://activemq.apache.org/networks-of-brokers.html) en la documentación de ActiveMQ

Puede utilizar la consola de Amazon MQ para crear una red de agentes de Amazon MQ. Dado que puede comenzar la creación de los dos agentes en paralelo, este proceso tarda unos 15 minutos. 

**Topics**
+ [Requisitos previos](#creating-configuring-network-of-brokers-create-brokers)
+ [Configure the Brokers in a Network](#creating-configuring-network-of-brokers-allow-traffic)
+ [Configure Network Connectors for Your Broker](#creating-configuring-network-of-brokers-configure-network-connectors)
+ [Next Steps: Test the Network of Brokers](#creating-configuring-network-of-brokers-test)

## Requisitos previos
<a name="creating-configuring-network-of-brokers-create-brokers"></a>

Para crear una red de agentes, debe disponer de lo siguiente:
+ Dos o más agentes simultáneamente activos (denominados`MyBroker1` y `MyBroker2` en este tutorial). Para obtener más información sobre la creación de agentes, consulte [Introducción: Creación y conexión con un agente de ActiveMQ](getting-started-activemq.md).
+ Los dos corredores deben estar en el mismo VPC o en pares. VPCs Para obtener más información VPCs, consulte [¿Qué es Amazon VPC?](https://docs.aws.amazon.com/vpc/latest/userguide/what-is-amazon-vpc.html) en la *Guía del usuario de Amazon VPC* y [¿Qué es la interconexión de VPC?](https://docs.aws.amazon.com/vpc/latest/peering/Welcome.html) en la Guía de *peering de Amazon VPC*.
**importante**  
Si no dispone de una VPC predeterminada, subredes o un grupo de seguridad, debe crearlos en primer lugar. Para obtener más información, consulte los siguientes temas en la *Guía del usuario de Amazon VPC*.  
[Creación de una VPC predeterminada](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html#create-default-vpc)
[Creación de una subred predeterminada](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html#create-default-subnet)
[Creación de un grupo de seguridad](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html#CreatingSecurityGroups)
+ Dos usuarios con credenciales de inicio de sesión idénticas para ambos agentes. Para obtener más información sobre la creación de usuarios, consulte [Creación de un usuario del agente de ActiveMQ](amazon-mq-listing-managing-users.md). 
**nota**  
Cuando integre la autenticación LDAP con una red de agentes, asegúrese de que el usuario exista como agente de ActiveMQ y como usuario de LDAP.

En el siguiente ejemplo, se usan dos [agentes de una sola instancia](amazon-mq-broker-architecture.md#single-broker-deployment). Sin embargo, puede crear redes de agentes utilizando[agentes activos/en espera](amazon-mq-broker-architecture.md#active-standby-broker-deployment) o una combinación de modos de implementación de agente.

## Paso 1: Permitir tráfico entre agentes
<a name="creating-configuring-network-of-brokers-allow-traffic"></a>

Una vez que haya creado los agentes, debe permitir el tráfico entre ellos.

1. En la [consola Amazon MQ](https://console.aws.amazon.com/amazon-mq/), en la página **MyBroker2**, en la sección **Detalles**, en **Seguridad y red**, elija el nombre de su grupo de seguridad o. ![\[Pencil icon indicating an edit or modification action.\]](http://docs.aws.amazon.com/es_es/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-broker-details-link.png)

   Aparecerá la página **Security Groups** (Grupos de seguridad) del panel de EC2.

1. En la lista de grupos de seguridad, elija el grupo de seguridad.

1. En la parte inferior de la página, elija **Inbound (Entrante)** y, a continuación, **Edit (Editar)**.

1. En el cuadro de diálogo **Editar reglas de entrada**, añada una regla para el OpenWire punto final.

   1. Seleccione **Add Rule (Agregar regla)**.

   1. En **Type (Tipo)**, seleccione **Custom TCP (TCP personalizada)**.

   1. En **Rango de puertos**, escriba el OpenWire puerto (`61617`).

   1. Realice una de las siguientes acciones:
      + Si desea restringir el acceso a una determinada dirección IP, en **Source (Origen)**, deje la opción **Custom (Personalizado)** seleccionada y escriba la dirección IP de `MyBroker1`, seguida de `/32`. (Este convierte la dirección IP en un registro de CIDR válido). Para obtener más información, consulte [Interfaces de redes elásticas](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html).
**sugerencia**  
Para recuperar la dirección IP de `MyBroker1`, en la [consola de Amazon MQ](https://console.aws.amazon.com/amazon-mq/), elija el nombre del agente y vaya a la sección **Details** (Detalles).
      + Si todos los agentes son privados y pertenecen a la misma VPC, en **Source (Origen)**, deje la opción **Custom (Personalizado)** seleccionada y escriba el identificador del grupo de seguridad que está editando.
**nota**  
En el caso de los agentes públicos, debe restringir el acceso mediante direcciones IP.

   1. Seleccione **Save**.

      El agente ahora puede aceptar las conexiones entrantes.

## Paso 2: Configurar conectores de red para su agente
<a name="creating-configuring-network-of-brokers-configure-network-connectors"></a>

Después de permitir el tráfico entre sus agentes, debe configurar conectores de red para uno de ellos.

1. Edite la revisión de configuración para el agente `MyBroker1`.

   1. En la página **MyBroker1**, selecciona **Editar**.

   1. En la página **Editar MyBroker 1**, en la sección **Configuración**, elija **Ver**.

      Se muestran el tipo y la versión del motor de agente que utiliza la configuración (por ejemplo, **Apache ActiveMQ 5.15.0**).

   1. En la pestaña **Configuration details**, se muestra el número de revisión de la configuración, la descripción y la configuración del agente en formato XML.

   1. Elija **Editas configuración**.

   1. En la parte inferior del archivo de configuración, anule el comentario de la sección `<networkConnectors>` e incluya la información siguiente:
      + El `name` del conector de red.
      + [La ActiveMQ Web Console `username`](#creating-configuring-network-of-brokers-create-brokers) que es común a ambos agentes.
      + Habilitar conexiones `duplex`.
      + Realice una de las siguientes acciones:
        + Si va a conectar el bróker a un bróker de instancia única, utilice el `static:` prefijo y el OpenWire punto final `uri` de. `MyBroker2` Por ejemplo:

          ```
          <networkConnectors>
            <networkConnector name="connector_1_to_2" userName="myCommonUser" duplex="true"
              uri="static:(ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617)"/>
          </networkConnectors>
          ```
        + Si va a conectar el bróker a un bróker activo/en espera, utilice el `static+failover` transporte y el OpenWire punto final `uri` para ambos agentes con los siguientes parámetros de consulta. `?randomize=false&maxReconnectAttempts=0` Por ejemplo:

          ```
          <networkConnectors>
            <networkConnector name="connector_1_to_2" userName="myCommonUser" duplex="true"
              uri="static:(failover:(ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617,
              ssl://b-9876l5k4-32ji-109h-8gfe-7d65c4b132a1-2.mq.us-west-2.amazonaws.com:61617)?randomize=false&amp;maxReconnectAttempts=0)"/>
          </networkConnectors>
          ```
**nota**  
No incluya las credenciales de inicio de sesión del usuario de ActiveMQ.

   1. Seleccione **Save**.

   1. En el cuadro de diálogo **Save revision (Guardar revisión)**, escriba `Add network of brokers connector for MyBroker2`.

   1. Seleccione **Save (Guardar)** para guardar la nueva revisión de la configuración.

1. Edite `MyBroker1` para establecer la revisión de configuración más reciente para aplicarla de forma inmediata.

   1. **En la página **MyBroker1**, seleccione Editar.**

   1. En la página **Editar MyBroker 1**, en la sección **Configuración**, seleccione **Programar modificaciones**.

   1. En la sección **Schedule broker modifications (Programar modificaciones de agente)**, seleccione aplicar las modificaciones **Immediately (Inmediatamente)**.

   1. Seleccione **Aplicar**.

      `MyBroker1` se reinicia y se aplica su revisión de configuración.

   Se crea la red de agentes.

## Siguientes pasos
<a name="creating-configuring-network-of-brokers-test"></a>

Después de configurar su red de agentes, puede probarla produciendo y consumiendo mensajes.

**importante**  
Asegúrese de [habilitar las conexiones entrantes](amazon-mq-working-java-example.md#quick-start-allow-inbound-connections) *desde su máquina local* para el agente `MyBroker1` en el puerto 8162 (para la consola web ActiveMQ) y en el puerto 61617 (para el punto final). OpenWire  
Es posible que también tenga que ajustar la configuración de los grupos de seguridad para permitir que el productor y el consumidor se conecten a la red de agentes.

1. En la [consola de Amazon MQ](https://console.aws.amazon.com/amazon-mq/), acceda a la sección **Connections** (Conexiones) y anote el punto de enlace de la consola web de ActiveMQ para el agente `MyBroker1`.

1. Vaya a la ActiveMQ Web Console para el agente `MyBroker1`.

1. Para verificar que el puente de red está conectado, seleccione **Network (Red)**.

   En la sección **Network Bridges** (Puentes de red), el nombre y la dirección de `MyBroker2` se indican en las columnas **Remote Broker** (Agente remoto) y **Remote Address** (Dirección remota).

1. Desde cualquier equipo que tenga acceso al agente `MyBroker2`, cree un consumidor. Por ejemplo:

   ```
   activemq consumer --brokerUrl "ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617" \
   	--user commonUser \
   	--password myPassword456 \
   	--destination queue://MyQueue
   ```

   El consumidor se conecta al OpenWire punto final de la cola `MyBroker2` y comienza a consumir los mensajes de la cola. `MyQueue`

1. Desde cualquier equipo que tenga acceso al agente `MyBroker1`, cree un productor y envíe algunos mensajes. Por ejemplo:

   ```
   activemq producer --brokerUrl "ssl://b-9876l5k4-32ji-109h-8gfe-7d65c4b132a1-1.mq.us-east-2.amazonaws.com:61617" \
   	--user commonUser \
   	--password myPassword456 \
   	--destination queue://MyQueue \
   	--persistent true \
   	--messageSize 1000 \
   	--messageCount 10000
   ```

   El productor se conecta al OpenWire punto final de `MyBroker1` y comienza a producir mensajes persistentes para ponerlos en cola`MyQueue`.