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. Você pode configurar redes de corretores em uma variedade de topologias (por exemplo, concentrador hub-and-spokes, árvore ou malha), dependendo das necessidades do seu aplicativo, 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 corretores Amazon MQ

• Configurar sua rede de agentes corretamente

• networkConnector

• networkConnectionStartAssíncrono

• 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 Começando: Criando e conectando-se a um corretor ActiveMQ.

• Os dois corretores devem estar no mesmo lugar VPC ou em paresVPCs. Para obter mais informações sobreVPCs, consulte O que é a AmazonVPC? no Guia do VPC usuário da Amazon e o que é VPC peering? no Amazon VPC Peering Guide.

  Importante

  Se você não tiver um padrãoVPC, uma sub-rede ou um grupo de segurança, deverá criá-los primeiro. Para obter mais informações, consulte o seguinte no Guia do VPC usuário da Amazon:

  • Criando um padrão VPC

  • 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 Criando um usuário do ActiveMQ broker.

  nota

  Ao integrar a LDAP autenticação com uma rede de corretores, certifique-se de que o usuário exista tanto como corretor ActiveMQ quanto como 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, na seção Detalhes, em Segurança e rede, escolha o nome do seu grupo de segurança ou.

   A página Grupos de Segurança do EC2 Painel é 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álogo Editar regras de entrada, adicione uma regra para o OpenWire endpoint.

   1. Escolha Add Rule.

   2. Em Tipo, selecione Personalizado TCP.

   3. Em Port Range, digite a OpenWire porta (61617).

   4. Execute um destes 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 CIDR registro 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 corretores forem privados e pertencerem aos mesmosVPC, em Source, deixe Personalizado selecionado e digite 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 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, escolha Editar.

   2. Na página Editar MyBroker 1, 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, o número da revisão da configuração, a descrição e a configuração do broker em XML formato são exibidos.

   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.

      • Execute um destes procedimentos:

        • Se você estiver conectando o broker a um broker de instância única, use o static: prefixo e o OpenWire endpoint uri 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 a corretora a uma corretora ativa/em espera, use o static+failover transporte e o OpenWire endpoint uri para ambas as corretoras com os seguintes parâmetros de consulta. ?randomize=false&maxReconnectAttempts=0 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 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, escolha Editar.

   2. Na página Editar MyBroker 1, na seção Configuração, escolha Programar modificações.

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

   4. Selecione Apply (Aplicar).

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

   A rede de agentes é criada.

Próximos Passos

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

Importante

Certifique-se de habilitar conexões de entrada de sua máquina local para o broker MyBroker1 na porta 8162 (para o ActiveMQ Web Console) e na porta 61617 (para o endpoint). 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 OpenWire endpoint MyBroker2 e começa a consumir mensagens da filaMyQueue.

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 produtor se conecta ao OpenWire endpoint MyBroker1 e começa a produzir mensagens persistentes na filaMyQueue.