Utiliser la réplication entre centres de données

Sélectionnez une version de la documentation :

Cette page explique comment utiliser la réplication entre centres de données en créant et en utilisant des clusters de bases de données secondaires dans Kubernetes.

Pour une présentation conceptuelle de la réplication entre centres de données, consultez À propos de la réplication entre centres de données.

Avant de commencer

  • Vérifiez que vous disposez d'une connectivité réseau fiable et à faible latence entre les centres de données principal et secondaire, ce qui est essentiel pour que la réplication entre centres de données fonctionne efficacement.
  • Installez la dernière version de l'opérateur AlloyDB Omni pour déployer AlloyDB Omni sur un cluster Kubernetes dans le centre de données principal et sur un cluster Kubernetes dans le centre de données secondaire. La réplication entre centres de données est compatible avec l'opérateur AlloyDB Omni version 1.5.0 et ultérieure.
  • Créez un cluster de bases de données AlloyDB Omni sur le cluster Kubernetes du centre de données principal.
  • Assurez-vous que les serveurs de base de données principal et de secours de votre cluster de bases de données principal disposent d'un espace de journalisation WAL (Write-Ahead Logging) suffisant pour accueillir les fichiers WAL requis pour la réplication vers le cluster secondaire. Toutes les données qui ne sont pas encore répliquées sur le cluster secondaire sont stockées dans le cluster principal sous forme de fichiers WAL. En fonction de la vitesse de connexion entre les clusters principal et secondaire, vous aurez peut-être besoin d'espace disque supplémentaire à cette fin.
  • Tenez compte des informations suivantes concernant les instances de secours à haute disponibilité de la base de données secondaire (preview) : si la version de l'opérateur AlloyDB Omni et la version de l'agent du plan de contrôle sont 1.7.0 ou ultérieures, le cluster de bases de données secondaire peut prendre en charge les instances de secours à haute disponibilité.

    Contrairement aux instances de secours à haute disponibilité du cluster de bases de données principal, les instances de secours à haute disponibilité du cluster de bases de données secondaire sont asynchrones jusqu'à ce que le cluster de bases de données secondaire soit promu en base de données principale. Les instances de secours de haute disponibilité deviennent automatiquement synchrones ou asynchrones si le rôle du cluster de bases de données est modifié lors d'une commutation.

Créer un cluster de bases de données secondaire

