

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 um agente de replicação de dados do Amazon MQ entre regiões
<a name="create-replica-broker"></a>

 Com a replicação de dados entre regiões (CRDR), você pode alternar entre o Amazon MQ para agentes de mensagens ActiveMQ em duas regiões da AWS, conforme necessário. Você pode designar um agente existente como agente primário e criar uma réplica para esse agente, ou criar um agente primário e um agente de réplica juntos. Depois, é possível promover o agente de réplica à função de agente primário usando a operação `Promote` da API do Amazon MQ. Para ter mais informações sobre agentes primários e de réplica, consulte [Agentes primários e de réplica para replicação de dados entre regiões](crdr-for-active-mq.md#crdr-primary-replica-brokers). 

 As instruções a seguir descrevem como criar e configurar um agente de réplica usando o Console de Gerenciamento do Amazon MQ. 

**Topics**
+ [Pré-requisitos](#create-crdr-broker-prerequisites)
+ [Etapa 1 (opcional): Criar um agente primário](#create-new-primary-broker)
+ [Create a replica of an existing broker](#create-new-replica-broker)

## Pré-requisitos
<a name="create-crdr-broker-prerequisites"></a>

Para usar o recurso de replicação de dados entre regiões, você deve analisar e cumprir os seguintes pré-requisitos:
+  **Versão**: o atributo de replicação de dados entre regiões só está disponível para agentes do Amazon MQ para ActiveMQ nas versões 5.17.6 e posterior. 
+  **Região**: a replicação de dados entre regiões é aceita nas seguintes regiões: Leste dos EUA (Ohio), Leste dos EUA (Norte da Virgínia), Oeste dos EUA (Oregon) e Oeste dos EUA (Norte da Califórnia). 
+  **Tipo de instância**: a replicação de dados entre regiões só está disponível para tamanhos de instância de agente `mq.m5.large` e posterior. 
+  **Tipo de implantação**: a replicação de dados entre regiões só está disponível para agentes ativos/em espera com implantação em várias zonas de disponibilidade. 
+  **Status do agente**: você só pode criar um agente de réplica para um agente primário com o status de agente `Running`. 

## Etapa 1 (opcional): Criar um agente primário
<a name="create-new-primary-broker"></a>

### Criar um agente primário
<a name="create-new-primary-broker-procedure"></a>

1. Faça login no [console do Amazon MQ](https://console.aws.amazon.com/amazon-mq/).

1. Na página Agentes do console do Amazon MQ, escolha **Criar agentes**.

1.  Na página **Select broker engine** (Selecionar mecanismo de agente), selecione **Apache ActiveMQ** (Apache ActiveMQ). 

1.  Na página **Select deployment and storage** (Selecionar implantação e armazenamento), na seção **Deployment mode and storage type** (Modo de implantação e tipo de armazenamento), faça o seguinte: 

   1. Em **Modo de implantação**, escolha **Operador ativo/em espera de alta disponibilidade**. Um **agente ativo/em espera** é composto por dois agentes em duas zonas de disponibilidade diferentes, configuradas em um par redundante. Esses agentes se comunicam de forma síncrona com sua aplicação e com o Amazon EFS. Para obter mais informações, consulte [Opções de implantação de agentes do Amazon MQ para ActiveMQ](amazon-mq-broker-architecture.md). 

1.  Escolha **Próximo**. 

1. Na página **Definir configurações**, faça o seguinte na seção **Detalhes**:

   1. Digite o **Broker name** (Nome do agente).
**Importante**  
 Não inclua informações de identificação pessoal (PII) nem outras informações confidenciais ou sigilosas em nomes de agente. Os nomes de agente são acessíveis a outros serviços de AWS, incluindo o CloudWatch Logs. Nomes de agente não devem ser usados para dados privados ou sigilosos. 

   1. Selecione o **Tipo de instância de agente** (por exemplo, **m5.large**). Para obter mais informações, consulte [Tipos de instância do Amazon MQ para agentes do ActiveMQ](broker-instance-types.md).

1.  Na seção **ActiveMQ Web Console access** (Acesso ao console da Web ActiveMQ), forneça um **Username** (Nome de usuário) e **Password** (Senha). As seguintes restrições se aplicam a nomes de usuário e senhas de agente: 
   +  Seu nome de usuário pode conter somente caracteres alfanuméricos, traços, pontos, sublinhados e tils (- . \_ \~). 
   +  Sua senha deve ter pelo menos 12 caracteres, deve conter pelo menos 4 caracteres exclusivos e não deve conter vírgulas, dois pontos ou sinais de igual (,:=). 
**Importante**  
Não inclua informações de identificação pessoal (PII) nem outras informações confidenciais ou sigilosas em nomes de usuário do agente. Nomes de usuário do agente são acessíveis a outros serviços de AWS, incluindo o CloudWatch Logs. Nomes de usuário do agente não devem ser usados para dados privados ou sigilosos.

A barra verde na parte superior da página confirma que o Amazon MQ está criando o agente de réplica na região de recuperação. Você também pode ver a função da CRDR e o status do RPO de seus agentes. Para desativar as colunas Função da CRDR e Status do RPO, escolha o ícone de engrenagem no canto superior direito da tabela **Agentes**. Depois, na página **Preferências**, desative a Função da CRDR ou o Status do RPO. 

## Etapa 2: Criar uma réplica de um agente existente
<a name="create-new-replica-broker"></a>

1. Na página Agentes do console do Amazon MQ, escolha **Criar agente de réplica**.

1. Na **página Escolher agente primário**, selecione um agente existente para usar como agente primário de CRDR. Em seguida, escolha **Próximo**.

1. Na página **Configurar agente de réplica**, use o menu suspenso para escolher a região da réplica.

1. Na seção **Usuário do console ActiveMQ para agente de réplica**, forneça um **nome de usuário e uma **senha** para o usuário** do console do agente de réplica. As seguintes restrições se aplicam a nomes de usuário e senhas de agente:
   +  Seu nome de usuário pode conter somente caracteres alfanuméricos, traços, pontos, sublinhados e tils (- . \_ \~). 
   +  Sua senha deve ter pelo menos 12 caracteres, deve conter pelo menos 4 caracteres exclusivos e não deve conter vírgulas, dois pontos ou sinais de igual (,:=). 
**Importante**  
Não inclua informações de identificação pessoal (PII) nem outras informações confidenciais ou sigilosas em nomes de usuário do agente. Nomes de usuário do agente são acessíveis a outros serviços de AWS, incluindo o CloudWatch Logs. Nomes de usuário do agente não devem ser usados para dados privados ou sigilosos.

1. Na seção **Usuário de replicação de dados para conectar o acesso entre agentes**, forneça um **nome de usuário** e uma **senha** para o usuário que acessará o agente primário e o agente de réplica. As seguintes restrições se aplicam a nomes de usuário e senhas de agente:
   +  Seu nome de usuário pode conter somente caracteres alfanuméricos, traços, pontos, sublinhados e tils (- . \_ \~). 
   +  Sua senha deve ter pelo menos 12 caracteres, deve conter pelo menos 4 caracteres exclusivos e não deve conter vírgulas, dois pontos ou sinais de igual (,:=). 
**Importante**  
Não inclua informações de identificação pessoal (PII) nem outras informações confidenciais ou sigilosas em nomes de usuário do agente. Nomes de usuário do agente são acessíveis a outros serviços de AWS, incluindo o CloudWatch Logs. Nomes de usuário do agente não devem ser usados para dados privados ou sigilosos.

   Defina todas as configurações adicionais. Em seguida, escolha **Próximo**.

1. Na página **Analisar e criar**, revise os detalhes do agente de réplica. Depois, escolha **Criar operador de réplica**.

1.  Depois, reinicialize o agente primário. Isso também reinicializará o agente de réplica. Para ter instruções sobre como reiniciar seu agente, consulte [Reinicializar um agente do Amazon MQ](amazon-mq-rebooting-broker.md). 

Para ter mais informações sobre como definir configurações adicionais para seu agente do ActiveMQ, consulte [Conceitos básicos: criar e conectar a um agente do ActiveMQ](getting-started-activemq.md).