Creación y configuración de una red de agentes de Amazon MQ

Una red de agentes está compuesta por varios agentes de una sola instancia activos al mismo tiempo o agentes activos/en espera. Puede configurar redes de intermediarios en una variedad de topologías (por ejemplo, concentrador hub-and-spokes, árbol o malla), según las necesidades de su aplicación, como la alta disponibilidad y la escalabilidad. Por ejemplo, una red de agentes en estrella puede aumentar la resiliencia, ya que preserva los mensajes si no se puede obtener acceso a un agente. Una red de agentes con topología de concentrador puede recopilar mensajes de un mayor número de agentes que aceptan mensajes entrantes y concentrarlos en agentes más centrales para manejar mejor la carga de muchos mensajes entrantes. 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 corredores Amazon MQ

• Configurar la red de agentes correctamente

• networkConnector

• networkConnectionStartAsincrónico

• Redes de agentes 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.

Requisitos previos

Para crear una red de agentes, debe disponer de lo siguiente:

• Dos o más agentes simultáneamente activos (denominadosMyBroker1 y MyBroker2 en este tutorial). Para obtener más información sobre la creación de agentes, consulte Primeros pasos: creación de un bróker ActiveMQ y conexión a él.

• Los dos corredores deben estar en el mismo sitio VPC o en pares. VPCs Para obtener más informaciónVPCs, consulta ¿Qué es AmazonVPC? en la Guía del VPC usuario de Amazon y ¿Qué es el VPC peering? en la Amazon VPC Peering Guide.

  importante

  Si no tiene una subred o un grupo de seguridad predeterminadosVPC, primero debe crearlos. Para obtener más información, consulta lo siguiente en la Guía del VPC usuario de Amazon:

  • Crear un valor predeterminado VPC

  • Creación de una subred predeterminada

  • Creación de un grupo de seguridad

• 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 de ActiveMQ broker.

  nota

  Al integrar la LDAP autenticación con una red de intermediarios, asegúrese de que el usuario existe como agente de ActiveMQ y como usuario. LDAP

En el siguiente ejemplo, se usan dos agentes de una sola instancia. Sin embargo, puede crear redes de agentes utilizandoagentes activos/en espera o una combinación de modos de implementación de agente.

Paso 1: Permitir tráfico entre agentes

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

1. En la consola 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.

   Aparece la página Grupos de seguridad del EC2 panel de control.

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

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

4. 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).

   2. En Tipo, seleccione Personalizado TCP.

   3. En Rango de puertos, escriba el OpenWire puerto (61617).

   4. Realice una de las siguientes acciones siguientes:

      • 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. (Esto convierte la dirección IP en un CIDR registro válido). Para obtener más información, consulte Interfaces de redes elásticas.

        sugerencia

        Para recuperar la dirección IP de MyBroker1, en la consola de Amazon MQ, elija el nombre del agente y vaya a la sección Details (Detalles).

      • Si todos los corredores son privados y pertenecen al mismo grupo, en Source VPC, deje seleccionada la opción Personalizado y, a continuación, escriba el ID del grupo de seguridad que está editando.

        nota

        En el caso de los agentes públicos, debe restringir el acceso mediante direcciones IP.

   5. Seleccione Guardar.

      El agente ahora puede aceptar las conexiones entrantes.

Paso 2: Configurar conectores de red para su agente

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, seleccione Editar.

   2. 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).

   3. En la pestaña Detalles de la configuración, se muestran el número de revisión de la configuración, la descripción y la configuración del broker en XML formato.

   4. Elija Editas configuración.

   5. 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 que es común a ambos agentes.

      • Habilitar conexiones duplex.

      • Realice una de las siguientes acciones siguientes:

        • Si va a conectar el broker a un broker 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-east-2.amazonaws.com:61617)?randomize=false&amp;maxReconnectAttempts=0)"/>
          </networkConnectors>

        nota

        No incluya las credenciales de inicio de sesión del usuario de ActiveMQ.

   6. Seleccione Guardar.

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

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

2. 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.

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

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

   4. Seleccione Apply.

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

   Se crea la red de agentes.

Siguientes pasos

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

importante

Asegúrese de habilitar las conexiones entrantes 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, acceda a la sección Connections (Conexiones) y anote el punto de enlace de la consola web de ActiveMQ para el agente MyBroker1.

2. Vaya a la ActiveMQ Web Console para el agente MyBroker1.

3. 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).

4. 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

5. 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 colaMyQueue.