Gérer la réplication interrégion et la même région sur votre cluster Azure DocumentDB

Azure DocumentDB permet la diffusion en continu de données vers un cluster réplica dans une autre ou la même région Azure. Cette fonctionnalité offre une protection contre la récupération d’urgence entre régions et une extensibilité de lecture entre les régions et dans la même région. Ce document sert de guide rapide pour les développeurs qui souhaitent apprendre à gérer la réplication de leurs clusters.

Prerequisites

• Un abonnement Azure

  • Si vous n’avez pas d’abonnement Azure, créez un compte gratuit

Activer la réplication interrégionale ou dans la même région

Vous pouvez créer un cluster de réplication lors de la création d'un nouveau cluster ou à tout moment sur un cluster existant.

Création d’un cluster réplicaté lors du provisionnement d’un nouveau cluster

Pour activer la réplication sur un nouveau cluster lors de la création du cluster, procédez comme suit :

1. Suivez les étapes de démarrage de la création du cluster et suivez l’onglet Informations de base d’un nouveau cluster Azure DocumentDB.
2. (facultatif) Sélectionnez les paramètres d’accès réseau souhaités pour le cluster sous l’onglet Mise en réseau.
3. Sous l’onglet Distribution globale , sélectionnez Activer pour le réplica de cluster.
4. Fournissez un nom de cluster de réplica dans le champ Nom du réplica en lecture.
5. Sélectionnez une région dans Région du réplica en lecture. Le cluster de réplicas est hébergé dans la région Azure sélectionnée.
6. Sous l’onglet Vérifier + créer, passez en revue les détails de la configuration du cluster et sélectionnez Créer.

Création d’un cluster de réplica pour un cluster existant

Pour activer la réplication sur un nouveau cluster à tout moment après la création du cluster, procédez comme suit :

1. Suivez les étapes pour créer un cluster Azure DocumentDB.
2. Ignorez l’onglet Distribution mondiale. Cet onglet est utilisé pour créer un réplica de cluster pendant l’approvisionnement du cluster principal.
3. Une fois le cluster créé, dans la barre latérale du cluster, sous Paramètres, sélectionnez Distribution globale.
4. Sélectionnez Ajouter un nouveau réplica en lecture.
5. Fournissez un nom de cluster de réplica dans le champ Nom du réplica en lecture.
6. Sélectionnez une région dans Région du réplica en lecture. Le cluster de réplicas est hébergé dans la région Azure sélectionnée.
7. (facultatif) Sélectionnez clé gérée par le client dans la section Chiffrement des données pour activer le chiffrement des données avec une clé gérée par le client (CMK) sur le cluster de réplication. Suivez ensuite les étapes pour activer CMK.
8. Vérifiez votre sélection et sélectionnez le bouton Enregistrer pour confirmer la création du réplica.

Pour rendre le cluster réplica accessible pour les opérations de lecture, ajustez ses paramètres réseau en configurant des règles de pare-feu pour l’accès public ou en ajoutant des points de terminaison privés pour un accès privé et sécurisé.

Promouvoir une réplique

Pour promouvoir un réplica de cluster vers un cluster en lecture-écriture, procédez comme suit :

1. Sélectionnez le réplica de cluster que vous souhaitez promouvoir dans le portail.
2. Dans la barre latérale du cluster, sous Paramètres, sélectionnez Distribution globale.
3. Sur la page Distribution globale, sélectionnez Promouvoir.
4. Sur l’écran Promouvoir <nom du cluster>, vérifiez le nom du réplica du cluster, lisez le texte d’avertissement et sélectionnez Promouvoir.

Une fois le réplica de cluster promu, il devient un cluster accessible en lecture et accessible en écriture. Si la haute disponibilité est activée sur le cluster principal (lecture-écriture), elle doit être réactivée sur le cluster réplica après la promotion.

Vérifier le rôle de réplication du cluster et la région de réplication

Pour vérifier le rôle de réplication d’un cluster, procédez comme suit :

1. Sélectionnez un cluster Azure DocumentDB existant.
2. Sélectionnez la page Vue d’ensemble.
3. Vérifiez la valeur de la Région de lecture (sur le cluster principal) ou la Région d’écriture (sur le cluster réplica).

Si la valeur de la région de lecturen’est pas activée, ce cluster a la réplication désactivée.

Désactiver la réplication interrégion ou intrarégion

Pour désactiver la réplication, procédez comme suit :

1. Sélectionnez le cluster de réplicas Azure DocumentDB.
2. Sélectionnez Vue d’ensemble.
3. Vérifiez qu’il s’agit d’un réplica de cluster.
4. Dans le portail Azure, dans la page vue d’ensemble Vue d’ensemble du cluster réplica, sélectionnez Supprimer.
5. Sur l’écran Supprimer <nom du réplica>, lisez le texte d’avertissement et entrez le nom du cluster dans le champ Confirmer le nom du compte.
6. Sélectionnez Supprimer pour confirmer la suppression de la réplique.

Si vous devez supprimer les clusters et réplicas principaux, vous devez d’abord supprimer le cluster de réplicas.

Utiliser les chaînes de connexion

Vous pouvez vous connecter au réplica de cluster comme vous le feriez à un cluster en lecture-écriture standard. Suivez ces étapes pour obtenir les chaînes de connexion pour différents cas :

1. Sélectionnez le cluster principal ou sa réplique de cluster dans le portail.
2. Dans la barre latérale du cluster, sous Paramètres, sélectionnez Chaînes de connexion.
3. Copiez l’auto-chaîne de connexion pour le cluster actuellement sélectionné afin de vous connecter à ce cluster.
4. (facultatif, sur le cluster principal uniquement) Copiez la chaîne de connexion en lecture-écriture globale qui pointe toujours vers le cluster disponible pour les écritures.

Les auto-chaînes de connexion sont conservées après la promotion du réplica de cluster. Vous pouvez continuer à utiliser soit une chaîne simple soit une chaîne de connexion en lecture-écriture globale pour les opérations de lecture. Si vous utilisez une chaîne de connexion spécifique pour les opérations d’écriture, vous devez mettre à jour cette chaîne de connexion dans votre application pour qu'elle pointe vers le cluster de réplique promu, afin de continuer les opérations d'écriture dans la base de données une fois la promotion terminée.

Contenu connexe

• En savoir plus sur la réplication interrégion et la même région dans Azure DocumentDB
• Voir les limites et limitations de réplication
• Pour résoudre un problème de réplication, consultez ce guide de résolution des problèmes.
• En savoir plus sur la fiabilité dans Azure DocumentDB