Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Création et application de configurations d'agent RabbitMQ
<a name="rabbitmq-creating-applying-configurations"></a>

Une *configuration* contient tous les paramètres de votre agent RabbitMQ au format Cuttlefish. Vous pouvez créer une configuration avant de créer des agents. Vous pouvez ensuite appliquer la configuration à un ou plusieurs agents.

Les exemples suivants montrent comment créer une configuration d'agent RabbitMQ et comment l'appliquer à l'aide de la  AWS Management Console.

**Important**  
Vous ne pouvez **supprimer** une configuration qu'à l'aide de l'`DeleteConfiguration`API. Pour plus d'informations, consultez [Configurations](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html) dans le manuel *Amazon MQ API Reference*.

## Création d'une nouvelle configuration
<a name="creating-rabbitmq-configuration-from-scratch-console"></a>

 Pour appliquer une configuration à votre broker, vous devez d'abord créer la configuration. 

1. Connectez-vous à la [console Amazon MQ](https://console.aws.amazon.com/amazon-mq/).

1. Sur la gauche, développez le volet de navigation et choisissez **Configurations**.  
![Amazon MQ navigation panel showing Brokers and Configurations options.](http://docs.aws.amazon.com/fr_fr/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-create-configuration.png)

1. Sur la page **Configurations**, choisissez **Create configuration (Créer une configuration)**.

1. Sur la page **Create configuration** (Créer une configuration), dans la section **Details** (Détails), saisissez le **Configuration name** (Nom de configuration) (par exemple, `MyConfiguration`) et sélectionnez une version de **Broker engine** (Moteur d'agent).

   Pour en savoir plus sur les versions du moteur RabbitMQ prises en charge par Amazon MQ for RabbitMQ, consultez [Gestion des versions du moteur Amazon MQ for RabbitMQ](rabbitmq-version-management.md).

1. Choisissez **Créer une configuration**.

## Créer une révision de configuration
<a name="creating-new-rabbitmq-configuration-revision-console"></a>

 Après avoir créé une configuration, vous devez la modifier à l'aide d'une révision de configuration. 

1. Dans la liste des configurations, choisissez **{{MyConfiguration}}**.
**Note**  
La première révision de configuration est toujours créée lorsqu'Amazon MQ crée la configuration.

   Sur la **{{MyConfiguration}}**page, le type et la version du moteur de courtage utilisés par votre nouvelle révision de configuration (par exemple, **RabbitMQ 3.xx.xx**) sont affichés.

1. Dans l'onglet **Détails de configuration** figurent le numéro de révision de configuration, la description et la configuration d'agent au format Cuttlefish.
**Note**  
La modification de la configuration actuelle crée une nouvelle révision de configuration.

1. Choisissez **Modifier la configuration** et apportez les modifications à la configuration Cuttlefish.

1. Choisissez **Enregistrer**.

   La boîte de dialogue **Save revision (Enregistrer la révision)** s'affiche.

1. (Facultatif) Type `A description of the changes in this revision`.

1. Choisissez **Save (Enregistrer)**.

   La nouvelle révision de configuration est enregistrée.
**Important**  
Apporter des modifications à une configuration n'applique *pas* immédiatement les modifications à l'agent. Pour appliquer vos modifications, vous devez attendre la fenêtre de maintenance suivante ou [redémarrer l’agent](amazon-mq-rebooting-broker.md).  
Actuellement, vous ne pouvez pas supprimer une configuration.

## Appliquer une révision de configuration à votre agent
<a name="apply-rabbitmq-configuration-revision-creating-console"></a>

 Après avoir créé la révision de configuration, vous pouvez appliquer la révision de configuration à votre courtier. 

1. Sur la gauche, développez le volet de navigation et choisissez **Brokers (Agents)**.  
![Amazon MQ navigation panel showing Brokers and Configurations options.](http://docs.aws.amazon.com/fr_fr/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-apply-configuration.png)

1. Dans la liste des courtiers, sélectionnez votre courtier (par exemple **MyBroker**), puis choisissez **Modifier**.

1. Sur la {{MyBroker}} page **Modifier**, dans la section **Configuration**, sélectionnez une **configuration** et une **révision**, puis choisissez **Planifier les modifications**.

1. Dans la section **Schedule broker modifications (Planifier les modifications de l'agent)**, choisissez si les modifications doivent être appliquées **During the next scheduled maintenance window (Au cours de la prochaine fenêtre de maintenance)** ou **Immediately (immédiatement)**.
**Important**  
Les courtiers à instance unique sont hors ligne lors du redémarrage. Pour les courtiers en clusters, un seul nœud est en panne à la fois lorsque le courtier redémarre.

1. Cliquez sur **Appliquer**.

   Votre révision de configuration est appliquée à votre agent à l'heure spécifiée.