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éplication de données entre régions pour Amazon MQ pour ActiveMQ
Amazon MQ pour ActiveMQ propose une fonctionnalité de réplication des données entre régions (CRDR) qui permet la réplication asynchrone des messages depuis le courtier principal d'une région principale vers le courtier répliqué d'une région de réplication. AWS En émettant une demande de basculement à l'API Amazon MQ, l'agent de répliques actuel est promu au rôle d'agent principal et l'agent principal actuel est rétrogradé au rôle de réplique.
## Brokers principaux et répliques pour la réplication de données entre régions
Vous pouvez créer des courtiers principaux et de répliques pour la réplication asynchrone des données depuis le courtier principal d'une AWS région principale vers le courtier de réplication d'une région de réplication. La *région principale* se compose d'une paire redondante d'agents actifs/en veille, appelée *agent principal*. La *région secondaire* se compose d'une paire redondante d'agents actifs/en veille, appelée *agent de répliques*.
Le schéma suivant illustre un agent de répliques dans une région secondaire recevant des données répliquées asynchrones de la part de l'agent principal situé dans la région principale.
![\[Diagram showing primary and replica brokers in different AWS regions with replication traffic flow.\]](http://docs.aws.amazon.com/fr_fr/amazon-mq/latest/developer-guide/images/primary-replica-connection.png)
Les agents principaux et de répliques agissent comme une solution de récupération de données entre régions. Si l'agent principal situé dans la région principale échoue, vous pouvez promouvoir l'agent de répliques situé dans la région secondaire au rang d'agent principal en lançant une commutation ou un basculement. L'ancien agent principal devient alors l'agent de répliques, et l'ancien agent de répliques est promu agent principal. Pour obtenir des instructions sur la création d'un agent principal et d'un agent de répliques, consultez [Création d'un courtier de réplication de données entre régions Amazon MQ](create-replica-broker.md).
**Note**
Disponible uniquement pour les agents actifs/en veille.
Non disponible pour les files d'attente en miroir.
# Création d'un courtier de réplication de données entre régions Amazon MQ
Grâce à la réplication de données entre régions (CRDR), vous pouvez basculer entre les agents de messages Amazon MQ pour ActiveMQ dans deux régions AWS, selon vos besoins. Vous pouvez désigner un agent existant comme agent principal et créer une réplique pour cet agent, ou créer ensemble un nouvel agent principal et un nouvel agent de répliques. Vous pouvez ensuite promouvoir l'agent de répliques au rôle d'agent principal à l'aide de l'opération d'API `Promote` Amazon MQ. Pour plus d'informations sur les agents principaux et les agents de répliques, consultez [Brokers principaux et répliques pour la réplication de données entre régions](crdr-for-active-mq.md#crdr-primary-replica-brokers).
Les instructions suivantes décrivent comment créer et configurer un agent de répliques à l'aide de la console de gestion Amazon MQ.
**Topics**
+ [
## Prérequis
](#create-crdr-broker-prerequisites)
+ [
## Étape 1 (facultative) : Créer un nouvel agent principal
](#create-new-primary-broker)
+ [Create a replica of an existing broker](#create-new-replica-broker)
## Prérequis
Pour utiliser la fonctionnalité de réplication de données inter-régions, vous devez vérifier et respecter les prérequis suivants :
+ **Version** : la fonctionnalité de réplication de données inter-régions est uniquement disponible pour Amazon MQ pour les agents ActiveMQ dans la version 5.17.6 et supérieures.
+ **Région** : la réplication de données inter-régions est prise en charge dans les régions suivantes : USA Est (Ohio), USA Est (Virginie du Nord), USA Ouest (Oregon) et USA Ouest (Californie du Nord).
+ **Type d'instance** : la réplication de données inter-régions n'est disponible que pour les instances d'agent d'une taille de `mq.m5.large` ou supérieure.
+ **Type de déploiement** : la réplication de données inter-régions n'est disponible que pour les agents actifs/en veille avec un déploiement dans plusieurs zones de disponibilité.
+ **État de l'agent** : vous ne pouvez créer une réplique d'agent que pour un agent principal ayant le statut `Running`.
## Étape 1 (facultative) : Créer un nouvel agent principal
### Créer un nouvel agent principal
1. Connectez-vous à la [console Amazon MQ](https://console.aws.amazon.com/amazon-mq/).
1. Sur la page Agents de la console Amazon MQ, choisissez **Créer les agents**.
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. Pour **Mode de déploiement**, choisissez **Déploiement actif/en veille pour une haute disponibilité**. Un **déploiement actif/en veille pour une haute disponibilité** est composé de deux agents répartis dans deux zones de disponibilité différentes, configurés en une paire redondante. Ces agents communiquent de manière synchrone avec votre application et avec Amazon EFS. Pour de plus amples informations, veuillez consulter [Options de déploiement pour Amazon MQ pour les courtiers ActiveMQ](amazon-mq-broker-architecture.md).
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.
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.
La barre d'éclair verte en haut de la page confirme qu'Amazon MQ est en train de créer l'agent de répliques dans la région de restauration. Vous pouvez également voir le rôle CRDR et le statut RPO de vos agents. Pour désactiver les colonnes Rôle CRDR et État du RPO, choisissez l'icône en forme d'engrenage dans le coin supérieur droit de la table **Agents**. Ensuite, sur la page **Préférences**, désactivez Rôle CRDR ou État du RPO.
## Étape 2 : Créer une réplique d'un agent existant
1. Sur la page Agents de la console Amazon MQ, choisissez **Créer un agent de réplica**.
1. Sur la page **Choisir l'agent principal**, sélectionnez un agent existant à utiliser comme agent principal de réplication CRDR. Ensuite, choisissez **Suivant**.
1. Sur la page **Configurer l'agent de répliques**, utilisez le menu déroulant pour choisir la région de répliques.
1. Dans la section **Utilisateur de la console ActiveMQ pour l'agent de répliques**, fournissez un **Nom d'utilisateur** et un **Mot de passe** pour l'utilisateur de la console d'agent de répliques. 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. Dans la section **Utilisateur de réplication des données pour établir un pont entre les agents**, fournissez un **Nom d'utilisateur** et un **Mot de passe** pour l'utilisateur qui accèdera à la fois à l'agent principal et à l'agent de répliques. 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.
Configurez tous les paramètres supplémentaires. Ensuite, choisissez **Suivant**.
1. Sur la page **Vérifier et créer**, passez en revue les détails de l'agent de répliques, puis choisissez **Créer un agent de réplica**.
1. Ensuite, redémarrez l'agent principal. Cela redémarrera également l'agent de répliques. Pour obtenir des instructions sur le redémarrage de votre agent, consultez [Redémarrage d'un agent Amazon MQ](amazon-mq-rebooting-broker.md).
Pour plus d'informations sur la configuration de paramètres supplémentaires pour votre agent ActiveMQ, consultez [Mise en route : création et connexion à un courtier ActiveMQ](getting-started-activemq.md).
# Suppression d'un courtier de réplication de données entre régions Amazon MQ
Pour supprimer un courtier CRDR (Inter-Region Data Replication) principal ou répliqué, vous devez d'abord dissocier puis redémarrer les courtiers. Les instructions suivantes indiquent comment dissocier et redémarrer les courtiers à l'aide de la console AWS de gestion.
1. Sur la page **Agents**, sélectionnez l'agent CRDR que vous souhaitez dissocier, puis choisissez **Modifier**.
1. Sur la page **Modifier** de l'agent, dans la section **Réplication des données**, choisissez **Dissocier les agents**.
1. Entrez « confirmer » dans la fenêtre contextuelle pour confirmer votre choix. Choisissez ensuite **Dissocier les agents**.
1. Ensuite, redémarrez l'agent principal dissocié. Cela redémarrera également l'agent de répliques. Pour obtenir des instructions sur le redémarrage de votre agent, consultez [Redémarrage d'un agent Amazon MQ](amazon-mq-rebooting-broker.md). Après le redémarrage de l'agent principal, les deux agents sont dissociés et peuvent être supprimés individuellement. Pour supprimer votre agent, consultez [Suppression d'un agent Amazon MQ](amazon-mq-deleting-broker.md).
# Initier un basculement ou un basculement pour promouvoir le rôle de courtier principal d'Amazon MQ en tant que courtier principal
Vous pouvez déclencher une commutation ou un basculement lorsque vous voulez promouvoir l'agent de répliques au rôle d'agent principal. Lorsque vous promouvez l'agent de répliques, l'agent principal est rétrogradé au rôle d'agent de répliques.
Une **commutation** privilégie la cohérence par rapport à la disponibilité. Les agents ont la garantie d'avoir un état identique à la fin de cette opération de basculement. Lors d'une commutation, il peut y avoir une période pendant laquelle aucun agent n'est disponible pour les connexions client, alors que la cohérence entre agents est établie. Les deux agents auront le même état au moment de la promotion de la réplique. La réussite de la commutation dépend de la santé des deux régions et du réseau entre régions.
Un **basculement** privilégie la disponibilité par rapport à la cohérence. Il n'est pas garanti que les courtiers auront des états identiques à la fin de cette opération. Lors d'un basculement, l'agent de répliques est assuré de devenir immédiatement disponible pour traiter le trafic client, sans attendre que des données de réplication soient synchronisées ou que le serveur principal reçoive le signal d'arrêt. La réussite du basculement ne dépend ni de la santé de la région principale d'origine ni du réseau entre régions.
Le schéma suivant illustre une commutation dans laquelle aucun agent n'accepte les connexions client alors que la file d'attente de réplication est vidée et que les états des agents sont synchronisés. Dans ce processus, le client du VPC du courtier principal n'est pas en mesure de produire d'autres changements d'état pendant que l'opération est en cours, et le courtier principal est rétrogradé au rang de réplique. Lorsque la file d'attente de réplication est vidée et que les deux agents atteignent un état identique, le client du VPC de l'agent de répliques ne peut pas se connecter à l'agent de répliques tant que l'opération de basculement n'est pas terminée, et l'agent de répliques est promu au rang d'agent principal.
![\[Diagram showing broker switchover process between us-east-1 and us-west-2 regions with replication traffic.\]](http://docs.aws.amazon.com/fr_fr/amazon-mq/latest/developer-guide/images/planned-failover-process.png)
Le schéma suivant illustre le statut des agents une fois le processus de commutation terminé. L'agent de répliques d'origine a désormais été promu au rôle d'agent principal et il accepte les connexions client. Le client peut produire et consommer les données provenant de l'agent.
![\[Diagram showing broker status after switchover, with primary broker in us-west-2 and replica in us-east-1.\]](http://docs.aws.amazon.com/fr_fr/amazon-mq/latest/developer-guide/images/finished-failover-process.png)
## Promotion de l'agent de répliques à l'aide de la console
Pour promouvoir l'agent de répliques par le biais de la commutation ou du basculement, procédez comme suit dans la console Amazon MQ.
**Note**
Vous ne pouvez pas déclencher la commutation ou le basculement sur un agent principal.
1. Passez à la région de votre agent de répliques. Sur votre table Agents, sélectionnez l'agent de répliques existant que vous allez promouvoir au rang d'agent principal.
1. Sur la page **Détails de l'agent**, procédez comme suit :
1. Sélectionnez **Promouvoir la réplique**.
1. Dans la fenêtre contextuelle, choisissez *Commutation* ou *Basculement*.
1. Tapez « confirm » dans la zone de texte pour confirmer votre choix.
1. Choisissez **Confirmer**.
Après avoir lancé le basculement, le statut de l'agent passe à *Basculement en cours*. La barre de progression bleue en haut de la page Agents devient verte lorsque le basculement est terminé.
**Note**
La configuration est uniquement répliquée au moment de la création de l'agent de répliques. Aucune mise à jour ultérieure n'est répliquée.
# Mesures de réplication de données entre régions sur Amazon CloudWatch
La fonctionnalité de réplication de données entre régions d'Amazon MQ pour ActiveMQ fournit des métriques permettant de maintenir la fiabilité, la disponibilité et les performances de vos agents principaux et de répliques. Au cours du processus de réplication, un agent de répliques situé dans une région secondaire reçoit des données répliquées de manière asynchrone de la part de l'agent principal situé dans la région principale. Si l'agent principal situé dans la région principale échoue, vous pouvez promouvoir l'agent de répliques situé dans la région secondaire au rang d'agent principal en lançant une commutation ou un basculement. Pour obtenir des instructions sur l'affichage des statistiques sur Amazon CloudWatch, consultez[Accès aux CloudWatch métriques pour Amazon MQ](amazon-mq-accessing-metrics.md).
## Horodatages de réplication CRDR
Les horodatages suivants décrivent le mode de calcul des métriques trouvées sur Amazon CloudWatch . Le processus de réplication des données comporte cinq horodatages :
+ Heure d'observation actuelle (TCO) : l'instant présent dans le temps.
+ Heure de création (TC) : l'instant où un événement a été créé dans la file d'attente de réplication par l'agent principal. Disponible à la fois pour les agents principaux et les agents de répliques.
+ Heure de livraison (TD) : l'instant où un événement a été transmis avec succès à l'agent de répliques. Disponible uniquement sur les agents de répliques.
+ Heure de traitement (TP) : l'instant où un événement a été traité avec succès par l'agent de répliques. Disponible uniquement sur les agents de répliques.
+ Heure d'accusé de réception (TA) : l'instant où un événement a été reconnu avec succès par l'agent principal. Disponible uniquement sur les agents principaux.
## Estimez les performances de basculement et de basculement à l'aide des métriques CRDR CloudWatch
Amazon MQ active les mesures pour votre agent par défaut. Vous pouvez consulter les statistiques de votre courtier en accédant à la CloudWatch console Amazon ou en utilisant l' CloudWatch API. Les métriques suivantes sont utiles pour comprendre les performances de réplication et de commutation/basculement de vos agents CRDR :
| Métrique Amazon MQ CloudWatch | Raison de l'utilisation de la réplication CRDR |
| --- | --- |
| TotalReplicationLag | Temps estimé entre TA et TC du dernier événement non reconnu sur l'agent principal. |
| ReplicationLag | Temps estimé entre TP et TC du dernier événement non reconnu sur l'agent de répliques. |
| PrimaryWaitTime | Temps estimé entre TCO et TC du dernier événement traité sur l'agent principal. |
| ReplicaWaitTime | Temps estimé entre TCO et TP du dernier événement traité sur l'agent de répliques. |
| QueueSize | Nombre total d'événements non reconnus dans la file d'attente de réplication sur l'agent principal. |
`TotalReplicationLag` et `ReplicationLag` décrivent la réplication différée entre l'agent principal et l'agent de répliques. Ces deux métriques peuvent également être utilisées pour estimer le temps jusqu'à la fin de l'opération de commutation ou de basculement en cours.
`PrimaryWaitTime` et `ReplicaWaitTime` peuvent être utilisés pour identifier les problèmes en cours liés au processus de réplication. Si la valeur de cette métrique augmente constamment, cela peut indiquer que le processus de réplication est dégradé ou suspendu. La réplication peut être lente en raison de problèmes tels que le partitionnement du réseau, le démarrage de l'agent et la lenteur de la restauration.