[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-09-01 (世界標準時間)。"],[],[],null,["| **Preview**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nThis page describes how to back up and restore an admin cluster created with\nGoogle Distributed Cloud (software only) for VMware. The backup process includes backing\nup the cluster's etcd data, Secrets, and certificates using the `gkectl`\ncommand-line tool. You can also\n[back up and restore](/kubernetes-engine/distributed-cloud/vmware/docs/how-to/back-up-admin-cluster) an admin\ncluster manually.\n\nTo back up and restore a cluster with\n[advanced cluster](/kubernetes-engine/distributed-cloud/vmware/docs/concepts/advanced-clusters) enabled, see\n[Back up and restore advanced clusters with gkectl](/kubernetes-engine/distributed-cloud/vmware/docs/how-to/back-up-and-restore-advanced-cluster-with-gkectl).\n| **Note:** Using a third-party backup tool, such as Veeam, to back up an admin cluster isn't supported. Backing up the cluster with a third-party tool might lead to unforeseen errors in cluster operations.\n\nBack up an admin cluster\n\nYou can set up admin cluster backups so they are automatically performed before\nand after cluster creation, update, and upgrade. You can also perform an\non-demand backup whenever you deem it necessary.\n\nAn admin cluster backup includes the following:\n\n- Admin cluster etcd data\n- Secrets\n- Certificates\n- Always-on secrets encryption keys and config files if always-on secrets encryption feature is enabled\n- Admin cluster kubeconfig file (1.29 and higher)\n- Admin cluster SSH key file (1.29 and higher)\n\nThe size of a backup can range from 3 MB--100 MB depending on the size of the cluster.\n\nEnable the admin cluster backup feature\n\nBy default this feature is disabled. To enable the admin cluster backup feature:\n\n1. Add the following section to the [admin cluster configuration file](/kubernetes-engine/distributed-cloud/vmware/docs/how-to/admin-cluster-configuration-file-latest):\n\n ```\n clusterBackup:\n datastore: DATASTORE\n ```\n\n Replace \u003cvar class=\"edit\" translate=\"no\"\u003eDATASTORE\u003c/var\u003e with the datastore where you want to store the backup. The datastore must be in the same datacenter as the admin cluster.\n\n For non HA admin cluster, backups are located in the \"anthos-backup/\u003cvar translate=\"no\"\u003eDATADISK_PATH\u003c/var\u003e\" directory of the specified datastore.\n\n For HA admin cluster, backups are located in \"anthos/\u003cvar translate=\"no\"\u003eADMIN_CLUSTER_NAME\u003c/var\u003e/backup\" directory of the specified datastore.\n2. Update the admin cluster:\n\n ```\n gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG\n ```\n\n Replace:\n - \u003cvar translate=\"no\"\u003eADMIN_CLUSTER_KUBECONFIG\u003c/var\u003e with the path of your admin cluster kubeconfig file.\n - \u003cvar translate=\"no\"\u003eADMIN_CLUSTER_CONFIG\u003c/var\u003e with the path of your admin cluster configuration file.\n\nDisable the admin cluster backup feature\n\n1. Remove the `clusterBackup` section from the admin cluster configuration file.\n\n ```\n clusterBackup:\n datastore: DATASTORE\n ```\n2. Update the admin cluster with this change, using this command:\n\n ```\n gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG\n ```\n\nUpdate the backup datastore\n\nYou can update the datastore where backups are stored by updating `clusterBackup.datastore` to reflect the new location. The new datastore must be in the same datacenter as the admin cluster.\n\n1. Edit the admin cluster configuration file to change the `clusterBackup.datastore` value.\n\n ```\n clusterBackup:\n datastore: new-datastore\n ```\n2. Update the admin cluster with this change, using this command:\n\n ```\n gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG\n ```\n\nOn-demand backup\n\nTo trigger an on-demand admin cluster backup, run the following command:\n\n\u003cbr /\u003e\n\n```\ngkectl backup admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG\n \n```\n\n\u003cbr /\u003e\n\nLimit on number of backups\n\nYou can have a maximum total of six backups, divided into a maximum of three on-demand backups, and a maximum of three backups from cluster update, upgrade or create operations. These backups are automatically rotated should these limits be exceeded. No manual intervention is necessary.\n\nRestore an admin cluster **Warning:** Using a backup to restore your admin cluster is a last resort. We do not recommend that you restore from a backup file unless the admin cluster is completely broken. Contact Google Support for help in deciding the best course of action.\n\nYou should restore an admin cluster only when it is completely broken with data loss or corruption. For example,\n\n- The admin master data disk is lost or corrupted.\n- The admin cluster's etcd is lost or corrupted.\n- The admin cluster's control plane secrets and certificates are lost or corrupted.\n\nDo not use this approach to restore a working admin cluster to an arbitrary previous state. This restore feature should not be used as a way to revert admin cluster operations such as a cluster update or cluster upgrade.\n\nDo not use this approach to restore HA admin cluster. For HA admin cluster we only support `gkectl repair admin-master`, but not `gkectl repair admin-master --restore-from-backup`.\n\nTo recreate the admin cluster from a backup, run the following command:\n\n\u003cbr /\u003e\n\n```\n gkectl repair admin-master --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG --restore-from-backup\n \n```\n\n\u003cbr /\u003e\n\nThis command retrieves all of the backups of this admin cluster from the datastore defined in the `clusterBackup` section of the admin cluster configuration file, and it prompts you to select the one from which you want to use to restore the admin cluster."]]