Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page explique comment créer et gérer des plans de sauvegarde pour les charges de travail de cluster dans Google Distributed Cloud (GDC) air-gapped.
Les plans de sauvegarde fournissent les fonctions de configuration, d'emplacement et de gestion d'une séquence de sauvegardes. Un plan de sauvegarde contient une configuration de sauvegarde, y compris le cluster source et la sélection des charges de travail à sauvegarder. Google recommande de fournir au moins un plan de sauvegarde pour chaque cluster.
Vous pouvez créer un ou plusieurs plans de sauvegarde pour chaque cluster. Vous pouvez partitionner les sauvegardes de votre cluster pour l'une des raisons suivantes :
Plutôt qu'une sauvegarde très volumineuse effectuée à un moment de la journée, vous préférez répartir plusieurs sauvegardes, plus petites, tout au long de la journée.
Vous souhaitez sauvegarder certaines parties de votre cluster plus souvent que d'autres (par exemple, des sauvegardes quotidiennes pour certains espaces de noms et des sauvegardes horaires pour d'autres).
Un même cluster ou une même machine virtuelle (VM) peuvent appartenir à un ou plusieurs plans de sauvegarde. Un plan de sauvegarde ne peut pas s'étendre sur plusieurs clusters. Toutefois, un même plan de sauvegarde peut capturer plusieurs VM si elles se trouvent dans le même cluster. Toutes les ressources de sauvegarde et de restauration doivent être associées à un nom de projet.
Avant de commencer
Pour créer un plan de sauvegarde, vous devez disposer des éléments suivants :
Rôle Identity and Access Management requis :
Administrateur de sauvegarde de cluster d'utilisateur : gère les ressources de sauvegarde telles que les plans de sauvegarde et de restauration dans les clusters d'utilisateur. Demandez à votre administrateur IAM de l'organisation de vous attribuer le rôle Administrateur des sauvegardes de clusters utilisateur (user-cluster-backup-admin). Pour en savoir plus, consultez Définitions des rôles.
Si vous êtes un opérateur d'application, demandez à votre administrateur disposant de droits d'administrateur de sauvegarde de cluster d'utilisateur de créer un plan de sauvegarde pour vous.
Créer un plan de sauvegarde
Nous vous recommandons de définir une planification Cron pour le plan de sauvegarde, afin que les sauvegardes soient créées automatiquement en fonction de cette planification. Vous pouvez également sauvegarder manuellement vos charges de travail. Pour en savoir plus, consultez Créer une sauvegarde manuelle.
Créez des plans de sauvegarde à l'aide de la console GDC ou de l'API.
Console
Connectez-vous à la console GDC.
Dans le menu de navigation, cliquez sur Sauvegarde pour les clusters.
Cliquez sur Créer un plan de sauvegarde.
Dans la section Détails du forfait, procédez comme suit, puis cliquez sur Continuer :
Dans la liste Cluster, sélectionnez le cluster à sauvegarder.
Dans la liste Projet, sélectionnez le projet.
Dans le champ Nom du plan de sauvegarde, saisissez le nom du plan de sauvegarde de votre choix.
(Facultatif) Dans Description du plan de sauvegarde, saisissez une description du plan de sauvegarde.
Dans le champ Dépôt de sauvegarde, sélectionnez un dépôt de sauvegarde. Les dépôts de sauvegarde sont un ensemble d'implémentations de stockage d'objets.
Cliquez sur Suivant.
Dans la section Champ d'application et chiffrement, procédez comme suit, puis cliquez sur Continuer :
Sélectionnez l'un des champs d'application suivants pour le plan de sauvegarde :
Cliquez sur Cluster complet pour sauvegarder toutes les ressources d'espace de noms dans la sauvegarde.
Cliquez sur Espaces de noms sélectionnés dans le cluster pour choisir les espaces de noms dans la sauvegarde à restaurer.
Cliquez sur Modifier l'espace de noms du cluster, puis sur Ajouter un espace de noms au cluster pour saisir un espace de noms.
Cliquez sur Applications protégées sélectionnées dans ce cluster pour ajouter des ressources en spécifiant l'espace de noms et le nom de l'application.
Cliquez sur Modifier les applications protégées, puis sur Ajouter une application protégée pour saisir un espace de noms et une application protégée.
Cliquez sur Inclure les secrets pour inclure les ressources Secret Kubernetes.
Cochez la case Inclure les données des volumes persistants si vous souhaitez que les données de volume soient conservées dans votre sauvegarde. Décochez cette case si vous souhaitez créer des volumes vides lors de la restauration.
Dans la section Planification et conservation, procédez comme suit, puis cliquez sur Continuer :
Pour définir une planification, saisissez une expression à l'aide de la syntaxe Cron standard dans le champ Chaîne CRON. Par exemple, l'expression 10 3 * *
* crée une sauvegarde à 03:10 chaque jour. Toutes les heures sont interprétées comme étant en UTC. L'intervalle minimal entre les sauvegardes planifiées est de 10 minutes.
Dans le champ Supprimer les sauvegardes après, définissez le nombre de jours pendant lesquels conserver la sauvegarde. Une fois le nombre de jours écoulé, la sauvegarde est automatiquement supprimée.
Définissez le nombre de jours pendant lesquels les sauvegardes ne peuvent pas être supprimées.
Pour verrouiller la règle de conservation, cliquez sur l'icône en forme de cadenas pour passer de l'état Désactivé à Activé.
Vérifiez les informations du plan de sauvegarde, puis cliquez sur Créer un plan.
API
Créez une ressource personnalisée ClusterBackupPlan dans le cluster pour programmer des sauvegardes. Un plan de sauvegarde planifie périodiquement des sauvegardes en fonction de backupSchedule.
Les ressources ClusterBackupPlan sont des ressources d'espace de noms. Voici un exemple de ClusterBackupPlan :
Remplacez PROJECT_NAME par le nom de votre projet GDC.
Cet exemple inclut les valeurs suivantes :
Valeur
Description
targetClusterName
Nom du cluster à sauvegarder.
targetClusterType
Type de cluster à sauvegarder. Par exemple, "UserCluster" et "ManagementAPI".
backupSchedule
Planning indiquant la fréquence à laquelle effectuer la sauvegarde.
cronSchedule: : planification crontab indiquant quand planifier les sauvegardes.
paused: Si true, les sauvegardes périodiques ne sont pas planifiées.
clusterBackupConfig
Détails de configuration des sauvegardes :
backupScope: Indique les ressources sauvegardées. Spécifiez l'une des options suivantes :
allNamespaces: capture toutes les ressources de tous les espaces de noms.
selectedNamespaces: capture les ressources dans la liste des espaces de noms spécifiés.
selectedApplication: capture les ressources définies par protectedApplications.
clusterBackupRepositoryName: le dépôt cible qui stocke les sauvegardes. Il doit être importé en tant que ReadWrite..
retentionPolicy
Détermine combien de temps les sauvegardes sont conservées dans le backupRepository..
backupDeleteLockDays: empêche la suppression de la sauvegarde pendant le nombre de jours spécifié après sa création.
backupRetainDays: supprime les sauvegardes après le nombre de jours spécifié après leur création.
Les règles de conservation ne remplacent pas celles de l'emplacement de stockage et ne peuvent pas dépasser 90 jours.
description
Description du plan de sauvegarde.
Une fois le plan de sauvegarde créé, les sauvegardes sont automatiquement créées avec la configuration de sauvegarde spécifiée, en fonction du calendrier de sauvegarde.
Afficher un plan de sauvegarde
Affichez un plan de sauvegarde à l'aide de la console GDC :
Connectez-vous à la console GDC.
Dans le menu de navigation, cliquez sur Sauvegarde pour les clusters.
Cliquez sur Sélectionner un projet, puis sélectionnez une organisation ou un projet en fonction de votre rôle :
Administrateur de sauvegarde de cluster d'utilisateur : sélectionnez une organisation pour afficher tous les plans de sauvegarde d'une organisation ou sélectionnez un projet pour afficher tous les plans de sauvegarde d'un projet.
Créateur de sauvegarde : sélectionnez un projet pour afficher tous les plans de sauvegarde qu'il contient.
Cliquez sur l'onglet Plans de sauvegarde.
Cliquez sur un plan de sauvegarde dans la liste pour afficher ses détails. Les utilisateurs disposant de droits d'administrateur de la sauvegarde des clusters d'utilisateur peuvent afficher tous les plans de sauvegarde de l'organisation. Les utilisateurs disposant du rôle "Créateur de sauvegarde" peuvent afficher tous les plans de sauvegarde du projet sélectionné.
Modifier un plan de sauvegarde
Modifiez un plan de sauvegarde à l'aide de la console GDC :
Connectez-vous à la console GDC.
Dans le menu de navigation, cliquez sur Sauvegarde pour les clusters.
Cliquez sur Sélectionner un projet, puis sélectionnez une organisation ou un projet en fonction de votre rôle :
Administrateur de la sauvegarde du cluster d'utilisateur : sélectionnez une organisation pour afficher tous les plans de sauvegarde d'une organisation, ou sélectionnez un projet pour afficher tous les plans de sauvegarde d'un projet.
Créateur de sauvegarde : sélectionnez un projet pour afficher tous les plans de sauvegarde qu'il contient.
Cliquez sur l'onglet Plans de sauvegarde.
Cliquez sur le nom du plan de sauvegarde que vous souhaitez modifier.
Cliquez sur l'onglet Configuration du forfait pour afficher les champs modifiables.
Cliquez sur l'icône Modifier edit pour Programmation et conservation afin de modifier cette ressource :
Pour mettre à jour une planification, saisissez une expression à l'aide de la syntaxe Cron standard dans le champ Chaîne CRON. Par exemple, l'expression 10 3 * * * crée une sauvegarde à 03:10 chaque jour. Toutes les heures sont interprétées comme étant en UTC. L'intervalle minimal entre les sauvegardes planifiées est de 10 minutes.
Dans le champ Supprimer les sauvegardes après, définissez le nombre de jours pendant lesquels conserver la sauvegarde. Une fois le nombre de jours écoulé, la sauvegarde est automatiquement supprimée.
Dans le champ Empêcher la suppression pendant, définissez le nombre de jours pendant lesquels les sauvegardes ne peuvent pas être supprimées.
Pour verrouiller la règle de conservation, cliquez sur l'icône en forme de cadenas pour passer de l'état Désactivé à Activé.
Cliquez sur le bouton Enregistrer pour confirmer vos modifications.
Désactiver un plan de sauvegarde
Désactiver un plan de sauvegarde à l'aide de la console GDC :
Connectez-vous à la console GDC.
Dans le menu de navigation, cliquez sur Sauvegarde pour les clusters.
Cliquez sur Sélectionner un projet, puis sélectionnez une organisation ou un projet en fonction de votre rôle :
Administrateur de sauvegarde de cluster d'utilisateur : sélectionnez une organisation pour afficher tous les plans de sauvegarde d'une organisation ou sélectionnez un projet pour afficher tous les plans de sauvegarde d'un projet.
Créateur de sauvegarde : sélectionnez un projet pour afficher tous les plans de sauvegarde qu'il contient.
Cliquez sur l'onglet Plans de sauvegarde.
Cliquez sur le nom du forfait de sauvegarde que vous souhaitez désactiver.
Cliquez sur le bouton Deactivate Plan (Désactiver le forfait).
Saisissez le nom du plan de sauvegarde que vous désactivez dans le champ.
Cliquez sur le bouton Désactiver pour finaliser la désactivation de ce plan de sauvegarde.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eBackup plans in Google Distributed Cloud (GDC) air-gapped define the configuration, location, and management for a series of backups, allowing for multiple smaller backups throughout the day or differing backup frequencies for different parts of a cluster.\u003c/p\u003e\n"],["\u003cp\u003eEach cluster should have at least one backup plan, and a single cluster or virtual machine (VM) can be part of multiple backup plans, although a plan cannot span across multiple clusters.\u003c/p\u003e\n"],["\u003cp\u003eBackup plans can be created and managed through the GDC console or the API, with options to back up the entire cluster, specific namespaces, or selected applications, and the ability to include secrets and persistent volume data.\u003c/p\u003e\n"],["\u003cp\u003eBackup plans can be scheduled using cron syntax, and users can set retention policies for backups, including how long to keep backups and for how many days they are prevented from being deleted.\u003c/p\u003e\n"],["\u003cp\u003eBackup plans can be viewed, edited, and deactivated through the GDC console by users with the appropriate roles, with deactivation preventing future backups without deleting existing ones.\u003c/p\u003e\n"]]],[],null,["# Plan a set of backups\n\nThis page describes how to create and manage backup plans for cluster workloads in Google Distributed Cloud (GDC) air-gapped.\n\n*Backup plans* provide the configuration, location, and management functions for\na sequence of backups. A backup plan contains a backup configuration, including\nthe source cluster and the selection of workloads to back up. Google recommends\nproviding every cluster with at least one backup plan.\n\nYou can create one or more backup plans for each cluster. You might want to\npartition the backups of your cluster for one of the following reasons:\n\n- Instead of having one very large backup taken at a single time of the day, you want multiple smaller backups distributed throughout the day.\n- You want to back up some portions of your cluster more often than others, such as daily backups for some namespaces and hourly backups for others.\n\nA single cluster or virtual machine (VM) can belong to one or more backup plans.\nA backup plan cannot span more than one cluster; however, a single backup plan\ncan capture multiple VMs if they exist in the same cluster. All backup\nand restore resources must be associated with a project name.\n\nBefore you begin\n----------------\n\nTo create a backup plan, you must have the following:\n\n- The necessary identity and access role:\n - User Cluster Backup Admin: manages backup resources such as backup and restore plans in user clusters. Ask your Organization IAM Admin to grant you the User Cluster Backup Admin (`user-cluster-backup-admin`) role. For more information, see [Role definitions](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/iam/role-definitions).\n- If you are an Application Operator, ask your administrator that has User Cluster Backup Admin privileges to create a backup plan for you.\n\nCreate a backup plan\n--------------------\n\nWe recommend that you define a cron schedule for the backup plan, so that\nbackups are automatically created according to that schedule. You can also\nmanually back up your workloads. For more information, see [Create a manual backup](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/back-up-workloads#create-manual-backup).\n\nCreate backup plans using the GDC console or the API. \n\n### Console\n\n1. Sign in to the GDC console.\n2. In the navigation menu, click **Backup for Clusters**.\n3. Click **Create Backup Plan**.\n4. In the **Plan details** section, complete the following steps and click **Continue** :\n 1. In the **Cluster** list, select the cluster to back up.\n 2. In the **Project** list, select the project.\n 3. In the **Backup plan name** field, enter your chosen backup plan name.\n 4. (Optional) In **Backup plan description** enter a description for the backup plan.\n 5. In the **Backup repo** field, select a backup repository. Backup repositories are a set of object storage implementations.\n 6. Click **Next**.\n5. In the **Scope and encryption** section, complete the following steps\n and click **Continue**:\n\n 1. Select one of the following scopes for the backup plan:\n\n 1. Click **Entire cluster** to back up all namespace resources in the backup.\n 2. Click **Selected namespaces within the cluster** to choose the namespaces in the backup to restore.\n 1. Click **Edit Cluster Namespace** and then **Add Cluster\n Namespace** to enter a **Namespace**.\n 3. Click **Selected protected applications within this cluster** to add resources by specifying the namespace and the application name.\n 1. Click **Edit Protected Applications** and then **Add\n Protected Application** to enter a **Namespace** and **Protected Application**.\n 2. Click **Include Secrets** to include Kubernetes `Secret` resources.\n\n 3. Click **Include persistent volume data** if you want the volume data\n in your backup. Clear this checkbox if you want to create empty\n volumes during the restore.\n\n6. In the **Schedule and retention** section, complete the following steps\n and click **Continue**:\n\n 1. To define a schedule, enter an expression using standard cron syntax in the **CRON string** field. For example, the expression `10 3 * *\n *` creates a backup at 0310 every day. All times are interpreted as UTC. The minimum interval between scheduled backups is 10 minutes.\n 2. In the **Delete backups after** field, set the number of days for which to retain the backup. Once the number of days is reached, the backup is automatically deleted.\n 3. Set the number of days during which backups cannot be deleted.\n 4. To lock the retention policy, click the lock icon to turn the lock from **Off** to **On**.\n7. Review the backup plan details and click **Create Plan**.\n\n### API\n\nCreate a `ClusterBackupPlan` custom resource in the cluster to schedule backups. A\nbackup plan periodically schedules backups based on the `backupSchedule`.\n`ClusterBackupPlan` resources are namespace resources. Here's an example of a `ClusterBackupPlan`: \n\n apiVersion: backup.gdc.goog/v1\n kind: ClusterBackupPlan\n metadata:\n name: backup-plan\n namespace: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003ePROJECT_NAME\u003c/span\u003e\u003c/var\u003e\n spec:\n targetCluster:\n targetClusterType: UserCluster\n targetClusterName:\n kind: \"Cluster\"\n name: \"cluster-sample\"\n backupSchedule:\n cronSchedule: \"*/30 * * * *\"\n paused: false\n clusterBackupConfig:\n backupScope:\n selectedNamespaces:\n namespaces: [\"nginx\"]\n clusterBackupRepositoryName: backup-repository\n retentionPolicy:\n backupDeleteLockDays: 10\n backupRetainDays: 10\n\nReplace \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e with the name of your GDC project.\n\nThis example includes the following values:\n\nAfter a backup plan is created, backups are automatically created with the\nspecified backup configuration based on the backup schedule.\n\nView a backup plan\n------------------\n\nView a backup plan using the GDC console:\n\n1. Sign in to the GDC console.\n2. In the navigation menu, click **Backup for Clusters**.\n3. Click **Select project** and select an organization or project depending on your role:\n - User Cluster Backup Admin: Select an organization to see all backup plans in an organization or select a project to see all backup plans in a project.\n - Backup Creator: Select a project to see all backup plans in a project.\n4. Click the **Backup Plans** tab.\n5. Click a backup plan in the list to view its details. Users with User Cluster Backup Admin privileges can view all backup plans in the organization. Users with the Backup Creator role can view all backup plans in the selected project.\n\nEdit a backup plan\n------------------\n\nEdit a backup plan using the GDC console:\n\n1. Sign in to the GDC console.\n2. In the navigation menu, click **Backup for Clusters**.\n3. Click **Select project** , and select an organization or project depending on your role:\n - User Cluster Backup Admin: Select an organization to see all backup plans in an organization, or select a project to see all of the backup plans in a project.\n - Backup Creator: Select a project to see all of the backup plans in a project.\n4. Click the **Backup Plans** tab.\n5. Click the name of the backup plan that you want to edit.\n6. Click the **Plan Configuration** tab to view the fields that can be modified.\n7. Click the *edit* Edit icon for **Schedule and retention** to edit that resource:\n\n 1. To update a schedule, enter an expression using standard cron syntax in the **CRON string** field. For example, the expression `10 3 * * *` creates a backup at 0310 every day. All times are interpreted as UTC. The minimum interval between scheduled backups is 10 minutes.\n 2. In the **Delete backups after** field, set the number of days for which to retain the backup. Once the number of days is reached, the backup is automatically deleted.\n 3. In the **Prevent deletion for** field, set the number of days during which backups cannot be deleted.\n\n | **Note:** If both fields are enabled, the value of the **Prevent deletion for** field must be less than the value of the **Delete backups after** field.\n 4. To lock the retention policy, click the lock icon\n from **Off** to **On**.\n\n | **Note:** Once the retention policy is locked, you won't be able to edit the retention policy of this backup plan again. You can only update the schedule.\n 5. Click the **Save** button to confirm your changes.\n\nDeactivate a backup plan\n------------------------\n\nDeactivate a backup plan using the GDC console:\n\n1. Sign in to the GDC console.\n2. In the navigation menu, click **Backup for Clusters**.\n3. Click **Select project** , and select an organization or project depending on your role:\n - User Cluster Backup Admin: Select an organization to see all backup plans in an organization or select a project to see all backup plans in a project.\n - Backup Creator: Select a project to see all backup plans in a project.\n4. Click the **Backup Plans** tab.\n5. Click the name of the backup plan you want to deactivate.\n6. Click the **Deactivate Plan** button.\n7. Enter the name of the backup plan you are deactivating into the field.\n8. Click the **Deactivate** button to complete the deactivation of this backup plan.\n\n | **Note:** This operation cannot be undone. Deactivating the backup plan does not delete the backups contained within it, but no new backups can be created automatically or manually.\n\nWhat's next\n-----------\n\n- [Back up your workloads](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/cluster-backup/back-up-workloads)"]]
