Ce document explique comment restaurer un cluster AlloyDB à partir d'un coffre de sauvegarde à l'aide de la Google Cloud console ou de la gcloud CLI. Il décrit comment effectuer une restauration à partir d'une sauvegarde stockée dans un coffre ou une récupération à un moment précis.
Pour en savoir plus sur les fonctionnalités conceptuelles de Backup and DR, consultez la présentation de Backup and DR. Si vous souhaitez d'abord sauvegarder vos bases de données, consultez Sauvegarder des clusters AlloyDB dans un coffre de sauvegarde.
Options de reprise après sinistre pour vos clusters AlloyDB
Les sauvegardes stockées dans un coffre de sauvegarde sont indépendantes du cycle de vie et du projet du cluster source.
Vous pouvez restaurer des sauvegardes même si le projet de charge de travail d'origine contenant le cluster AlloyDB source est supprimé. En effet, les autorisations de déchiffrement nécessaires pour les sauvegardes chiffrées avec une clé CMEK sont ancrées à l'agent de service Backup and DR dans le projet du coffre de sauvegarde, et non dans le projet de charge de travail. Cela garantit que vos sauvegardes restent accessibles et restaurables tant que le coffre de sauvegarde et la clé du coffre Cloud Key Management Service sont intacts et que l'agent de service dispose des autorisations.
Avant de commencer
Avant de restaurer un cluster AlloyDB à partir d'une sauvegarde stockée dans un coffre, assurez-vous de disposer des rôles et autorisations requis.
Pour obtenir les autorisations nécessaires pour restaurer un cluster AlloyDB à partir d'une sauvegarde stockée dans un coffre, demandez à votre administrateur de vous accorder les rôles IAM suivants :
-
Pour créer la cible de restauration :
Administrateur AlloyDB (
roles/alloydb.admin) sur le projet où se trouve le cluster cible -
Pour lire la sauvegarde à partir du coffre :
Utilisateur de sauvegarde et de reprise après sinistre (
roles/backupdr.restoreUser) sur le projet où se trouve la sauvegarde source
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Ces rôles prédéfinis contiennent les autorisations requises pour restaurer un cluster AlloyDB à partir d'une sauvegarde stockée dans un coffre. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Les autorisations suivantes sont requises pour restaurer un cluster AlloyDB à partir d'une sauvegarde stockée dans un coffre :
-
Pour créer la cible de restauration :
alloydb.clusters.restore -
Pour lire la sauvegarde à partir du coffre :
-
backupdr.bvbackups.useReadOnlyForAlloydbCluster -
backupdr.bvdataSources.useReadOnlyForAlloydbCluster
-
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Rôles de l'agent de service et exigences concernant la version de la clé
Étant donné que les sauvegardes sont incrémentielles, une seule sauvegarde peut être chiffrée par plusieurs versions de clé Cloud Key Management Service de la clé du coffre si la clé a été alternée au fil du temps. Pour que l'opération de restauration réussisse, assurez-vous que les conditions préalables suivantes sont remplies :
Toutes les versions de clé Cloud Key Management Service de la clé du coffre utilisées pour une sauvegarde incrémentielle doivent exister.
L'agent de service Backup and DR du projet de coffre de sauvegarde doit disposer du rôle Chiffreur/Déchiffreur de clés cryptographiques Cloud KMS (
roles/cloudkms.cryptoKeyEncrypterDecrypter) sur la clé du coffre utilisée pour la sauvegarde.
Comportement de la clé KMS du cluster restauré
Si aucune clé CMEK spécifique n'est fournie lors du processus de restauration, le cluster restauré est chiffré par défaut par une Google-managed encryption key. Il n'est pas automatiquement chiffré par la clé du coffre ni par la clé du cluster source d'origine.
Si une clé CMEK est fournie lors de la configuration de la restauration, le cluster restauré est chiffré avec la clé nouvellement spécifiée.
Restaurer un cluster AlloyDB à partir d'une sauvegarde stockée dans un coffre
Pour restaurer un cluster AlloyDB pour PostgreSQL à partir d'une sauvegarde stockée dans un coffre, effectuez les tâches décrites dans les sections suivantes.
Restaurer la sauvegarde sur un nouveau cluster
Console
Dans la Google Cloud console, accédez à la page Vaulted backups (Sauvegardes stockées dans un coffre).
Sélectionnez la sauvegarde que vous souhaitez restaurer. Sur la page Backup details (Détails de la sauvegarde) de la sauvegarde ou dans le menu, sélectionnez Restore (Restaurer).
La page Restore a backup (Restaurer une sauvegarde) s'affiche. Le Type de ressource est prérempli avec
AlloyDB.Dans Nom de la ressource, sélectionnez le cluster AlloyDB à restaurer.
Cliquez sur Backup (Sauvegarde). Un volet s'affiche avec toutes les sauvegardes disponibles.
Sélectionnez la sauvegarde spécifique à restaurer.
Pour Choose the restore destination (Choisir la destination de restauration), sélectionnez le projet dans lequel vous souhaitez restaurer le cluster AlloyDB.
Cliquez sur Continue (Continuer).
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.
Fournissez un nouvel ID de cluster en utilisant des lettres minuscules, des chiffres et des traits d'union, en commençant par une lettre.
Choisissez une méthode de connexion privée. Il existe deux méthodes pour connecter des services sur Google Cloud des réseaux VPC hébergés parou 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 lorsque vous vous connectez à des services Google 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 depuis un ou 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: Google Cloud région dans laquelle vous souhaitez restaurer le cluster AlloyDB.BACKUP_NAME: nom de la sauvegarde que vous souhaitez restaurer.
Créer une instance principale
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 options. 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.
Configurer des instances de pool de lecture
Terminez la configuration du nouveau cluster en configurant des instances de pool de lecture, si nécessaire.
Restaurer un cluster AlloyDB à un moment précis
Pour restaurer un cluster AlloyDB pour PostgreSQL à un moment précis, effectuez les tâches décrites dans les sections suivantes.
Conditions requises
Pour que la restauration à un moment précis d'un cluster source chiffré avec une clé CMEK réussisse, la clé du cluster source et la clé du coffre doivent exister et être accessibles.
L'agent de service AlloyDB pour PostgreSQL du projet de charge de travail doit disposer du rôle Chiffreur/Déchiffreur de clés cryptographiques Cloud KMS (
roles/cloudkms.cryptoKeyEncrypterDecrypter) sur la clé du cluster source, et l'agent de service Backup and DR du projet de coffre de sauvegarde doit disposer du rôle Chiffreur/Déchiffreur de clés cryptographiques Cloud KMS (roles/cloudkms.cryptoKeyEncrypterDecrypter) sur la clé du coffre.
Restaurer la sauvegarde sur un nouveau cluster
Console
Dans la Google Cloud console, accédez à la page Vaulted backups (Sauvegardes stockées dans un coffre).
Accéder aux sauvegardes stockées dans un coffre
La page Vaulted backups (Sauvegardes stockées dans un coffre) ne répertorie 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.
En haut de la liste des sauvegardes, sélectionnez Restore from a point in time (Restaurer à partir d'un moment précis).
Le volet Restore from a point in time to a new cluster (Restaurer à partir d'un moment précis sur un nouveau cluster) s'affiche. Vous pouvez y sélectionner le moment précis à restaurer et les détails du nouveau cluster que vous allez créer.
Saisissez un moment cible dans la période de récupération de ce cluster à partir duquel restaurer les données du cluster.
Configurez 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.
Fournissez un nouvel ID de cluster en utilisant des lettres minuscules, des chiffres et des traits d'union, en commençant par une lettre.
Choisissez une méthode de connexion privée. Il existe deux méthodes pour connecter des services sur Google Cloud des réseaux VPC hébergés parou 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 lorsque vous vous connectez à des services Google 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 depuis un ou plusieurs réseaux VPC à l'aide de listes d'autorisation et de points de terminaison Private Service Connect.
gcloud
Recherchez l'ID de la source de données à l'aide de la commande suivante :
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'Restaurez le cluster à l'aide de l'ID de la source de données que vous avez trouvé à l'étape précédente :
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_TIMERemplacez les éléments suivants :
WORKLOAD_PROJECT_ID: ID du projet dans lequel vous souhaitez restaurer le cluster AlloyDB.REGION: Google Cloud région 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 de sauvegarde.BV_ID: ID du coffre de sauvegarde.DS_ID: ID de la source de données.POINT_IN_TIME: moment précis auquel vous souhaitez restaurer le cluster. Exemple de valeur :2025-10-10T10:16:10Z
Créer une instance principale
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 options. 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.
Configurer des instances de pool de lecture
Terminez la configuration du nouveau cluster en configurant des 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 à l'aide de la gcloud CLI :
Recherchez l'ID de la source de données à l'aide de la commande suivante :
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 "' ```Répertoriez les sauvegardes à l'aide de la commande suivante :
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 Google Cloud région.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 de sauvegarde.BV_ID: ID du coffre de sauvegarde.DS_ID: ID de la source de données.
Étape suivante
- Sauvegarder des clusters AlloyDB dans un coffre de sauvegarde
- Gérer les sources de données dans la Google Cloud console
- Gérer les sauvegardes dans la Google Cloud console