Criar e configurar uma rede de agentes Amazon MQ.

A rede de agentes é composta por vários agentes ativos simultaneamente, agentes de instância única ou agentes ativos/em espera. É possível configurar redes de agentes em uma variedade de topologias (por exemplo, concentrator, hub-and-spokes, tree, ou mesh), dependendo das necessidades da sua aplicação, como alta disponibilidade e escalabilidade. Por exemplo, uma rede hub-and-spokes (hub-e-raios) de agentes pode aumentar a resiliência, preservando mensagens se um agente não estiver acessível. Uma rede de agentes com uma topologia de concentrador pode coletar mensagens de um número maior de agentes que aceitam mensagens recebidas, e concentrá-las em agentes mais centrais, para lidar melhor com a carga de muitas mensagens recebidas. Neste tutorial, você aprende a criar uma rede de agentes de dois agentes com uma topologia de origem e de destino.

Para obter uma visão geral conceitual e informações detalhadas de configuração, consulte o seguinte:

• Rede de agentes Amazon MQ

• Configurar sua rede de agentes corretamente

• networkConnector

• networkConnectionStartAsync

• Redes de agentes na documentação do ActiveMQ

Você pode usar o console do Amazon MQ para criar uma rede de agentes do Amazon MQ. Como você pode iniciar a criação dos dois agentes em paralelo, esse processo leva cerca de 15 minutos.

Pré-requisitos

Para criar uma rede de agentes, você deve ter o seguinte:

• Dois ou mais agentes simultaneamente ativos (chamado MyBroker1 e MyBroker2 neste tutorial). Para obter mais informações sobre como criar agentes, consulte Creating and configuring a broker.

• Os dois agentes devem estar na mesma VPC ou em VPCs emparelhadas. Para obter mais informações sobre VPCs, consulte O que é Amazon VPC? no Manual do Usuário do Amazon VPC e O que é emparelhamento da VPC? no Guia de peering da Amazon VPC.

  Importante

  Se você não tem uma VPC padrão, uma sub-rede ou grupo de segurança, você deve criá-los primeiro. Para obter mais informações, consulte um dos tópicos a seguir no Manual do usuário da Amazon VPC.

  • Criar uma VPC padrão

  • Criar uma sub-rede padrão

  • Criar um grupo de segurança

• Dois usuários com credenciais de login idênticas para ambos os agentes. Para obter mais informações sobre como criar usuários, consulte Criar e gerenciar usuários de agente do ActiveMQ.

  nota

  Ao integrar a autenticação LDAP com uma rede de agentes, certifique-se de que o usuário existe tanto como um agente ActiveMQ como um usuário LDAP.

O exemplo a seguir usa dois agentes de instância única. No entanto, você pode criar redes de agentes usando os agentes ativos/em espera ou uma combinação de modos de implantação de agente.

Etapa 1: Permitir tráfego entre agentes

Depois de criar seus agentes, é necessário permitir o tráfego entre eles.

1. No console do Amazon MQ, na página MyBroker2 (MeuAgente2), na seção Details (Detalhes), em Security and network (Segurança e rede), escolha o nome dos grupos de segurança ou .

   A página Grupos de segurança do painel do EC2 é exibida.

2. Na lista de security group, escolha seu security group.

3. Na parte inferior da página, escolha Inbound (Entrada) e a seguir selecione Edit (Editar).

4. Na caixa de diálogoEditar regras de entrada, adicione uma regra para o endpoint do OpenWire.

   1. Escolha Add Rule (Adicionar regra).

   2. Em Type (Tipo), selecione Custom TCP (TCP personalizado).

   3. Para Intervalo de portas, insira a porta do OpenWire (61617).

   4. Faça um dos seguintes procedimentos:

      • Se você deseja restringir o acesso a determinado endereço IP, em Source (Origem), deixe a opção Custom (Personalizar) selecionada e insira o endereço IP de MyBroker1, seguido por /32. (Isso converte o endereço IP em um registro CIDR válido). Para obter mais informações, consulte Interfaces de rede elástica.

        dica

        Para recuperar o endereço IP do MyBroker1, no console do Amazon MQ, escolha o nome do agente e navegue até a seção Detalhes.

      • Se todos os agentes são privados e pertencem à mesma VPC, em Source (Origem), deixe a opção Custom (Personalizar) selecionada e insira o ID do grupo de segurança que você está editando.

        nota

        Para agentes públicos, é necessário restringir o acesso usando endereços IP.

   5. Escolha Save (Salvar).

      Agora seu agente pode aceitar conexões de entrada.

