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 ActiveMQ
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 ActiveMQ?](amazon-mq-basic-elements.md#broker).
## Criar um operador do ActiveMQ
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.
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 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. Selecione o **Deployment mode** (Modo de implantação) (por exemplo:**Agente ativo/em espera**). Para obter mais informações, consulte [Opções de implantação de agentes do Amazon MQ para ActiveMQ](amazon-mq-broker-architecture.md).
+ Um **agente de instância única** é composto por um agente em uma Zona de disponibilidade. O agente se comunica com sua aplicação e com um volume de armazenamento do Amazon EBS ou Amazon EFS. Para obter mais informações, consulte [Opção 1: agentes de instância única do Amazon MQ](amazon-mq-broker-architecture.md#single-broker-deployment).
+ Um **agente ativo/em espera de alta disponibilidade** é 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ção 2: active/standby corretores Amazon MQ para alta disponibilidade](amazon-mq-broker-architecture.md#active-standby-broker-deployment).
1. Escolha o **Tipo de armazenamento** (por exemplo, **EBS**). Para obter mais informações, consulte [Tipos de armazenamento do Amazon MQ para o ActiveMQ](broker-storage.md).
**nota**
O Amazon EBS replica dados em uma única zona de disponibilidade e não é compatível com o modo de implantação [ativo/em espera do ActiveMQ](amazon-mq-broker-architecture.md#active-standby-broker-deployment).
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.
**nota**
Na seção **Configurações adicionais**, você também pode configurar o seguinte:
[Configurações](amazon-mq-broker-configuration-parameters.md)
[CloudWatch Logs](security-logging-monitoring.md)
Acesso privado
[Janela de manutenção de agente](maintaining-brokers.md)
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 (- . \$1 \$1).
+ 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. Escolha **Implantar**.
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 ActiveMQ](http://activemq.apache.org/web-console.html)** do agente, por exemplo:
```
https://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:8162
```
Além disso, observe os [**Endpoints** de protocolo de nível de conexão ](http://activemq.apache.org/configuring-transports.html) do seu agente. Veja a seguir um exemplo de endpoint OpenWire.
```
ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617
```