Pour créer un cluster de bases de données secondaire AlloyDB Omni et activer la réplication à partir de votre cluster de bases de données principal, procédez comme suit :

  1. Vérifiez que la connectivité externe est activée sur votre cluster de bases de données principal AlloyDB Omni. Si la connectivité externe n'est pas activée, ajoutez ce qui suit à la section "spec" du fichier manifeste du cluster de bases de données :

    ...
    spec:
      ...
      allowExternalIncomingTraffic: true
     
  2. Pour utiliser la réplication entre centres de données avec un cluster de bases de données principal sur lequel la haute disponibilité est activée, vérifiez que le champ replayReplicationSlotsOnStandbys est activé sur le cluster de bases de données principal :

    ...
    spec:
      ...
      availability:
        ...
        replayReplicationSlotsOnStandbys: true
     

    L'activation de ce champ, ainsi que du champ logReplicationSlots expliqué à l'étape suivante, synchronise l'emplacement de réplication utilisé par le cluster de base de données secondaire avec toutes les instances de secours à haute disponibilité. Cette configuration permet à la nouvelle instance principale de haute disponibilité de conserver tous les fichiers de journalisation WAL (Write-Ahead Logging) qui n'ont pas encore été utilisés par le cluster de base de données secondaire après un basculement ou une commutation, ce qui permet au cluster de base de données secondaire de reprendre la réplication sans interruption.

  3. Pour activer la réplication sur votre cluster de bases de données principal, appliquez un fichier manifeste semblable au suivant à votre cluster Kubernetes sur le centre de données principal :

    apiVersion: v1
    kind: Secret
    metadata:
      name: ha-rep-pw-DB_CLUSTER_NAME
      namespace: DB_CLUSTER_NAMESPACE
    type: Opaque
    data:
      rep-user-pw: "ENCODED_PASSWORD"
    ---
    apiVersion: alloydbomni.dbadmin.goog/v1
    kind: Replication
    metadata:
      name: REPLICATION_NAME
      namespace: DB_CLUSTER_NAMESPACE
    spec:
      dbcluster:
        name: DB_CLUSTER_NAME
      upstream:
        password:
          name: ha-rep-pw-DB_CLUSTER_NAME
        logReplicationSlot: true

    Remplacez les éléments suivants :

    • DB_CLUSTER_NAME : nom du cluster de bases de données, par exemple dbc-1.
    • ENCODED_PASSWORD : mot de passe de l'utilisateur de la base de données à utiliser pour la réplication à partir de bases de données secondaires, encodé sous forme de chaîne base64 (par exemple, Q2hhbmdlTWUxMjM= for ChangeMe123). La valeur par défaut est alloydbreplica.
    • REPLICATION_NAME : nom de la réplication, par exemple replication-1.
    • LOG_REPLICATION_SLOT : consigne les données de l'emplacement de réplication dans les fichiers WAL. Pour activer cette option, définissez sa valeur sur true. La valeur par défaut est false.

    Nous vous recommandons d'activer l'option logReplicationSlot avec un cluster de base de données principal pour lequel la haute disponibilité est activée afin de vous assurer que la réplication peut continuer à fonctionner après un basculement ou une commutation.

    Attendez que l'état de la réplication soit prêt.

  4. Pour obtenir les informations de connexion en amont utilisées pour configurer la réplication sur le cluster de bases de données secondaire, exécutez la commande suivante :

    kubectl get replication REPLICATION_NAME
    kubectl get replication REPLICATION_NAME -o json | jq .status.upstream

    Voici un exemple de résultat :

      {
        "host": "35.230.32.36",
        "password": {
          "name": "ha-rep-pw-dbc-1"
        },
        "port": 5432,
        "replicationSlotName": "dbc_1_replication_1",
        "username": "alloydbreplica"
      }
      
  5. Notez le résultat, car vous en aurez besoin pour activer la réplication sur le cluster de base de données secondaire à l'étape suivante.
  6. Créez un cluster AlloyDB Omni sur votre cluster Kubernetes dans le centre de données secondaire en utilisant une configuration identique à celle de votre cluster de bases de données principal.
  7. Vérifier que la connectivité externe est activée sur votre cluster de bases de données secondaire AlloyDB Omni
  8. Si la connectivité externe n'est pas activée, ajoutez ce qui suit à la section "spec" de son fichier manifeste :

    ...
    spec:
      ...
      allowExternalIncomingTraffic: true
  9. Pour activer la réplication sur votre cluster de base de données secondaire, appliquez un fichier manifeste semblable au suivant à votre cluster Kubernetes sur le centre de données secondaire :
    apiVersion: v1
    kind: Secret
    metadata:
      name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME
      namespace: SECONDARY_DB_CLUSTER_NAMESPACE
    type: Opaque
    data:
      rep-user-pw: "ENCODED_PASSWORD"
    ---
    apiVersion: alloydbomni.dbadmin.goog/v1
    kind: Replication
    metadata:
      name: SECONDARY_REPLICATION_NAME
      namespace: SECONDARY_DB_CLUSTER_NAMESPACE
    spec:
      dbcluster:
        name: SECONDARY_DB_CLUSTER_NAME
      downstream:
        host: PRIMARY_HOST
        port: PRIMARY_PORT
        username: alloydbreplica
        password:
          name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME
        replicationSlotName: PRIMARY_REPLICATION_SLOT
        control: setup

    Remplacez les éléments suivants :

    • SECONDARY_DB_CLUSTER_NAME : nom du cluster de bases de données secondaire, par exemple dbc-2.
    • ENCODED_PASSWORD : mot de passe de l'utilisateur de la base de données à utiliser pour la réplication à partir du cluster de bases de données principal, encodé sous forme de chaîne base64 (par exemple, Q2hhbmdlTWUxMjM= for ChangeMe123). La valeur par défaut est alloydbreplica.
    • SECONDARY_REPLICATION_NAME : nom de la réplication, par exemple "replication-2".
    • PRIMARY_HOST : point de terminaison de connexion du cluster de base de données principal à partir du résultat de l'étape 4 auquel la base de données secondaire peut accéder pour la réplication.
    • PRIMARY_PORT : port de connexion du cluster de base de données principal à partir du résultat de l'étape 4 auquel la base de données secondaire peut accéder pour la réplication.
    • PRIMARY_REPLICATION_SLOT : nom de l'emplacement de réplication sur le cluster de base de données principal, issu du résultat de l'étape 4, que la base de données secondaire peut utiliser pour la réplication.

