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. Vous pouvez configurer des réseaux de courtiers dans diverses topologies (par exemple, concentrateur, hub-and-spokesarborescence ou maillage), en fonction des besoins de votre application, tels que la haute disponibilité et l'évolutivité. Par exemple, un réseau hub and spoke d'agents peut augmenter la résilience, préservant les messages si un agent n'est pas accessible. Un réseau d'agents avec une topologie de type hub peut collecter des messages d'un plus grand nombre d'agents acceptant les messages entrants et les concentrer vers des agents plus centraux, afin de mieux gérer la charge de nombreux messages entrants. 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 être dans le même camp VPC ou être pairs. VPCs Pour plus d'informationsVPCs, consultez Qu'est-ce qu'Amazon VPC ? dans le guide de VPC l'utilisateur Amazon et Qu'est-ce que le VPC peering ? dans le Amazon VPC Peering Guide.
Important
Si vous n'avez pas de sous-réseauVPC, de groupe de sécurité ou de sous-réseau par défaut, vous devez d'abord les créer. Pour plus d'informations, consultez les informations suivantes dans le guide de VPC l'utilisateur Amazon :
-
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
Lorsque vous intégrez LDAP l'authentification à un réseau de courtiers, assurez-vous que l'utilisateur existe à la fois en tant que courtier 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 Personnalisé TCP.
-
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 CIDR enregistrement 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 les courtiers sont privés et appartiennent aux mêmes entitésVPC, dans Source, laissez l'option Personnaliser sélectionnée, 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 Save (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 Détails de la configuration, le numéro de révision de la configuration, la description et le XML format de configuration du broker 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-east-2.amazonaws.com:61617
)?randomize=false&maxReconnectAttempts=0)"/> </networkConnectors>
Note
N'incluez pas les informations d'identification de connexion pour l'utilisateur ActiveMQ.
-
-
-
Choisissez Save (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
.