

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Creación de un agente de replicación de datos entre regiones de Amazon MQ
<a name="create-replica-broker"></a>

 Con la replicación de datos entre regiones (CRDR), puede alternar entre agentes de mensajes de Amazon MQ para ActiveMQ en dos regiones de AWS según sea necesario. Puede designar un agente existente como agente principal y crear una réplica para este agente o crear un nuevo agente principal y de réplicas juntos. A continuación, puede ascender el agente de réplicas al rol de agente principal mediante la operación de la API `Promote` de Amazon MQ. Para obtener más información sobre los agentes principales y de réplicas, consulte [Agentes principales y de réplicas para la replicación de datos entre regiones](crdr-for-active-mq.md#crdr-primary-replica-brokers). 

 Las siguientes instrucciones describen cómo puede crear y configurar un agente de réplicas mediante la consola de administración de Amazon MQ. 

**Topics**
+ [Requisitos previos](#create-crdr-broker-prerequisites)
+ [Paso 1 (opcional): Crear un nuevo agente principal](#create-new-primary-broker)
+ [Create a replica of an existing broker](#create-new-replica-broker)

## Requisitos previos
<a name="create-crdr-broker-prerequisites"></a>

Para utilizar la característica de replicación de datos entre regiones, debe revisar y cumplir los siguientes requisitos previos:
+  **Versión**: la característica de replicación de datos entre regiones solo está disponible para agentes de Amazon MQ en la versión 5.17.6 y versiones más recientes. 
+  **Región**: la replicación de datos entre regiones se admite en las siguientes regiones: Este de EE. UU. (Ohio), Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón) y Oeste de EE. UU. (Norte de California). 
+  **Tipo de instancia**: la replicación de datos entre regiones solo está disponible para instancias de agente de tamaño `mq.m5.large` y superiores. 
+  **Tipo de implementación**: la replicación de datos entre regiones solo está disponible para agentes activos o en espera con implementación en zonas de disponibilidad múltiple. 
+  **Estado de agente**: solo puede crear un agente de réplicas para un agente principal con el estado de agente `Running`. 

## Paso 1 (opcional): Crear un nuevo agente principal
<a name="create-new-primary-broker"></a>

### Crear un nuevo agente principal
<a name="create-new-primary-broker-procedure"></a>

1. Inicie sesión en la [consola de Amazon MQ](https://console.aws.amazon.com/amazon-mq/).

1. En la página de agentes de la consola de Amazon MQ, elija **Crear agentes**.

1.  En la página **Select broker engine** (Seleccionar motor de agente), elija **Apache ActiveMQ**. 

1.  En la página **Select deployment and storage** (Seleccionar implementación y almacenamiento), sección **Deployment mode and storage type** (Modo de implementación y tipo de almacenamiento), haga lo siguiente: 

   1. En **Modo de implementación**, elija **Agente activo/en espera**. Un **Agente activo/en espera** se compone de dos agentes en dos zonas de disponibilidad diferentes configurados en un par redundante. Estos agentes se comunican de forma sincrónica con su aplicación y con Amazon EFS. Para obtener más información, consulte [Opciones de implementación de Amazon MQ para agentes de ActiveMQ](amazon-mq-broker-architecture.md). 

1.  Elija **Siguiente**. 

1. En la página **Configure settings** (Configurar ajustes), sección **Details** (Detalles), haga lo siguiente:

   1. Ingrese el **nombre del agente**.
**importante**  
 No agregue información de identificación personal (PII) ni ninguna otra información confidencial en los nombres de agente. Los nombres de agente y los nombres de usuario están disponibles para otros servicios de AWS, incluido CloudWatch Logs. Los nombres de agente no están diseñados para usarse con información privada o confidencial. 

   1. Elija el **tipo de instancias del agente** (por ejemplo, **mq.m5.large**). Para obtener más información, consulte [Amazon MQ para tipos de instancia de agentes de ActiveMQ](broker-instance-types.md).

1.  En la sección de acceso a la **consola web de ActiveMQ**, introduzca un **nombre de usuario** y una **contraseña**. Las siguientes restricciones se aplican a los nombres de usuario y las contraseñas de los agentes: 
   +  El nombre de usuario solo puede contener caracteres alfanuméricos, guiones, puntos, guiones bajos y tildes (- . \_ \~). 
   +  Esta contraseña debe tener 12 caracteres como mínimo, debe contener al menos 4 caracteres únicos y no puede incluir comas, dos puntos ni signos de igual (,:=). 
**importante**  
No agregue información de identificación personal (PII) ni ninguna otra información confidencial en los nombres de usuario de agente. Los nombres de usuario de agente están disponibles para otros servicios de AWS, incluido CloudWatch Logs. Los nombres de usuario de agente no están diseñados para usarse con información privada o confidencial.

La barra verde parpadeante en la parte superior de la página confirma que Amazon MQ está creando el agente de réplicas en la región de recuperación. También puede ver el rol de CRDR y el estado de RPO de sus agentes. Para desactivar las columnas Rol de CRDR y Estado de OPR, elija el icono de engranaje de la esquina superior derecha de la tabla **Agentes**. A continuación, en la página **Preferencias**, desactive Rol CRDR o Estado de RPO. 

## Paso 2: Crear una réplica de un agente existente
<a name="create-new-replica-broker"></a>

1. En la página Agentes de la consola de Amazon MQ, elija **Crear agente de réplicas**.

1. En la página **Elegir agente principal**, elija un agente existente para utilizarlo como agente principal de CRDR. A continuación, elija **Siguiente**.

1. En la página **Configurar agente de réplicas**, use el menú desplegable para elegir la región de réplicas.

1. En la sección **Usuario de la consola de ActiveMQ** para el agente de réplicas, proporcione un **Nombre de usuario** y una **Contraseña** para el usuario de la consola del agente de réplicas. Las siguientes restricciones se aplican a los nombres de usuario y las contraseñas de los agentes:
   +  El nombre de usuario solo puede contener caracteres alfanuméricos, guiones, puntos, guiones bajos y tildes (- . \_ \~). 
   +  Esta contraseña debe tener 12 caracteres como mínimo, debe contener al menos 4 caracteres únicos y no puede incluir comas, dos puntos ni signos de igual (,:=). 
**importante**  
No agregue información de identificación personal (PII) ni ninguna otra información confidencial en los nombres de usuario de agente. Los nombres de usuario de agente están disponibles para otros servicios de AWS, incluido CloudWatch Logs. Los nombres de usuario de agente no están diseñados para usarse con información privada o confidencial.

1. En la sección **Usuario de replicación de datos para puente de acceso entre agentes**, proporcione un **Nombre de usuario** y una **Contraseña** para el usuario que accederá tanto al agente principal como al agente de réplicas. Las siguientes restricciones se aplican a los nombres de usuario y las contraseñas de los agentes:
   +  El nombre de usuario solo puede contener caracteres alfanuméricos, guiones, puntos, guiones bajos y tildes (- . \_ \~). 
   +  Esta contraseña debe tener 12 caracteres como mínimo, debe contener al menos 4 caracteres únicos y no puede incluir comas, dos puntos ni signos de igual (,:=). 
**importante**  
No agregue información de identificación personal (PII) ni ninguna otra información confidencial en los nombres de usuario de agente. Los nombres de usuario de agente están disponibles para otros servicios de AWS, incluido CloudWatch Logs. Los nombres de usuario de agente no están diseñados para usarse con información privada o confidencial.

   Configure los ajustes adicionales. A continuación, elija **Siguiente**.

1. En la página **Revisar y crear**, revise los detalles del agente de réplicas. A continuación, elija **Crear agente de réplicas**.

1.  A continuación, reinicie el agente principal. Esto también reiniciará el agente de réplicas. Para obtener instrucciones sobre cómo reiniciar su agente, consulte [Reiniciar un agente de Amazon MQ](amazon-mq-rebooting-broker.md). 

Para obtener más información sobre la configuración de ajustes adicionales para su agente de ActiveMQ, consulte [Introducción: Creación y conexión con un agente de ActiveMQ](getting-started-activemq.md)