Spécifier l'ordre de restauration des ressources lors de la restauration
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Autopilot
Standard
Cette page explique comment spécifier l'ordre dans lequel Sauvegarde pour GKE doit restaurer différents GroupKinds lors d'une opération de restauration.
Présentation
Par défaut, Sauvegarde pour GKE restaure les GroupKinds connus dans un ordre qui répond aux exigences de dépendance entre les ressources. Toutefois, si des ressources supplémentaires doivent être restaurées dans un ordre spécifique, vous pouvez utiliser la fonctionnalité de restauration ordonnée pour spécifier l'ordre requis en définissant des dépendances entre les ressources concernées.
Lors d'une opération de création ou de mise à jour d'un plan de restauration, vous pouvez spécifier une liste de dépendances GroupKind personnalisées. Pour représenter une dépendance entre deux ressources personnalisées, spécifiez les deux GroupKind suivants :
Satisfying GroupKind : ce type de groupe satisfait les dépendances et doit être restauré avant le GroupKind requis. Dans la console Google Cloud , ce GroupKind représente les champs Premier groupe d'API et Premier genre d'objet.
Requiring GroupKind : ce GroupKind dépend du Satisfying GroupKind à restaurer en premier. Dans la console Google Cloud , ce GroupKind représente les champs Second groupe d'API et Second genre d'objet.
Sauvegarde pour GKE prend une liste de dépendances personnalisées et les dépendances par défaut et les combine pour générer un ordre de restauration de GroupKind.
Dépendances par défaut
Le tableau suivant répertorie les dépendances d'association par défaut entre les ressources Satisfying GroupKind et Requiring GroupKind. Lorsque vous définissez un ordre de restauration, Sauvegarde pour GKE restaure tous les Satisfying GroundKind avant les Requiring GroupKind.
Par exemple, Sauvegarde pour GKE restaure toujours tous les storage.k8s.io/StorageClass avant les PersistentVolumeClaims.
L'ordre de restauration par défaut gère également les cas de base, comme la restauration des espaces de noms avant toutes les ressources d'espace de noms et la restauration de CustomResourceDefinitions avant tout CustomResources.
Suivez les instructions ci-dessous pour ajouter des dépendances GroupKind personnalisées à un plan de restauration.
Consultez la liste des dépendances par défaut pour toutes les dépendances GroupKind déjà gérées par Sauvegarde pour GKE et qui n'ont pas besoin d'être spécifiées.
gcloud
Créez un fichier YAML pour définir l'ordre de restauration. Vous pouvez utiliser l'exemple YAML suivant.
L'exemple suivant indique que stable.example.com/First doit être restauré avant stable.example.com/Second et que stable.example.com/Second doit être restauré avant stable.example.com/Third.
Dans le menu de navigation, cliquez sur Sauvegarde pour GKE.
Cliquez sur l'onglet Plans de restauration.
Cliquez sur le nom du plan de restauration.
Cliquez sur l'onglet Détails.
Cliquez sur Modifier à côté de Ordre de restauration.
Cliquez sur Ajouter un ordre défini.
Dans la section "Item 1" (Élément 1), saisissez Premier groupe d'API 1 et Premier type d'objet 1, suivis de Deuxième groupe d'API 2 et Deuxième type d'objet 2, selon l'ordre dans lequel les ressources doivent être restaurées.
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)."],[],[],null,["# Specify resource restore ordering during restoration\n\nAutopilot Standard\n\n*** ** * ** ***\n\nThis page describes how to specify the order in which Backup for GKE\nshould restore different GroupKinds during a restore operation.\n\nOverview\n--------\n\nBy default, Backup for GKE restores well-known GroupKinds in an order that\nfulfills dependency requirements among resources. However, if there are additional\nresources that need restoring in a specific order, you can use the restore ordering\nfeature to specify the required order by defining dependencies between the affected\nresources.\n\nDuring a restore plan create or update operation, you can specify a list of\ncustom GroupKind dependencies. To represent a dependency between two custom\nresources, specify the following two GroupKinds:\n\n- Satisfying GroupKind: this GroupKind satisfies the dependencies and must be restored before the requiring GroupKind. In the Google Cloud console, this GroupKind is termed as the **First API group** and **First object kind** fields.\n- Requiring GroupKind: this GroupKind depends on the satisfying GroupKind to be restored first. In the Google Cloud console, this GroupKind is termed as the **Second API group** and **Second object kind** fields.\n\nBackup for GKE takes a list of custom dependencies and the\n[default dependencies](#default) and combines them to generate a GroupKind restore order.\n\nDefault dependencies\n--------------------\n\nThe following table lists the default pairing dependencies between satisfying\nand requiring GroundKind resources. When defining a restoring order,\nBackup for GKE restores all satisfying GroundKinds before Requiring GroupKinds.\nFor example, Backup for GKE always restores all `storage.k8s.io/StorageClass`\nbefore `PersistentVolumeClaims`.\n\nThe default restore ordering also handles basic cases, such as restoring\nnamespaces before all namespaced resources and restoring `CustomResourceDefinitions`\nbefore any `CustomResources`.\n\nDefine resource restore ordering\n--------------------------------\n\nUse the following instructions to add custom GroupKind dependencies to a restore plan.\nRefer to the list of [default dependencies](#default) for all GroupKind dependencies\nthat are already handled by Backup for GKE and don't need to be specified. \n\n### gcloud\n\n1. Create a YAML file to define restore order. You can use the following YAML example.\n\n The following example indicates that `stable.example.com/First` must be\n restored before `stable.example.com/Second` and that `stable.example.com/Second`\n must be restored before `stable.example.com/Third`. \n\n restoreOrder:\n groupKindDependencies:\n - satisfying:\n resourceGroup: stable.example.com\n resourceKind: First\n requiring:\n resourceGroup: stable.example.com\n resourceKind: Second\n - satisfying:\n resourceGroup: stable.example.com\n resourceKind: Second\n requiring:\n resourceGroup: stable.example.com\n resourceKind: Third\n\n2. Define a restore order using the restore order file you created.\n\n gcloud beta container backup-restore restore-plans update \u003cvar translate=\"no\"\u003eRESTORE_PLAN\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e \\\n --location=\u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e \\\n --restore_order_file=\u003cvar translate=\"no\"\u003eRESTORE_ORDER_FILE\u003c/var\u003e\n\n Replace the following:\n\n- \u003cvar translate=\"no\"\u003eRESTORE_PLAN\u003c/var\u003e: the name of the restore plan that you want to update.\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of your Google Cloud project.\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e: the compute region of the parent restore plan.\n- \u003cvar translate=\"no\"\u003eRESTORE_ORDER_FILE\u003c/var\u003e: the path to the YAML file containing the GroupKind dependencies, as shown in the earlier example.\n\n### Console\n\nUse the following instructions to add order to an existing restore plan in the Google Cloud console:\n\n1. In the Google Cloud console, go to the **Google Kubernetes Engine** page.\n\n [Go to Google Kubernetes Engine](https://console.cloud.google.com/kubernetes/list)\n2. In the navigation menu, click **Backup for GKE**.\n\n3. Click the **Restore plans** tab.\n\n4. Click the restore plan name.\n\n5. Click the **Details** tab.\n\n6. Click **Edit** that is next to the **Restore order**.\n\n7. Click **Add order set**.\n\n8. In the Item 1 section, enter **First API group 1** and **First object kind 1**\n followed by **Second API group 2** and **Second object kind 2** the order\n in which the resources to be restored.\n\n9. Click **Save changes**.\n\nWhat's next\n-----------\n\n- Learn more about [restoring a backup](/kubernetes-engine/docs/add-on/backup-for-gke/how-to/restore)."]]
