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.

# Réseau de courtiers Amazon MQ
<a name="network-of-brokers"></a>

Amazon MQ prend en charge la fonction de réseau d'agents d'ActiveMQ.

 Un réseau de courtiers est composé de plusieurs courtiers ou active/standby courtiers à instance unique actifs simultanément. La création d'un réseau de courtiers peut améliorer la disponibilité, la tolérance aux pannes et l'équilibrage de charge grâce à plusieurs instances de courtiers. 

## Comment fonctionne un réseau de courtiers ?
<a name="how-does-it-work"></a>

 Un réseau de courtiers est établi en connectant un courtier à un autre à l'aide de *connecteurs réseau*. Un connecteur réseau fournit des messages à la demande d'un courtier à un autre. Les connecteurs réseau sont configurés dans la configuration du broker sous forme de connexions *non duplex* ou *duplex*. Avec des connexions non duplex, les messages sont transférés uniquement d'un agent à un autre. Pour les connexions duplex, les messages sont transférés dans les deux sens entre les deux courtiers. 

 *Si le connecteur réseau est configuré en mode duplex, les messages sont également transférés de *Broker2 à Broker1*.* 

 Vous pouvez utiliser à la fois des connexions duplex et non duplex dans un réseau de courtiers. Vous souhaiterez peut-être introduire une connexion duplex avec un autre courtier pour améliorer le trafic ou pour éviter une augmentation de limite. Les connexions duplex sont également utiles pour la migration partielle des courtiers sur site vers les courtiers gérés par Amazon MQ. 

## Comment un réseau d'agents gère-t-il les informations d'identification ?
<a name="how-does-it-handle-credentials"></a>

Pour qu'un agent A se connecte à un agent B dans un réseau, l'agent A doit utiliser des informations d'identification valides, comme tout autre producteur ou consommateur. Au lieu de fournir un mot de passe dans la configuration `<networkConnector>` de l'agent A, vous devez d'abord créer un utilisateur sur l'agent A avec les mêmes valeurs qu'un autre utilisateur sur l'agent B (ceux-ci sont des utilisateurs *séparés, uniques* qui partagent les mêmes valeurs de nom d'utilisateur et de mot de passe). Lorsque vous spécifiez l'attribut `userName` dans la configuration `<networkConnector>`, Amazon MQ ajoute le mot de passe automatiquement lors de l'exécution.

**Important**  
Ne spécifiez pas l'attribut `password` pour la configuration `<networkConnector>`. Nous vous déconseillons de stocker les mots de passe en texte brut dans les fichiers de configuration de l'agent, car les mots de passe deviennent visibles dans la console Amazon MQ. Pour de plus amples informations, veuillez consulter [Étape 2 : Configurer le réseau de connecteurs pour votre agent](amazon-mq-creating-configuring-network-of-brokers.md#creating-configuring-network-of-brokers-configure-network-connectors).

## Entre régions
<a name="how-to-configure-cross-region"></a>

Pour configurer un réseau de courtiers couvrant plusieurs AWS régions, déployez des courtiers dans ces régions et configurez des connecteurs réseau vers les points de terminaison de ces courtiers.

![Topologie de maillage (mesh) entre régions](http://docs.aws.amazon.com/fr_fr/amazon-mq/latest/developer-guide/images/amazon-mq-nob-cross-region.png)


Pour configurer un réseau d'agents comme dans cet exemple, vous pouvez ajouter des entrées `networkConnectors` aux configurations des agents *Broker1* et *Broker4* qui référencent les points de terminaison de niveau filaire de ces agents.

*Connecteurs de réseau pour Broker1 :*

```
<networkConnectors>
    <networkConnector name="1_to_2" userName="myCommonUser" duplex="true"
        uri="static:(ssl://b-9876l5k4-32ji-109h-8gfe-7d65c4b132a1-2.mq.us-west-2.amazonaws.com:61617)"/>
    <networkConnector name="1_to_3" userName="myCommonUser" duplex="true"
        uri="static:(ssl://b-743c885d-2244-4c95-af67-a85017ff234e-3.mq.us-east-2.amazonaws.com:61617)"/>
    <networkConnector name="1_to_4" userName="myCommonUser" duplex="true"
        uri="static:(ssl://b-62a7fb31-d51c-466a-a873-905cd660b553-4.mq.us-east-2.amazonaws.com:61617)"/>
</networkConnectors>
```

*Connecteur de réseau pour Broker2 :*

```
<networkConnectors>
    <networkConnector name="2_to_3" userName="myCommonUser" duplex="true"
        uri="static:(ssl://b-743c885d-2244-4c95-af67-a85017ff234e-3.mq.us-east-2.amazonaws.com:61617)"/>
</networkConnectors>
```

*Connecteurs de réseau pour Broker4 :*

```
<networkConnectors>
    <networkConnector name="4_to_3" userName="myCommonUser" duplex="true"
        uri="static:(ssl://b-743c885d-2244-4c95-af67-a85017ff234e-3.mq.us-east-2.amazonaws.com:61617)"/>
    <networkConnector name="4_to_2" userName="myCommonUser" duplex="true"
        uri="static:(ssl://b-9876l5k4-32ji-109h-8gfe-7d65c4b132a1-2.mq.us-west-2.amazonaws.com:61617)"/>      
</networkConnectors>
```

## Basculement dynamique avec des connecteurs de transport
<a name="transport-connectors"></a>

En plus de configurer les éléments `networkConnector`, vous pouvez configurer les options `transportConnector` d'agent pour activer le basculement dynamique et rééquilibrer les connexions lorsque des agents sont ajoutés ou supprimés du réseau. 

```
<transportConnectors>
  <transportConnector name="openwire" updateClusterClients="true" rebalanceClusterClients="true" updateClusterClientsOnRemove="true"/>
</transportConnectors>
```

Dans cet exemple, `updateClusterClients` et `rebalanceClusterClients` sont définis sur `true`. Dans ce cas, les clients recevront une liste d'agents dans le réseau et vous leur demanderez d'effectuer un rééquilibrage si un nouvel agent est ajouté.

Options disponibles :
+ `updateClusterClients` : Transmet aux clients des informations sur les modifications apportées au réseau de topologie d'agent.
+ `rebalanceClusterClients` : Entraîne le rééquilibrage des clients entre les agents lorsqu'un nouvel agent est ajouté à un réseau d'agents.
+ `updateClusterClientsOnRemove` : Met à jour les clients avec des informations de topologie lorsqu'un agent quitte un réseau d'agents.

Quand `updateClusterClients` est défini sur true, les clients peuvent être configurés pour se connecter à un seul agent dans un réseau d'agents. 

```
failover:(ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617)
```

Lorsqu'un nouveau courtier se connecte, il reçoit une liste URIs de tous les courtiers du réseau. Si la connexion à l'agent échoue, un basculement dynamique peut être effectué sur l'un des agents fournis lorsque la connexion a été établie.

Pour plus d'informations sur le basculement, consultez [Broker-side Options for Failover](http://activemq.apache.org/failover-transport-reference.html#FailoverTransportReference-Broker-sideOptionsforFailover) dans la documentation Active MQ.