Afficher la réplication sur le cluster de bases de données secondaire

Pour afficher des informations détaillées sur un cluster de bases de données secondaire AlloyDB Omni et son état de réplication, exécutez les commandes suivantes :

kubectl get dbcluster SECONDARY_DB_CLUSTER_NAME
kubectl get replication SECONDARY_REPLICATION_NAME

Une fois que le cluster de base de données secondaire est correctement configuré et qu'il dispose d'une réplication en flux continu à partir du cluster de base de données principal, l'état de la réplication est à la fois "Prêt" et "Opérationnel".

Promouvoir un cluster de bases de données secondaire

Lorsque vous promouvez un cluster de bases de données secondaire, vous devez d'abord vérifier qu'il a appliqué toutes les transactions reçues du cluster de bases de données principal.

  1. Vérifiez que l'état de réplication du cluster de base de données secondaire est à la fois prêt et opérationnel :
    kubectl get replication SECONDARY_REPLICATION_NAME
  2. Arrêtez toutes les opérations d'écriture dans le cluster de base de données principal. Exécutez un point de contrôle sur le cluster de bases de données principal, puis exécutez la requête suivante sur votre cluster de bases de données principal pour vérifier le délai de réplication de la base de données secondaire. Vérifiez que le résultat affiche un décalage minimal.
    1. Exécutez un point de contrôle pour vider la mémoire sur le disque.
      psql -h PRIMARY_HOST -U postgres -d postgres -c 'CHECKPOINT;'
    2. Vérifiez le délai de réplication. Une valeur de décalage de 0 est optimale. Si le décalage est supérieur à 0, vous pouvez toujours promouvoir le cluster de bases de données secondaire. Toutefois, vous risquez de perdre les transactions récentes déjà validées sur le cluster de bases de données principal.
      psql -h PRIMARY_HOST -U postgres -d postgres -c 'SELECT application_name, pg_wal_lsn_diff(pg_current_wal_lsn(), replay_lsn) AS replay_lag FROM pg_stat_replication;'

  3. Promouvez un cluster de bases de données secondaire en cluster de bases de données principal en remplaçant par promote la valeur du champ control du fichier manifeste de réplication de votre cluster de bases de données secondaire. Ensuite, appliquez le fichier manifeste de réplication mis à jour sur votre cluster Kubernetes dans le centre de données secondaire.

    apiVersion: v1
    kind: Secret
    metadata:
      name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME
      namespace: SECONDARY_DB_CLUSTER_NAMESPACE
    type: Opaque
    data:
      rep-user-pw: "ENCODED_PASSWORD"
    ---
    apiVersion: alloydbomni.dbadmin.goog/v1
    kind: Replication
    metadata:
      name: SECONDARY_REPLICATION_NAME
      namespace: SECONDARY_DB_CLUSTER_NAMESPACE
    spec:
      dbcluster:
        name: SECONDARY_DB_CLUSTER_NAME
      downstream:
        host: PRIMARY_HOST
        port: PRIMARY_PORT
        username: alloydbreplica
        password:
          name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME
        replicationSlotName: PRIMARY_REPLICATION_SLOT
        control: promote

Effectuer une commutation

Avant d'effectuer une commutation, vérifiez que les clusters de bases de données principal et secondaire des deux centres de données sont en ligne et en bon état.

