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 ActiveMQ
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, veuillez consulter [Qu'est-ce qu'un courtier Amazon MQ pour ActiveMQ ?](amazon-mq-basic-elements.md#broker).
## Création d'un courtier ActiveMQ
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.
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 **Apache ActiveMQ**.
1. Dans la page **Select deployement and storage (Sélectionner le déploiement et le stockage)**, dans la section **Deployement mode and storage type (Mode de déploiement et type de stockage)**, procédez comme suit :
1. Cliquez sur l'onglet **Deployement mode (Mode de déploiement)** (par exemple, **Active/standby broker (Agent actif/en veille)**. Pour de plus amples informations, veuillez consulter [Options de déploiement pour Amazon MQ pour les courtiers ActiveMQ](amazon-mq-broker-architecture.md).
+ Un **agent à instance unique** est composé d'un agent dans une zone de disponibilité. L'agent communique avec votre application et avec un volume de stockage Amazon EBS ou Amazon EFS. Pour de plus amples informations, veuillez consulter [Option 1 : courtiers en instance unique Amazon MQ](amazon-mq-broker-architecture.md#single-broker-deployment).
+ Un **agent actif/en veille pour une haute disponibilité** est composé de deux agents répartis dans deux zones de disponibilité différentes, configurés dans une *paire redondante*. Ces agents communiquent de manière synchrone avec votre application et avec Amazon EFS. Pour de plus amples informations, veuillez consulter [Option 2 : active/standby courtiers Amazon MQ pour une haute disponibilité](amazon-mq-broker-architecture.md#active-standby-broker-deployment).
1. Cliquez sur **Storage type (Type de stockage)** (par exemple, **EBS**). Pour de plus amples informations, veuillez consulter [Amazon MQ pour les types de stockage ActiveMQ](broker-storage.md).
**Note**
Amazon EBS réplique les données dans une seule zone de disponibilité et ne prend pas en charge le mode de déploiement [actif/en veille ActiveMQ](amazon-mq-broker-architecture.md#active-standby-broker-deployment).
1. Choisissez **Suivant**.
1. Sur la page **Configure settings (Configurer les paramètres)**, dans la section **Details (Détails)**, effectuez ce qui suit :
1. Renseignez **Broker name (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.
**Note**
Dans la section **Paramètres supplémentaires**, vous pouvez également configurer les éléments suivants :
[Configurations](amazon-mq-broker-configuration-parameters.md)
[CloudWatch journaux](security-logging-monitoring.md)
Accès privé
[Fenêtre de maintenance du courtier](maintaining-brokers.md)
1. Cliquez sur **Broker instance type (Type d'instance de l'agent)** (par exemple, **mq.m5.large**). Pour de plus amples informations, veuillez consulter [Types d'instances de courtier Amazon MQ pour ActiveMQ](broker-instance-types.md).
1. Dans la section **ActiveMQ Web Console access (Accès à la console web ActiveMQ)**, renseignez **Username (Nom d'utilisateur)** et **Password (Mot de passe)**. Les restrictions suivantes s'appliquent aux noms d'utilisateur et aux mots de passe des agents :
+ Votre nom d'utilisateur peut contenir uniquement des caractères alphanumériques, des tirets, des points, des traits de soulignement et des tildes (- . \$1 \$1).
+ 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.
1. Choisissez **Déployer**.
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 ActiveMQ de votre courtier, par exemple :](http://activemq.apache.org/web-console.html)**
```
https://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:8162
```
Notez également que les [**points de terminaison** du protocole de niveau filaire](http://activemq.apache.org/configuring-transports.html) de votre agent. Voici un exemple de point de OpenWire terminaison :
```
ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617
```