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.
# Mise en route : création et connexion à un courtier RabbitMQ
Un *agent* est un environnement d'agent de messages qui s'exécute sur Amazon MQ. Il constitue la composante de base d'Amazon MQ. La description combinée de la *classe* d'instance de courtier (`m5`) et de *la taille* (`large`,`medium`) est appelée *type d'instance de courtier* (par exemple,`mq.m5.large`). Pour de plus amples informations, consultez [Qu'est-ce qu'un courtier Amazon MQ pour RabbitMQ ?](working-with-rabbitmq.md#rabbitmq-basic-elements-broker).
## Créez un courtier RabbitMQ
La tâche Amazon MQ la plus importante et la plus courante consiste à créer un agent. L'exemple suivant montre comment vous pouvez utiliser le AWS Management Console pour créer un courtier de base.
Lorsque vous créez un courtier Amazon MQ pour RabbitMQ, suivez les [meilleures pratiques de configuration du courtier pour RabbitMQ afin de maximiser les performances du courtier et d'optimiser l'efficacité du débit](best-practices-broker-setup.md) des messages.
1. Connectez-vous à la [console Amazon MQ](https://console.aws.amazon.com/amazon-mq/).
1. Dans la page **Select broker engine (Sélectionner le moteur de l'agent)**, choisissez **RabbitMQ**, puis choisissez **Next (Suivant)**.
1. Dans la page **Select deployment mode (Sélectionner le mode de déploiement)**, choisissez le **mode de déploiement**, par exemple, **Cluster deployment (Déploiement en cluster)**, puis choisissez **Next (Suivant)**.
+ Un **agent à instance unique** est composé d'un agent dans une zone de disponibilité derrière d'un Network Load Balancer (NLB). L'agent communique avec votre application et avec un volume de stockage Amazon EBS. Pour de plus amples informations, veuillez consulter [Option 1 : courtier à instance unique Amazon MQ pour RabbitMQ](rabbitmq-broker-architecture.md#rabbitmq-broker-architecture-single-instance).
+ Un **déploiement en cluster RabbitMQ pour une haute disponibilité** est un regroupement logique de trois nœuds d'agent RabbitMQ derrière d'un Network Load Balancer, chacun partageant des utilisateurs, des files d'attente et un état distribué sur plusieurs zones de disponibilité (AZ). Pour de plus amples informations, veuillez consulter [Option 2 : déploiement du cluster Amazon MQ pour RabbitMQ](rabbitmq-broker-architecture.md#rabbitmq-broker-architecture-cluster).
1. Sur la page **Configure settings (Configurer les paramètres)**, dans la section **Details (Détails)**, effectuez ce qui suit :
1. Saisissez le nom de l'agent.
**Important**
N'ajoutez pas de données d'identification personnelle (PII) ou d'autres données confidentielles ou sensibles dans les noms d'agents. Les noms des courtiers sont accessibles à d'autres AWS services, notamment CloudWatch aux journaux. Les noms d'agents ne sont pas destinées à être utilisées pour des données privées ou sensibles.
1. Choisissez le **type d'instance Broker** (par exemple, **mq.m7g.large**). Pour de plus amples informations, veuillez consulter [Types d'instances de courtier Amazon MQ pour ActiveMQ](broker-instance-types.md).
1. Dans la page **Configure settings (Configuration des paramètres)**, dans la section **RabbitMQ access (Accès à RabbitMQ)**, renseignez les champs **Username (Nom d'utilisateur)** et **Password (Mot de passe)**. Les restrictions suivantes s'appliquent aux informations d’identification de connexion des agents :
+ Votre nom d'utilisateur peut contenir uniquement des caractères alphanumériques, des tirets, des points et des traits de soulignement (- . \$1). Cette valeur ne doit pas contenir de caractères tilde (\$1). Amazon MQ interdit l'utilisation de `guest` comme nom d'utilisateur.
+ Votre mot de passe doit comporter 12 caractères minimum, dont au moins 4 caractères uniques, et ne doit pas contenir de virgules, de deux-points ou de signes égal (,:=).
**Important**
N'ajoutez pas de données d'identification personnelle (PII) ou d'autres données confidentielles ou sensibles dans les noms d'utilisateur des agents. Les noms d'utilisateur des courtiers sont accessibles à d'autres AWS services, notamment aux CloudWatch journaux. Les noms d'utilisateur des agents ne sont pas destinées à être utilisées pour des données privées ou sensibles.
**Note**
Dans la section **Paramètres supplémentaires**, vous pouvez également configurer les éléments suivants :
[Configurations](rabbitmq-broker-configuration-parameters.md)
[CloudWatch journaux](security-logging-monitoring.md)
Accès privé
[Fenêtre de maintenance du courtier](maintaining-brokers.md)
1. Choisissez **Suivant**.
1. Dans la page **Review and create (Vérifier et créer)**, vous pouvez vérifier vos sélections et les modifier si nécessaire.
1. Choisissez **Create broker (Créer un agent)**.
Alors qu'Amazon MQ crée votre agent, il affiche l'état **Creation in progress (Création en cours)**.
La création d'un agent prend environ 15 minutes.
Lorsque votre agent est créé avec succès, Amazon MQ affiche l'état **Running (En cours d'exécution)**.
1. Sélectionnez ***MyBroker***.
Sur la ***MyBroker***page, dans la section **Connect**, notez l'URL de la **[console Web RabbitMQ](https://www.rabbitmq.com/management.html)** de votre courtier, par exemple :
```
https://b-c8349341-ec91-4a78-ad9c-a57f23f235bb.mq.us-west-2.on.aws
```
Notez également le [**point de terminaison** secure-AMQP](https://www.rabbitmq.com/connections.html) de votre agent. Voici un exemple de `amqps`point de terminaison exposant un port d'écouteur `5671`.
```
amqps://b-c8349341-ec91-4a78-ad9c-a57f23f235bb.mq.us-west-2.on.aws:5671
```