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 actifs simultanément ou plusieurs agents actifs/en veille. 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éseaux d'agents
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.
Rubriques
Prérequis
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
etMyBroker2
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. -
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 ? dans le guide de l'utilisateur Amazon VPC et qu'est-ce que le peering VPC ? 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 :
-
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.
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. Cependant, vous pouvez créer des réseaux d'agents à l'aide d'agents actifs/en veille 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.
-
Sur la console 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. La page Groupes de sécurité du EC2 tableau de bord s'affiche.
-
Dans la liste des groupes de sécurité, choisissez votre groupe de sécurité.
-
Au bas de la page, choisissez Entrant, puis Modifier.
-
Dans la boîte de dialogue Modifier les règles entrantes, ajoutez une règle pour le OpenWire point de terminaison.
-
Choisissez Add Rule (Ajouter une règle).
-
Pour Type, sélectionnez Custom TCP (TCP personnalisé).
-
Pour Port Range, tapez le OpenWire port (
61617
). -
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.Astuce
Pour extraire l'adresse IP de
MyBroker1
, sur la console 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.
-
-
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.
-
Modifiez la révision de configuration pour l'agent
MyBroker1
.-
Sur la page MyBroker1, choisissez Modifier.
-
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.
-
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.
-
Choisissez Modifier la configuration.
-
En bas du fichier de configuration, supprimez la section
<networkConnectors>
et incluez les informations suivantes :-
Le
name
du connecteur de réseau. -
Le username 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 terminaisonuri
pour.MyBroker2
Par exemple :<networkConnectors> <networkConnector name="
connector_1_to_2
" userName="myCommonUser
" duplex="true" uri="static:(ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617
)"/> </networkConnectors> -
Si vous connectez le courtier à un courtier actif/de secours, utilisez le
static+failover
transport et le point de OpenWire terminaisonuri
pour les deux courtiers avec les paramètres de requête suivants.?randomize=false&maxReconnectAttempts=0
Par exemple :<networkConnectors> <networkConnector name="
connector_1_to_2
" userName="myCommonUser
" duplex="true" uri="static:(failover:(ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617, ssl://b-9876l5k4-32ji-109h-8gfe-7d65c4b132a1-2.mq.us-west-2.amazonaws.com:61617
)?randomize=false&maxReconnectAttempts=0)"/> </networkConnectors>
Note
N'incluez pas les informations d'identification de connexion pour l'utilisateur ActiveMQ.
-
-
-
Choisissez Enregistrer.
-
Dans la boîte de dialogue Save revision (Enregistrer la révision), tapez
Add network of brokers connector for MyBroker2
. -
Choisissez Enregistrer pour enregistrer la nouvelle révision de la configuration.
-
-
Modifier l'agent
MyBroker1
pour définir la dernière révision de configuration comme s'appliquant immédiatement.-
Sur la page MyBroker1, choisissez Modifier.
-
Sur la page Modifier MyBroker 1, dans la section Configuration, sélectionnez Planifier les modifications.
-
Dans la section Schedule broker modifications (Planifier les modifications de l'agent), choisissez d'appliquer les modifications immédiatement.
-
Choisissez 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 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.
-
Sur la console Amazon MQ
, accédez à la section Connections (Connexions) et notez le point de terminaison de la console web ActiveMQ pour l'agent MyBroker1
. -
Accédez à la console web ActiveMQ pour l'agent
MyBroker1
. -
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). -
À 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'attenteMyQueue
. -
À 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'attenteMyQueue
.