Labels nach dem Wiederherstellen von an VMs angehängten Laufwerken bereinigen
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auf dieser Seite erfahren Sie, wie Sie potenziellen Datenverlust oder Fehler beim Wiederherstellen von Laufwerken verhindern, die aus Sicherungen von Laufwerken wiederhergestellt wurden, die an VMs angehängt sind.
Beim Wiederherstellen eines einzelnen Laufwerks, das an eine VM angehängt war, können bestimmte Labels auf der wiederhergestellten Laufwerksressource und der zugrunde liegenden PersistentVolumeClaim-Ressource (PVC) zurückbleiben. Wenn Sie die Labels nicht wie beschrieben entfernen, kann das folgende Folgen haben:
Fehler bei nachfolgenden vollständigen VM-Wiederherstellungsvorgängen.
Unbeabsichtigte Änderung oder Ersetzung des zugrunde liegenden PVC des wiederhergestellten Laufwerks während einer nachfolgenden vollständigen VM-Wiederherstellung, was möglicherweise zu Datenverlust auf dem wiederhergestellten Laufwerk führt.
Hinweise
Wenn Sie die Labels nach dem Wiederherstellen eines an eine VM angehängten Laufwerks bereinigen möchten, benötigen Sie Folgendes:
Die erforderliche Identitäts- und Zugriffsrolle. Bitten Sie Ihren IAM-Administrator der Organisation, Ihnen die Rolle „DBS Debugger“ (dbs-debugger) zuzuweisen.
Zugriff auf die entsprechenden kubeconfig-Dateien für die Cluster, die diese Ressourcen verwalten.
Das kubectl-Befehlszeilentool ist installiert und konfiguriert.
Labels bereinigen
Sie müssen die Bereinigung sowohl für die VirtualMachineDisk-Ressource als auch für die zugrunde liegende PersistentVolumeClaim-Ressource (PVC) durchführen.
VM-Laufwerkslabels bereinigen
So bereinigen Sie die Labels eines wiederhergestellten VM-Laufwerks:
Rufen Sie die kubeconfig-Datei für den Management-API-Server ab und legen Sie die Umgebungsvariable KUBECONFIG fest:
Ersetzen Sie PATH_TO_MANAGEMENT_API_KUBECONFIG durch den Pfad zur kubeconfig-Datei. Weitere Informationen finden Sie unter Serverressourcen der Zonal Management API.
Prüfen Sie, ob die wiederhergestellte Ressource VirtualMachineDisk im angegebenen Namespace vorhanden ist:
RESTORED_VM_DISK_NAME: Der vollständige Name des wiederhergestellten Laufwerks anhand der in den Voraussetzungen erfassten Werte. Der Wert für diese Variable kann aus RESTORED_PREFIX–VM_DISK_NAME abgeleitet werden.
Entfernen Sie das Label für den Sicherungsumfang aus der Ressource VirtualMachineDisk. Der nach dem Labelschlüssel stehende Bindestrich kennzeichnet das Entfernen:
Ersetzen Sie VM_NAME durch den Namen der wiederhergestellten VM.
Optional: Wenn Sie prüfen möchten, ob das Label bpvms/VM_NAME nicht mehr vorhanden ist, können Sie den entsprechenden kubectl get-Befehl noch einmal ausführen und dabei den jeweiligen Ressourcentyp und Cluster anpassen:
Ersetzen Sie VM_NAME durch den Namen der wiederhergestellten VM.
Optional: Wenn Sie prüfen möchten, ob das Label bpvms/VM_NAME nicht mehr vorhanden ist, können Sie den entsprechenden kubectl get-Befehl noch einmal ausführen und dabei den jeweiligen Ressourcentyp und Cluster anpassen:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-04 (UTC)."],[],[],null,["# Clean up labels after restoring VM-attached disks\n\nThis page guides you through how to prevent potential data loss or restore\nfailures when working with disks that were restored from backups of disks\nattached to virtual machines (VMs).\n\nRestoring an individual disk that was attached to a VM can leave behind specific\nlabels on the restored disk resource and its underlying `PersistentVolumeClaim`\n(PVC) resource. Failure to remove the labels as described can lead to:\n\n- Failures during subsequent full VM restore operations.\n- Unintended modification or replacement of the restored disk's underlying PVC during a subsequent full VM restore, potentially leading to data loss on the restored disk.\n\n| **Important:** These steps are mandatory immediately after you restore an individual disk if that disk was originally attached to a VM, especially if you intend to perform full VM backups and restores involving the original VM at a later time.\n\nBefore you begin\n----------------\n\nTo clean up the labels after restoring a VM-attached disk, you must have the following:\n\n- The necessary identity and access role. Ask your Organization IAM Admin to grant you the DBS Debugger (`dbs-debugger`) role.\n- Access to the appropriate kubeconfig files for the clusters managing these resources.\n- The kubectl command-line tool installed and configured.\n\nClean up labels\n---------------\n\nYou must perform the cleanup for both the `VirtualMachineDisk` resource and its underlying `PersistentVolumeClaim` (PVC) resource.\n\n### Clean up the VM disk labels\n\nTo clean up the labels of a restored VM disk, follow these steps:\n\n1. Get the kubeconfig file for the management API server and set the\n `KUBECONFIG` environment variable:\n\n export KUBECONFIG=\u003cvar translate=\"no\"\u003ePATH_TO_MANAGEMENT_API_KUBECONFIG\u003c/var\u003e\n\n Replace \u003cvar translate=\"no\"\u003ePATH_TO_MANAGEMENT_API_KUBECONFIG\u003c/var\u003e with the\n path to the kubeconfig file. For more information, see [Zonal Management API\n server\n resources](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/iam/sign-in#zonal-resources-kubeconfig).\n2. Check that the restored `VirtualMachineDisk` resource exists in the specified namespace:\n\n kubectl get virtualmachinedisks.virtualmachine.gdc.goog \\\n -n \u003cvar translate=\"no\"\u003eNAMESPACE\u003c/var\u003e \u003cvar translate=\"no\"\u003eRESTORED_VM_DISK_NAME\u003c/var\u003e\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eNAMESPACE\u003c/var\u003e: the project namespace.\n - \u003cvar translate=\"no\"\u003eRESTORED_VM_DISK_NAME\u003c/var\u003e: the full name of the restored disk using the values gathered in the prerequisites. The value for this variable can be derived from \u003cvar translate=\"no\"\u003eRESTORED_PREFIX\u003c/var\u003e-\u003cvar translate=\"no\"\u003eVM_DISK_NAME\u003c/var\u003e.\n3. Remove the backup scope label from the `VirtualMachineDisk` resource. The trailing hyphen after the label key signifies removal:\n\n kubectl label virtualmachinedisks.virtualmachine.gdc.goog -n \u003cvar translate=\"no\"\u003eNAMESPACE\u003c/var\u003e \\\n \u003cvar translate=\"no\"\u003eRESTORED_VM_DISK_NAME\u003c/var\u003e bpvms/\u003cvar translate=\"no\"\u003eVM_NAME\u003c/var\u003e-\n\n Replace \u003cvar translate=\"no\"\u003eVM_NAME\u003c/var\u003e with the name of the restored VM.\n4. Optional: To verify that the `bpvms/`\u003cvar translate=\"no\"\u003eVM_NAME\u003c/var\u003e label is no longer present, you can re-run the corresponding `kubectl get` command, adjusting for the specific resource type and cluster:\n\n kubectl get virtualmachinedisks.virtualmachine.gdc.goog \\\n -n \u003cvar translate=\"no\"\u003eNAMESPACE\u003c/var\u003e \u003cvar translate=\"no\"\u003eVM_NAME\u003c/var\u003e\n\n### Clean up the PVC labels\n\nTo clean up the labels of the underlying PVC, follow these steps:\n\n1. Get the kubeconfig file for the org infrastructure cluster and set the `KUBECONFIG` environment variable:\n\n export KUBECONFIG=\u003cvar translate=\"no\"\u003ePATH_TO_ORG_INFRA_KUBECONFIG\u003c/var\u003e\n\n Replace \u003cvar translate=\"no\"\u003ePATH_TO_ORG_INFRA_KUBECONFIG\u003c/var\u003e with the path\n to the kubeconfig file.\n2. Check that the underlying PVC for the restored disk exists in the specified namespace:\n\n kubectl get pvc -n \u003cvar translate=\"no\"\u003eNAMESPACE\u003c/var\u003e \\\n \u003cvar translate=\"no\"\u003eRESTORED_VM_DISK_NAME\u003c/var\u003e\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eNAMESPACE\u003c/var\u003e: the project namespace.\n - \u003cvar translate=\"no\"\u003eRESTORED_VM_DISK_NAME\u003c/var\u003e: the name of the restored VM disk.\n3. Remove the backup scope label from the PVC. The trailing hyphen after the label key signifies removal:\n\n kubectl label pvc -n \u003cvar translate=\"no\"\u003eNAMESPACE\u003c/var\u003e \u003cvar translate=\"no\"\u003eRESTORED_VM_DISK_NAME\u003c/var\u003e bpvms/\u003cvar translate=\"no\"\u003eVM_NAME\u003c/var\u003e-\n\n Replace \u003cvar translate=\"no\"\u003eVM_NAME\u003c/var\u003e with the name of the restored VM.\n4. Optional: To verify that the `bpvms/`\u003cvar translate=\"no\"\u003eVM_NAME\u003c/var\u003e label is no longer present, you can re-run the corresponding `kubectl get` command, adjusting for the specific resource type and cluster:\n\n kubectl get pvc -n \u003cvar translate=\"no\"\u003eNAMESPACE\u003c/var\u003e \\\n \u003cvar translate=\"no\"\u003eVM_NAME\u003c/var\u003e"]]