Restaurer un cluster AlloyDB à partir d'un coffre-fort de sauvegarde

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Restaurer un cluster AlloyDB à partir d'une sauvegarde dans un coffre-fort

Pour restaurer un cluster AlloyDB pour PostgreSQL à partir d'une sauvegarde dans un coffre-fort, suivez les instructions ci-dessous :

  1. Restaurez la sauvegarde dans un nouveau cluster Backup and DR Service.

    Console

    1. Dans la console Google Cloud , accédez à la page Sauvegardes dans le coffre-fort.

      • L'utilisateur final doit disposer du rôle roles/alloydb.admin dans le projet où se trouve le cluster AlloyDB cible.
      • L'utilisateur final doit disposer du rôle roles/backupdr.restoreUser dans le projet où se trouve la sauvegarde source.

      Accéder aux sauvegardes stockées dans un vault

      La page Sauvegardes mises en coffre ne liste que les ressources de données auxquelles des plans de sauvegarde ont été appliqués et dont les sauvegardes sont stockées dans un coffre de sauvegarde au sein de ce projet.

    2. Sélectionnez la sauvegarde que vous souhaitez restaurer. Sur la page d'informations de la sauvegarde ou dans le menu , sélectionnez Restaurer.

      La page Restaurer une sauvegarde s'affiche. Vous y sélectionnez les options de restauration suivantes :

      • Le champ Type de ressource est prérempli avec AlloyDB.
      • Dans Nom de la ressource, sélectionnez le cluster AlloyDB à restaurer.
      • Lorsque vous cliquez sur Sauvegarder, un volet s'ouvre et affiche toutes les sauvegardes disponibles. Sélectionnez la sauvegarde spécifique à restaurer.
      • Pour Choisir la destination de la restauration, sélectionnez le projet dans lequel vous souhaitez restaurer le cluster AlloyDB.
    3. Cliquez sur Continuer.

    4. La page suivante affiche les détails de la restauration jusqu'à présent et vous invite à configurer un nouveau cluster. Cela crée un cluster AlloyDB basé sur la configuration stockée dans votre sauvegarde. Vous pouvez personnaliser le cluster une fois la restauration terminée. Indiquez un nouvel ID de cluster en utilisant des lettres minuscules, des chiffres et des traits d'union. Commencez par une lettre.

    5. Choisissez une méthode de connexion privée : Il existe deux méthodes pour connecter des services dans des réseaux VPC hébergés par Google Cloud ou par des tiers, sans attribuer d'adresses IP externes :

      • Accès aux services privés : attribue le cluster à un seul réseau VPC à l'aide d'une connexion d'appairage. Utilisez cette option pour vous connecter à des servicesGoogle Cloud et tiers spécifiques sur le même réseau VPC que le cluster AlloyDB. Cela nécessite des API supplémentaires.
      • Private Service Connect : permet d'accéder au cluster à partir d'un ou de plusieurs réseaux VPC à l'aide de listes d'autorisation et de points de terminaison Private Service Connect.

    gcloud

    gcloud beta alloydb clusters restore RESTORED_CLUSTER_ID \
        --project=WORKLOAD_PROJECT_ID \
        --region=REGION \
        --backupdr-backup=BACKUP_NAME
    

    Remplacez les éléments suivants :

    • RESTORED_CLUSTER_ID : ID du nouveau cluster AlloyDB que vous restaurez.
    • WORKLOAD_PROJECT_ID : ID du projet dans lequel vous souhaitez restaurer le cluster AlloyDB.
    • REGION : région Google Cloud dans laquelle vous souhaitez restaurer le cluster AlloyDB.
    • BACKUP_NAME : nom de la sauvegarde que vous souhaitez restaurer.
  2. Une fois que Backup and DR a terminé de créer le cluster, créez une instance principale pour celui-ci.

    Lorsque vous créez l'instance principale, vous devez spécifier sa configuration, y compris sa taille et ses indicateurs. Backup and DR ne stocke pas la configuration de l'instance dans la sauvegarde. Notez que la configuration ne doit pas nécessairement correspondre exactement à celle de l'instance principale d'origine.

    Une fois que Backup and DR a terminé de créer l'instance, vous pouvez l'utiliser pour accéder à vos données restaurées.

  3. Terminez la configuration du nouveau cluster en configurant les instances de pool de lecture, si nécessaire.