Pour maintenir la cohérence des données entre vos clusters de bases de données principal et secondaire et effectuer une commutation, procédez comme suit :

  1. Vérifiez que l'état de réplication du cluster de base de données secondaire est à la fois prêt et opérationnel :
    kubectl get replication SECONDARY_REPLICATION_NAME
  2. Arrêtez toutes les écritures dans le cluster de bases de données principal, puis procédez comme suit sur votre cluster de bases de données principal :
    1. Exécutez un point de contrôle pour vider la mémoire sur le disque :
      psql -h PRIMARY_HOST -U postgres -d postgres -c 'CHECKPOINT;'
    2. Vérifiez le délai de réplication du cluster de bases de données secondaire et confirmez que le résultat affiche une valeur de délai de 0 :
      psql -h PRIMARY_HOST -U postgres -d postgres -c 'SELECT application_name, pg_wal_lsn_diff(pg_current_wal_lsn(), replay_lsn) AS replay_lag FROM pg_stat_replication;'
  3. Pour promouvoir le cluster de bases de données secondaire en cluster de bases de données principal et convertir l'ancien cluster de bases de données principal en cluster de bases de données secondaire, procédez comme suit :

    1. Pour convertir votre cluster de bases de données secondaire AlloyDB Omni en cluster de bases de données principal, mettez à jour son fichier manifeste de réplication sur votre cluster Kubernetes dans le centre de données secondaire comme suit :

      apiVersion: v1
      kind: Secret
      metadata:
        name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME
        namespace: SECONDARY_DB_CLUSTER_NAMESPACE
      type: Opaque
      data:
        rep-user-pw: "ENCODED_PASSWORD"
      ---
      apiVersion: alloydbomni.dbadmin.goog/v1
      kind: Replication
      metadata:
        name: SECONDARY_REPLICATION_NAME
        namespace: SECONDARY_DB_CLUSTER_NAMESPACE
      spec:
        dbcluster:
          name: SECONDARY_DB_CLUSTER_NAME
        upstream:
          password:
            name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME

      Remplacez SECONDARY_DB_CLUSTER_NAME par le nom de votre cluster de bases de données secondaire, par exemple dbc-2.

      Attendez que l'état de la réplication soit prêt.

    2. Pour obtenir les informations de connexion en amont pour la réplication, exécutez la commande suivante :

      kubectl get replication SECONDARY_REPLICATION_NAME
      kubectl get replication SECONDARY_REPLICATION_NAME -o json | jq .status.upstream

      Voici un exemple de résultat :

        {
          "host": "34.23.207.137",
          "password": {
            "name": "ha-rep-pw-dbc-2"
          },
          "port": 5432,
          "replicationSlotName": "dbc_2_replication_2",
          "username": "alloydbreplica"
        }
      
    3. Pour convertir votre cluster de bases de données principal AlloyDB Omni en cluster de bases de données secondaire, mettez à jour son fichier manifeste de réplication sur votre cluster Kubernetes dans le centre de données principal :

      apiVersion: v1
      kind: Secret
      metadata:
        name: ha-rep-pw-DB_CLUSTER_NAME
        namespace: DB_CLUSTER_NAMESPACE
      type: Opaque
      data:
        rep-user-pw: "ENCODED_PASSWORD"
      ---
      apiVersion: alloydbomni.dbadmin.goog/v1
      kind: Replication
      metadata:
        name: REPLICATION_NAME
        namespace: DB_CLUSTER_NAMESPACE
      spec:
        dbcluster:
          name: DB_CLUSTER_NAME
        downstream:
          host: SECONDARY_HOST
          port: SECONDARY_PORT
          username: alloydbreplica
          password:
            name: ha-rep-pw-DB_CLUSTER_NAME
          replicationSlotName: SECONDARY_REPLICATION_SLOT
          control: rewind

      Attendez que l'état de la réplication soit prêt et opérationnel.

    4. Vérifiez l'état de la réplication :

      kubectl get replication REPLICATION_NAME

Effectuer une reprise après sinistre non planifiée

Si votre centre de données principal ou votre cluster de bases de données principal devient indisponible de manière inattendue, vous pouvez effectuer un basculement de reprise après sinistre non planifié. Pour ce faire, promouvez le cluster de bases de données secondaire, puis reconfigurez l'ancien cluster de bases de données principal une fois qu'il est de nouveau en ligne :

  1. Promouvez votre cluster de bases de données secondaire AlloyDB Omni en cluster de bases de données principal. Mettez à jour le fichier manifeste de réplication du cluster de base de données secondaire sur votre cluster Kubernetes dans le centre de données secondaire, comme décrit à l'étape 3a de la section Effectuer une permutation.
  2. Une fois que le centre de données principal d'origine est disponible, convertissez l'ancien cluster de bases de données principal en un cluster de bases de données secondaire qui réplique les données à partir du nouveau cluster principal. Suivez les étapes 3b, 3c et 3d de la section Effectuer une commutation, en modifiant l'étape 3c. À l'étape 3c, définissez control: setup au lieu de control: rewind pour réinitialiser le cluster à partir du nouveau cluster principal. N'utilisez pas control: rewind, car l'ancien cluster de base de données principal peut contenir des modifications qui n'ont pas été synchronisées avant le basculement.