

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á.

# Criação e aplicação de configurações do agente do RabbitMQ
<a name="rabbitmq-creating-applying-configurations"></a>

Uma *configuração* contém todas as definições do agente do RabbitMQ, no formato Cuttlefish. Você pode criar uma configuração antes de criar qualquer agente. Depois, você pode aplicar a configuração a um ou mais agentes

Os exemplos a seguir mostram como criar e aplicar uma configuração do agente do RabbitMQ utilizando o Console de gerenciamento da AWS.

**Importante**  
Você só pode **excluir** uma configuração usando a API do `DeleteConfiguration`. Para obter mais informações, consulte [Configurações](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html) na *Referência da API do Amazon MQ*.

## Criar uma configuração
<a name="creating-rabbitmq-configuration-from-scratch-console"></a>

 Para aplicar uma configuração ao agente, primeiro você deve criar a configuração. 

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

1. Do lado esquerdo, expanda o painel de navegação e selecione **Configurations (Configurações)**.  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/pt_br/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-create-configuration.png)

1. Na página **Configurações**, selecione **Criar configuração**.

1. Na página **Criar configuração**, na seção **Detalhes**, digite o **Nome da configuração** (por exemple, `MyConfiguration`) e selecione uma versão do **Mecanismo do agente**.

   Para saber mais sobre as versões do mecanismo do RabbitMQ compatíveis com o Amazon MQ para RabbitMQ, consulte [Gerenciando o Amazon MQ para versões do mecanismo RabbitMQ](rabbitmq-version-management.md).

1. Escolha **Criar configuração**.

## Criar uma revisão de configuração
<a name="creating-new-rabbitmq-configuration-revision-console"></a>

 Depois de criar uma configuração, você deverá editá-la usando uma revisão de configuração. 

1. Na lista de configuração, escolha ***MyConfiguration***.
**nota**  
A primeira revisão de configuração será sempre criada para você quando o Amazon MQ criar a configuração.

   Na ***MyConfiguration***página, o tipo e a versão do mecanismo do broker que sua nova revisão de configuração usa (por exemplo, **RabbitMQ 3.xx.xx**) são exibidos.

1. Na guia **Detalhes da configuração**, são exibidos o número de revisão da configuração, a descrição e a configuração do agente no formato Cuttlefish.
**nota**  
Editar a configuração atual irá criar uma nova revisão da configuração.

1. Selecione **Editar configuração** e faça as alterações na configuração do Cuttlefish.

1. Escolha **Salvar**.

   A caixa e diálogo **Save revision** (Salvar revisão) será exibida.

1. (Opcional) Tipo `A description of the changes in this revision`.

1. Escolha **Salvar**.

   A nova revisão da configuração é salva.
**Importante**  
Fazer alterações em uma configuração *não* aplica as alterações ao agente imediatamente. Para aplicar as alterações, você deve aguardar a próxima janela de manutenção ou [reiniciar o agente](amazon-mq-rebooting-broker.md).  
No momento, não é possível excluir uma configuração.

## Aplicar uma revisão de configuração ao operador
<a name="apply-rabbitmq-configuration-revision-creating-console"></a>

 Depois de criar a revisão da configuração, você pode aplicá-la ao agente. 

1. Do lado esquerdo, expanda o painel de navegação e selecione **Brokers (Agentes)**.  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/pt_br/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-apply-configuration.png)

1. Na lista de corretores, selecione seu corretor (por exemplo **MyBroker**) e escolha **Editar**.

1. Na *MyBroker* página **Editar**, na seção **Configuração**, selecione uma **Configuração** e uma **Revisão** e, em seguida, escolha **Programar Modificações**.

1. Na seção **Schedule broker modifications (Programar modificações no operador)**, escolha se deseja aplicar as modificações **During the next scheduled maintenance window (Durante a próxima janela de manutenção programada)** ou **Immediately (Imediatamente)**.
**Importante**  
Os agentes de instância única ficarão offline durante a reinicialização. Para agentes de cluster, somente um nó fica inativo por vez enquanto o agente é reinicializado.

1. Escolha **Aplicar**.

   Sua revisão de configuração será aplicada ao agente no horário especificado.