Restaurer un cluster AlloyDB à un moment précis

  1. Pour restaurer un cluster AlloyDB pour PostgreSQL à un moment précis, suivez ces instructions :

    Console

    1. Dans la console Google Cloud , accédez à la page Sauvegardes dans le coffre-fort.

      • L'utilisateur final a besoin des éléments suivants :

      roles/alloydb.admin dans le projet où se trouve le cluster AlloyDB cible.

      roles/backupdr.restoreUser dans le projet où se trouve la sauvegarde source.

      Accéder aux sauvegardes stockées dans un vault

      La page Sauvegardes mises en coffre ne liste que les ressources de données auxquelles des plans de sauvegarde ont été appliqués et dont les sauvegardes sont stockées dans un coffre de sauvegarde au sein de ce projet.

    2. En haut de la liste des sauvegardes, sélectionnez Restaurer à partir d'un point dans le temps.

      Le volet Restaurer à un moment précis sur un nouveau cluster s'affiche. C'est là que vous sélectionnez le point dans le temps à restaurer et les détails du nouveau cluster que vous allez créer :

      • Choisir un moment précis : saisissez un moment cible dans la période de récupération de ce cluster à partir duquel restaurer les données du cluster.

      • Configurer un nouveau cluster : cette option crée un cluster AlloyDB basé sur la configuration stockée dans votre sauvegarde. Vous pouvez personnaliser le cluster une fois la restauration terminée.

      Indiquez un nouvel ID de cluster en utilisant des lettres minuscules, des chiffres et des traits d'union. Commencez par une lettre.

    3. Choisissez une méthode de connexion privée :

      Il existe deux méthodes pour connecter des services sur Google Cloud ou sur des réseaux VPC hébergés par des tiers sans attribuer d'adresses IP externes :

      • Accès aux services privés : attribue le cluster à un seul réseau VPC à l'aide d'une connexion d'appairage. Utilisez cette option pour vous connecter à des servicesGoogle Cloud et tiers spécifiques sur le même réseau VPC que le cluster AlloyDB. Cela nécessite des API supplémentaires.

      • Private Service Connect : permet d'accéder au cluster à partir d'un ou de plusieurs réseaux VPC à l'aide de listes d'autorisation et de points de terminaison Private Service Connect.

    gcloud

    1. Restaurez la sauvegarde dans un nouveau cluster Backup and DR Service. Il s'agit d'un processus en deux étapes.

      Vous devez d'abord trouver l'ID de la source de données :

      gcloud backup-dr data-source-references fetch-for-resource-type alloydb.googleapis.com/Cluster \
          --location=REGION \
          --project=WORKLOAD_PROJECT_ID \
          --filter='dataSourceGcpResourceInfo.gcp_resourcename="projects/WORKLOAD_PROJECT_NUMBER/locations/REGION/clusters/CLUSTER_NAME'
      

      Vous effectuez ensuite la restauration à un moment précis.

    2. Pour restaurer le cluster, utilisez l'ID de source de données dans le script suivant :

        gcloud beta alloydb clusters restore RESTORED_CLUSTER_ID \
          --project=WORKLOAD_PROJECT_ID \
          --region=REGION \
          --backupdr-data-source=projects/VAULT_PROJECT_ID/locations/REGION/backupVaults/BV_ID/dataSources/DS_ID \
          --point-in-time=POINT_IN_TIME
      

      Remplacez les éléments suivants :

      • WORKLOAD_PROJECT_ID : ID du projet dans lequel vous souhaitez restaurer le cluster AlloyDB.
      • REGION : région Google Cloud dans laquelle vous souhaitez restaurer le cluster AlloyDB.
      • RESTORED_CLUSTER_ID : ID du nouveau cluster AlloyDB que vous restaurez.
      • VAULT_PROJECT_ID : ID du projet contenant le coffre-fort de sauvegarde.
      • BV_ID : ID du coffre-fort de sauvegarde.
      • DS_ID : ID de la source de données.
      • POINT_IN_TIME : point précis dans le temps auquel vous souhaitez restaurer le cluster. Exemple de valeur : "2025-10-10T10:16:10Z"
  2. Une fois que Backup and DR a terminé de créer le cluster, créez une instance principale pour celui-ci.

    Lorsque vous créez l'instance principale, vous devez spécifier sa configuration, y compris sa taille et ses indicateurs. Backup and DR ne stocke pas la configuration de l'instance dans la sauvegarde. Notez que la configuration ne doit pas nécessairement correspondre exactement à celle de l'instance principale d'origine.

    Une fois que Backup and DR a terminé de créer l'instance, vous pouvez l'utiliser pour accéder à vos données restaurées.

  3. Terminez la configuration du nouveau cluster en configurant les instances de pool de lecture, si nécessaire.

Lister les sauvegardes dans le coffre de sauvegarde

Répertoriez les sauvegardes et sélectionnez celle à restaurer. Vous pouvez trouver l'ID de la source de données, puis lister toutes les sauvegardes de la source de données à l'aide des commandes suivantes :

      # Find the data source id
      gcloud backup-dr data-source-references fetch-for-resource-type alloydb.googleapis.com/Cluster \
        --location=REGION \
        --project=WORKLOAD_PROJECT_ID \
        --filter='dataSourceGcpResourceInfo.gcp_resourcename="projects/WORKLOAD_PROJECT_NUMBER/locations/REGION/clusters/CLUSTER_NAME "'

      # List backups
      gcloud backup-dr backups list \
        --project=VAULT_PROJECT_ID \
        --location=REGION \
        --backup-vault=BV_ID \
        --data-source='projects/VAULT_PROJECT_ID/locations/REGION/backupVaults/BV_ID/dataSources/DS_ID'

Remplacez les éléments suivants :

  • REGION : la région Google Cloud .
  • WORKLOAD_PROJECT_ID : ID du projet dans lequel se trouve votre cluster AlloyDB.
  • WORKLOAD_PROJECT_NUMBER : numéro du projet dans lequel se trouve votre cluster AlloyDB.
  • CLUSTER_NAME : nom de votre cluster AlloyDB.
  • VAULT_PROJECT_ID : ID du projet contenant le coffre-fort de sauvegarde.
  • BV_ID : ID du coffre-fort de sauvegarde.
  • DS_ID : ID de la source de données.