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á.
# Conceitos básicos: criar e conectar a um agente do RabbitMQ
Um *agente* é um ambiente de agente de mensagens em execução no Amazon MQ. É o bloco de criação básico do Amazon MQ. A descrição combinada da *classe* (`m5`) e do tamanho (`large`, `medium`) da instância do agente é um tipo de instância de agente (por exemplo,`mq.m5.large`). Para obter mais informações, consulte . [O que é um agente do Amazon MQ para RabbitMQ?](working-with-rabbitmq.md#rabbitmq-basic-elements-broker)
## Criar um agente do RabbitMQ
A tarefa inicial e mais comum do Amazon MQ é a criação de um agente. O exemplo a seguir mostra como é possível usar o Console de gerenciamento da AWS para criar um agente básico.
Quando criar um agente do Amazon MQ para RabbitMQ, siga as [práticas recomendadas de configuração do agente para RabbitMQ](best-practices-broker-setup.md) para maximizar o desempenho do agente e otimizar a eficiência do throughput de mensagens.
1. Faça login no [console do Amazon MQ](https://console.aws.amazon.com/amazon-mq/).
1. Na página **Select broker engine** (Selecionar mecanismo do agente), selecione **RabbitMQ** e, em seguida, selecione **Next** (Avançar).
1. Na página **Select deployment mode (Selecionar modo de implementação)**, escolha o **Deployment mode (Modo de implantação)**, por exemplo, **Cluster deployment (Implantação de cluster)** e, depois, escolha **Next (Avançar)**.
+ Um ** Network Load Balancer (NLB)** é composto por um agente em uma zona de disponibilidade atrás de um Network Load Balancer (NLB). O agente se comunica com sua aplicação e com um volume de armazenamento do Amazon EBS. Para obter mais informações, consulte [Opção 1: agente de instância única do Amazon MQ para RabbitMQ](rabbitmq-broker-architecture.md#rabbitmq-broker-architecture-single-instance).
+ A **implantação de cluster RabbitMQ para alta disponibilidade** é um agrupamento lógico de três nós do agente RabbitMQ atrás de um Network Load Balancer (NLB), cada um compartilhando usuários, filas e um estado distribuído em várias Zonas de Disponibilidade (AZ). Para obter mais informações, consulte [Opção 2: implantação do cluster do Amazon MQ para RabbitMQ](rabbitmq-broker-architecture.md#rabbitmq-broker-architecture-cluster).
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, **mq.m7g.large**). Para obter mais informações, consulte [Tipos de instância do Amazon MQ para agentes do ActiveMQ](broker-instance-types.md).
1. Na página **Configure settings (Definição de configurações)**, na seção **RabbitMQ access (Acesso RabbitMQ)**, forneça um **Username (Nome de usuário)** e **Password (Senha)**. As seguintes restrições se aplicam a credenciais de login do agente:
+ Seu nome de usuário pode conter somente caracteres alfanuméricos, traços, pontos e sublinhados (- . \$1). Este valor não deve conter quaisquer caracteres de til (\$1). O Amazon MQ proíbe o uso de `guest` como um nome de usuário.
+ 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.
**nota**
Na seção **Configurações adicionais**, você também pode configurar o seguinte:
[Configurações](rabbitmq-broker-configuration-parameters.md)
[CloudWatch Logs](security-logging-monitoring.md)
Acesso privado
[Janela de manutenção de agente](maintaining-brokers.md)
1. Escolha **Próximo**.
1. Na página **Review and create (Revisar e criar)**, você pode revisar suas seleções e editá-las conforme necessário.
1. Escolha **Criar agente**.
Enquanto o Amazon MQ cria seu agente, ele exibe o status **Criação em andamento**.
A criação do agente leva cerca de 15 minutos.
Quando o seu agente é criado com sucesso, o Amazon MQ exibe o status **Running** (Em execução).
1. Selecione ***MyBroker*** (MeuAgente).
Na página ***MyBroker***, na seção **Connect (Conectar)**, observe a URL do **[Console da Web do RabbitMQ](https://www.rabbitmq.com/management.html)** do agente, por exemplo:
```
https://b-c8349341-ec91-4a78-ad9c-a57f23f235bb.mq.us-west-2.on.aws
```
Além disso, observe o [Endpoint secure-AMQP****](https://www.rabbitmq.com/connections.html). Veja a seguir um exemplo de endpoint `amqps` expondo a porta listener `5671`.
```
amqps://b-c8349341-ec91-4a78-ad9c-a57f23f235bb.mq.us-west-2.on.aws:5671
```