Etapa 2: Configurar os conectores de rede para o seu agente

Depois de permitir o tráfego entre os agentes, você deve configurar os conectores de rede para um deles.

1. Edite a revisão da configuração para o agente MyBroker1.

   1. Na página MyBroker1, selecioneEditar.

   2. Na página Edit MyBroker1, na seção Configuração, escolha Exibir.

      O tipo e a versão do mecanismo de agente que a configuração usa (por exemplo, Apache ActiveMQ 5.15.0) são exibidos.

   3. Na guia Detalhes da configuração, são exibidos o número de revisão da configuração, a descrição e a configuração do agente no formato XML.

   4. Escolha Editar configuração.

   5. Na parte inferior do arquivo de configuração, remova a seção <networkConnectors> e inclua as seguintes informações:

      • O name para o conector de rede.

      • O Console da Web ActiveMQ username que é comum para ambos os agentes.

      • Ativa as conexões duplex.

      • Faça um dos seguintes procedimentos:

        • Se você estiver conectando o agente a um agente de instância única, use o prefixo static: e a uri de endpoint do OpenWire para MyBroker2. Por exemplo:

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

        • Se você estiver conectando o agente a um agente ativo/em espera, use o prefixo static+failover e o uri de endpoint do OpenWire para os dois agentes com os parâmetros de consulta ?randomize=false&maxReconnectAttempts=0 a seguir. Por exemplo:

          <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

        Não inclua as credenciais de login para o usuário do ActiveMQ.

   6. Escolha Save (Salvar).

   7. Na caixa de diálogo Salvar revisão, digite Add network of brokers connector for MyBroker2.

   8. Escolha Salvar para salvar a nova revisão de configuração.

2. Edite MyBroker1 para definir a última revisão de configuração para aplicar imediatamente.

   1. Na página MyBroker1, selecioneEditar.

   2. Na página Editar MyBroker1, na seção Configuração, escolha Modificações programadas.

   3. Na seção Programar modificações do agente, escolha para aplicar modificações imediatamente.

   4. Escolha Apply (Aplicar).

      MyBroker1 é reinicializado e sua revisão de configuração será aplicada.

   A rede de agentes é criada.

Próximas etapas

Depois de configurar a rede de agentes, você pode testá-la ao produzir e consumir mensagens.

Importante

Certifique-se de ativar as conexões de entrada da sua máquina local para o agente MyBroker1 na porta 8162 (para o Console da Web ActiveMQ) e a porta 61617 (para o endpoint do OpenWire).

Também será necessário ajustar as configurações do grupo de segurança para permitir que o produtor e o consumidor se conectem à rede de agentes.

1. No console do Amazon MQ, navegue até a seção Connections (Conexões) e anote o endpoint do Console da Web ActiveMQ para o agente MyBroker1.

2. Navegue até o Console da Web ActiveMQ para o agente MyBroker1.

3. Para verificar se a ponte de rede está conectada, escolha Rede.

   Na seção Network Bridges, o nome e o endereço de MyBroker2 são listados nas colunas Remote Broker e Remote Address.

4. Em qualquer máquina que tem acesso ao agente do MyBroker2, crie um consumidor. Por exemplo:

   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

   O consumidor se conecta ao endpoint do OpenWire do MyBroker2 e começa a consumir mensagens da fila do MyQueue.

5. Em qualquer máquina que tem acesso ao agente do MyBroker1, crie um produtor e envie algumas mensagens. Por exemplo:

   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

   O produto se conecta ao endpoint do OpenWire do MyBroker1 e começa a c produzir mensagens persistentes para o a fila do MyQueue.