As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# 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](amazon-mq-broker-architecture.md#single-broker-deployment) ou [agentes ativos/em espera](amazon-mq-broker-architecture.md#active-standby-broker-deployment). 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 do Amazon MQ](network-of-brokers.md)
+ [Configurar sua rede de agentes corretamente](best-practices-activemq.md#network-of-brokers-configure-correctly)
+ `networkConnector`
+ `networkConnectionStartAssíncrono`
+ [Redes de agentes](http://activemq.apache.org/networks-of-brokers.html) 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.
**Topics**
+ [Pré-requisitos](#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)
## 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 [Conceitos básicos: criar e conectar a um agente do ActiveMQ](getting-started-activemq.md).
+ Os dois corretores devem estar na mesma VPC ou em pares. VPCs Para obter mais informações VPCs, consulte [O que é Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/what-is-amazon-vpc.html)? no *Guia do usuário da Amazon VPC* e o [que é emparelhamento de VPC](https://docs.aws.amazon.com/vpc/latest/peering/Welcome.html)? no Guia de *emparelhamento do 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](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html#create-default-vpc)
[Criar uma sub-rede padrão](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html#create-default-subnet)
[Criar um grupo de segurança](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html#CreatingSecurityGroups)
+ 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 um usuário do agente do ActiveMQ](amazon-mq-listing-managing-users.md).
**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](amazon-mq-broker-architecture.md#single-broker-deployment). No entanto, você pode criar redes de agentes usando os [agentes ativos/em espera](amazon-mq-broker-architecture.md#active-standby-broker-deployment) 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](https://console.aws.amazon.com/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. ![\[Pencil icon indicating an edit or modification action.\]](http://docs.aws.amazon.com/pt_br/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-broker-details-link.png)
A página **Grupos de segurança** do painel do EC2 é exibida.
1. Na lista de security group, escolha seu security group.
1. Na parte inferior da página, escolha **Inbound (Entrada)** e a seguir selecione **Edit (Editar)**.
1. Na caixa de diálogo **Editar regras** de entrada, adicione uma regra para o OpenWire endpoint.
1. Escolha **Add Rule (Adicionar regra)**.
1. Em **Type (Tipo)**, selecione **Custom TCP (TCP personalizado)**.
1. Em **Port Range**, digite a OpenWire porta (`61617`).
1. 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 registro CIDR válido). Para obter mais informações, consulte [Interfaces de rede elástica](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html).
**dica**
Para recuperar o endereço IP do `MyBroker1`, no [console do Amazon MQ](https://console.aws.amazon.com/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.
1. 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**.
1. 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.
1. 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.
1. Escolha **Editar configuração**.
1. Na parte inferior do arquivo de configuração, remova a seção `` e inclua as seguintes informações:
+ O `name` para o conector de rede.
+ [O Console da Web ActiveMQ `username`](#creating-configuring-network-of-brokers-create-brokers) 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:
```
```
+ Se você estiver conectando o broker a um broker ativo/em espera, use o `static+failover` transporte e o OpenWire endpoint `uri` para ambos os corretores com os seguintes parâmetros de consulta. `?randomize=false&maxReconnectAttempts=0` Por exemplo:
```
```
**nota**
Não inclua as credenciais de login para o usuário do ActiveMQ.
1. Escolha **Salvar**.
1. Na caixa de diálogo **Salvar revisão**, digite `Add network of brokers connector for MyBroker2`.
1. Escolha **Salvar** para salvar a nova revisão de configuração.
1. Edite `MyBroker1` para definir a última revisão de configuração para aplicar imediatamente.
1. Na página **MyBroker1**, escolha **Editar**.
1. Na página **Editar MyBroker 1**, na seção **Configuração**, escolha **Programar modificações**.
1. Na seção **Programar modificações do agente**, escolha para aplicar modificações **imediatamente**.
1. Escolha **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 [habilitar conexões de entrada](amazon-mq-working-java-example.md#quick-start-allow-inbound-connections) *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](https://console.aws.amazon.com/amazon-mq/), navegue até a seção **Connections (Conexões)** e anote o endpoint do Console da Web ActiveMQ para o agente `MyBroker1`.
1. Navegue até o Console da Web ActiveMQ para o agente `MyBroker1`.
1. Para verificar se a ponte de rede está conectada, escolha **Rede**.
Na seção **Pontes de rede**, o nome e o endereço de `MyBroker2` são listados nas colunas **Agente remoto** e **Endereço do agente**.
1. 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 fila`MyQueue`.
1. 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 fila`MyQueue`.