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 configuration d'un réseau d'agents Amazon MQ Un *réseau d'agents* est composé de plusieurs [agents à instance unique](amazon-mq-broker-architecture.md#single-broker-deployment) actifs simultanément ou plusieurs [agents actifs/en veille](amazon-mq-broker-architecture.md#active-standby-broker-deployment). Dans ce didacticiel, vous allez apprendre à créer un réseau d'agents à deux agents avec une topologie *source et puits*. Pour une présentation conceptuelle et des informations de configuration détaillées, consultez les sections suivantes : + [Réseau de courtiers Amazon MQ](network-of-brokers.md) + [Correctement configurer votre réseau d'agents](best-practices-activemq.md#network-of-brokers-configure-correctly) + `networkConnector` + `networkConnectionStartAsynchrone` + [Réseaux d'agents](http://activemq.apache.org/networks-of-brokers.html) dans la documentation ActiveMQ Vous pouvez utiliser la console Amazon MQ pour créer un réseau d'agents Amazon MQ. Puisque vous pouvez démarrer la création des deux agents en parallèle, ce processus dure environ 15 minutes. **Topics** + [Conditions préalables](#creating-configuring-network-of-brokers-create-brokers) + [Configure the Brokers in a Network](#creating-configuring-network-of-brokers-allow-traffic) + [Configure Network Connectors for Your Broker](#creating-configuring-network-of-brokers-configure-network-connectors) + [Next Steps: Test the Network of Brokers](#creating-configuring-network-of-brokers-test) ## Conditions préalables Pour créer un réseau d'agents, vous devez disposer des éléments suivants : + Deux ou plusieurs agents actifs simultanément (nommés `MyBroker1` et `MyBroker2` dans ce didacticiel). Pour plus d'informations sur la création d'agents, consultez le didacticiel [Mise en route : création et connexion à un courtier ActiveMQ](getting-started-activemq.md). + Les deux courtiers doivent appartenir au même VPC ou être pairs. VPCs Pour plus d'informations VPCs, consultez [Qu'est-ce qu'Amazon VPC ?](https://docs.aws.amazon.com/vpc/latest/userguide/what-is-amazon-vpc.html) dans le *guide de l'utilisateur Amazon VPC* et [qu'est-ce que le peering VPC ?](https://docs.aws.amazon.com/vpc/latest/peering/Welcome.html) dans le guide de *peering Amazon VPC*. **Important** Si vous n'avez pas de VPC par défaut, de sous-réseau(x) ou de groupe de sécurité, vous devez les créer en premier. Pour plus d'informations, consultez ce qui suit dans le *Guide de l'utilisateur Amazon VPC* : [Création d'un VPC par défaut](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html#create-default-vpc) [Création d'un sous-réseau par défaut](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html#create-default-subnet) [Création d'un groupe de sécurité](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html#CreatingSecurityGroups) + Deux utilisateurs avec des informations d'identification de connexion identiques pour les deux agents. Pour plus d'informations sur la création d'utilisateurs, consultez [Création d'un utilisateur de courtier ActiveMQ](amazon-mq-listing-managing-users.md). **Note** Lors de l'intégration de l'authentification LDAP à un réseau d'agents, assurez-vous que l'utilisateur existe à la fois en tant qu'agents ActiveMQ et en tant qu'utilisateur LDAP. L'exemple suivant utilise deux [agents à instance unique](amazon-mq-broker-architecture.md#single-broker-deployment). Cependant, vous pouvez créer des réseaux d'agents à l'aide d'[agents actifs/en veille](amazon-mq-broker-architecture.md#active-standby-broker-deployment) ou d'une combinaison des modes de déploiement d'agents. ## Étape 1 : Autoriser le trafic entre les agents Une fois que vous avez créé vos agents, vous devez autoriser le trafic entre eux. 1. Sur la [console Amazon MQ](https://console.aws.amazon.com/amazon-mq/), sur la page **MyBroker2**, dans la section **Détails**, sous **Sécurité et réseau**, choisissez le nom de votre groupe de sécurité ou. ![Pencil icon indicating an edit or modification action.](http://docs.aws.amazon.com/fr_fr/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-broker-details-link.png) La page **Groupes de sécurité** du tableau de bord EC2 est affichée. 1. Dans la liste des groupes de sécurité, choisissez votre groupe de sécurité. 1. Au bas de la page, choisissez **Entrant**, puis **Modifier**. 1. Dans la boîte de dialogue **Modifier les règles entrantes**, ajoutez une règle pour le OpenWire point de terminaison. 1. Choisissez **Add Rule** (Ajouter une règle). 1. Pour **Type**, sélectionnez **Custom TCP (TCP personnalisé)**. 1. Pour **Port Range**, tapez le OpenWire port (`61617`). 1. Effectuez l’une des actions suivantes : + Si vous souhaitez limiter l'accès à une adresse IP en particulier, pour **Source**, laissez **Personnalisé** sélectionné, puis saisissez l'adresse IP de `MyBroker1`, suivie de `/32`. (Cela convertit l'adresse IP en un enregistrement CIDR valide). Pour plus d'informations, consultez [Interfaces réseau Elastic](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html). **Astuce** Pour extraire l'adresse IP de `MyBroker1`, sur la [console Amazon MQ](https://console.aws.amazon.com/amazon-mq/), choisissez le nom de l'agent et accédez à la section **Details (Détails)**. + Si tous vos agents sont privés et appartiennent au même VPC, pour **Source**, laissez **Personnalisé** sélectionné, puis saisissez l'ID du groupe de sécurité que vous modifiez. **Note** Pour les agents publics, vous devez limiter l'accès à l'aide d'adresses IP. 1. Choisissez **Enregistrer**. Votre agent peut désormais accepter les connexions entrantes. ## Étape 2 : Configurer le réseau de connecteurs pour votre agent Une fois le trafic autorisé entre vos agents, vous devez configurer les connecteurs de réseau pour l'un d'entre eux. 1. Modifiez la révision de configuration pour l'agent `MyBroker1`. 1. Sur la page **MyBroker1**, choisissez **Modifier**. 1. Sur la page **Modifier MyBroker 1**, dans la section **Configuration**, choisissez **Afficher**. Le type de moteur de l'agent et la version que la configuration utilise (par exemple, **Apache ActiveMQ 5.15.0**) sont affichés. 1. Dans l'onglet **Configuration details**, le numéro de révision de configuration, la description et la configuration d'agent au format XML sont affichés. 1. Choisissez **Modifier la configuration**. 1. En bas du fichier de configuration, supprimez la section `` et incluez les informations suivantes : + Le `name` du connecteur de réseau. + [Le `username`](#creating-configuring-network-of-brokers-create-brokers) de la console web ActiveMQ qui est commune aux deux agents. + Activer les connexions `duplex`. + Effectuez l’une des actions suivantes : + Si vous connectez le broker à un broker à instance unique, utilisez le `static:` préfixe et le OpenWire point de terminaison `uri` pour. `MyBroker2` Par exemple : ``` ``` + Si vous connectez le courtier à un courtier actif/de secours, utilisez le `static+failover` transport et le point de OpenWire terminaison `uri` pour les deux courtiers avec les paramètres de requête suivants. `?randomize=false&maxReconnectAttempts=0` Par exemple : ``` ``` **Note** N'incluez pas les informations d'identification de connexion pour l'utilisateur ActiveMQ. 1. Choisissez **Enregistrer**. 1. Dans la boîte de dialogue **Save revision (Enregistrer la révision)**, tapez `Add network of brokers connector for MyBroker2`. 1. Choisissez **Enregistrer** pour enregistrer la nouvelle révision de la configuration. 1. Modifier l'agent `MyBroker1` pour définir la dernière révision de configuration comme s'appliquant immédiatement. 1. Sur la page **MyBroker1**, choisissez **Modifier**. 1. Sur la page **Modifier MyBroker 1**, dans la section **Configuration**, sélectionnez **Planifier les modifications**. 1. Dans la section **Schedule broker modifications (Planifier les modifications de l'agent)**, choisissez d'appliquer les modifications **immédiatement**. 1. Cliquez sur **Appliquer**. L'agent `MyBroker1` est redémarré et votre révision de configuration est appliquée. Le réseau d'agents est créé. ## Étapes suivantes Une fois votre réseau d'agents configuré, vous pouvez le tester en produisant et en consommant des messages. **Important** Assurez-vous d'[activer les connexions entrantes](amazon-mq-working-java-example.md#quick-start-allow-inbound-connections) *depuis votre machine locale* pour le broker `MyBroker1` sur le port 8162 (pour la console Web ActiveMQ) et le port 61617 (pour le point de terminaison). OpenWire Il se peut également que vous ayez besoin de régler les paramètres de votre(vos) groupe(s) de sécurité afin d'autoriser le producteur et le consommateur à se connecter au réseau d'agents. 1. Sur la [console Amazon MQ](https://console.aws.amazon.com/amazon-mq/), accédez à la section **Connections (Connexions)** et notez le point de terminaison de la console web ActiveMQ pour l'agent `MyBroker1`. 1. Accédez à la console web ActiveMQ pour l'agent `MyBroker1`. 1. Pour vérifier que le pont réseau est connecté, choisissez **Réseau**. Dans la section **Network Bridges** (Ponts de réseau), le nom et l'adresse du `MyBroker2` sont listés dans les colonnes **Remote Broker** (Agent à distance) et **Remote Address** (Adresse à distance). 1. À partir de n'importe quelle machine ayant accès à l'agent `MyBroker2`, créez un consommateur. Par exemple : ``` activemq consumer --brokerUrl "ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617" \ --user commonUser \ --password myPassword456 \ --destination queue://MyQueue ``` Le consommateur se connecte au OpenWire point de terminaison de `MyBroker2` et commence à consommer les messages de la file d'attente`MyQueue`. 1. À partir de n'importe quelle machine ayant accès à l'agent `MyBroker1`, créez un producteur et envoyez quelques messages. Par exemple : ``` activemq producer --brokerUrl "ssl://b-9876l5k4-32ji-109h-8gfe-7d65c4b132a1-1.mq.us-east-2.amazonaws.com:61617" \ --user commonUser \ --password myPassword456 \ --destination queue://MyQueue \ --persistent true \ --messageSize 1000 \ --messageCount 10000 ``` Le producteur se connecte au OpenWire point de terminaison de `MyBroker1` et commence à produire des messages persistants à mettre en file d'attente`MyQueue`.