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.

# Introducción: Cómo crear un agente de RabbitMQ y conectarse a él
<a name="getting-started-rabbitmq"></a>

Un *agente* es un entorno de agente de mensajes que se ejecuta en Amazon MQ. Es el componente básico de Amazon MQ. La descripción combinada de la instancia del agente *clase* (`m5`) y *tamaño* (`large`, `medium`) se conoce como *tipo de instancias del agente* (por ejemplo, `mq.m5.large`). Para obtener más información, consulte [¿Qué es un agente de Amazon MQ para RabbitMQ?](working-with-rabbitmq.md#rabbitmq-basic-elements-broker)

## Crear un agente de RabbitMQ
<a name="create-rabbitmq-broker"></a>

La primera tarea, y la más habitual, en Amazon MQ es la creación de un agente. El siguiente ejemplo muestra cómo puede utilizar la Consola de administración de AWS para crear un agente básico.

Al crear un Amazon MQ para un agente de RabbitMQ, siga las [prácticas recomendadas de configuración del agente para RabbitMQ](best-practices-broker-setup.md) a fin de maximizar el rendimiento del agente y optimizar la eficiencia del procesamiento de mensajes.

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

1. En la página **Select broker engine** (Seleccionar motor del agente), elija **RabbitMQ** y, luego, **Next** (Siguiente).

1. En la página **Select deployment mode** (Seleccionar modo de implementación), elija el **modo de implementación**, por ejemplo, **Cluster deployment** (Implementación de clúster) y, luego, elija **Next** (Siguiente). 
   + Un **agente de una sola instancia** está compuesto por un agente en una zona de disponibilidad situada detrás de un Network Load Balancer (NLB). El agente se comunica con su aplicación y con un volumen de almacenamiento de Amazon EBS. Para obtener más información, consulte [Opción 1: Agente de una sola instancia de Amazon MQ para RabbitMQ](rabbitmq-broker-architecture.md#rabbitmq-broker-architecture-single-instance).
   + Una **Implementación de clúster de RabbitMQ para alta disponibilidad** es una agrupación lógica de tres nodos de agente de RabbitMQ situados detrás de un Network Load Balancer, cada uno de los cuales comparte usuarios, colas y un estado distribuido entre varias zonas de disponibilidad (AZ). Para obtener más información, consulte [Opción 2: Implementación de un clúster de Amazon MQ para RabbitMQ](rabbitmq-broker-architecture.md#rabbitmq-broker-architecture-cluster).

1. En la página **Configure settings** (Configurar ajustes), sección **Details** (Detalles), siga estos pasos:

   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.m7g.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 página **Configure settings** (Configurar ajustes), sección **RabbitMQ access** (Acceso a RabbitMQ), proporcione un **nombre de usuario** y una **contraseña**. Las siguientes restricciones se aplican a las credenciales de inicio de sesión de agente:
   +  El nombre de usuario solo puede contener caracteres alfanuméricos, guiones, puntos y guiones bajos (- . \$1). Este valor no debe contener ningún carácter de tilde (\$1). Amazon MQ prohíbe utilizar `guest` como nombre de usuario. 
   +  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.
**nota**  
 En la sección **Additional settings (Configuración adicional)**, también puede configurar lo siguiente:   
 [Configuraciones](rabbitmq-broker-configuration-parameters.md) 
 [Registros de CloudWatch](security-logging-monitoring.md) 
 Acceso privado 
 [Período de mantenimiento del agente](maintaining-brokers.md) 

1. Elija **Siguiente**.

1. En la página **Review and create** (Revisar y crear), puede revisar las opciones que seleccionó y modificarlas si es necesario.

1. Elija **Create broker** (Crear agente).

   Mientras Amazon MQ crea su agente, muestra el estado **Creation in progress** (Creación en curso). 

   El proceso de creación del agente de tarda unos 15 minutos.

   Cuando el agente se crea correctamente, Amazon MQ muestra el estado **Running** (En ejecución).

1. Seleccione ***MyBroker***.

   En la sección **Connect** (Conectar) de la página ***MyBroker***, anote la URL de la **[consola web de RabbitMQ](https://www.rabbitmq.com/management.html)** de su agente, por ejemplo:

   ```
   https://b-c8349341-ec91-4a78-ad9c-a57f23f235bb.mq.us-west-2.on.aws
   ```

   Además, anote el [**punto de enlace** de Secure-AMQP](https://www.rabbitmq.com/connections.html). A continuación se muestra un ejemplo de un punto de enlace `amqps` que expone al puerto de agente de escucha `5671`.

   ```
   amqps://b-c8349341-ec91-4a78-ad9c-a57f23f235bb.mq.us-west-2.on.aws:5671
   ```