Docs

Volcengine Kubernetes Engine

Application backup

Creating restore jobs

VKE supports one-click data restore to a specified cluster based on successful or partially failed backups. This topic describes how to create a restore job.

Background

Backup/Restore target clusters: All VKE clusters, such as managed clusters and registered clusters, can be used as backup/restore target clusters.

Backup/Restore resource scope: The backup center provides namespace-level application metadata backup and restore, including Kubernetes-native resources, CustomResourceDefinition (CRD) resources, and volume resources. The following types of data are supported for backup and restore:

Application metadata, which refers to the definition data of Kubernetes objects.

Volume data, which refers to the data in volumes mounted to pods. Volume types include PVC, local, emptyDir, and more.

The restore job states and their operation restrictions are as follows:

Status	Description	Notes	Supported actions
Status	Description	Notes				View details	Delete
Starting	The restore job is initializing and the restoration has not started yet.	Intermediate status	✔️	❌
Restoring	The job has started execution and is restoring data.	Intermediate status	✔️	❌
Succeeded	All data has been restored and no errors occurred.	Stable status	✔️	✔️
Fail	Restore job validation failed. The restore job has not started yet.	Stable status	✔️	✔️
Fail		A failure occurred during the execution of the restore job, so it cannot proceed and other resources will not be restored.	Stable status	✔️	✔️
Partially failed	Certain resources failed to be restored. Other resources will be restored normally.	Stable status	✔️	✔️
Deleting	The restore job is being deleted.	Intermediate status	❌	❌

Usage limits

The recommended Kubernetes version range for backup/restore target clusters is v1.24.x to v1.32.x.

Only successful or partially failed backup jobs can be restored.

Prerequisites

The migrate-plugin add-on has been installed. For details, see migrate-plugin.

A backup plan has already been created, for which successful or partially failed backup jobs exist. For details, see Creating backup plans.

Procedure

In the left navigation bar, click Backup center > Application backup to enter the application backup page.

Go to the Restore job page, configure the following settings, and click Confirm.

On the Restore job tab, click Create backup job.

On the Backup job tab, find the target backup job and click Restore in the right Actions column.

On the Backup plan tab, click the name of the target backup plan to go to the details page. On the backup job tab, find the target backup job and click Restore in the Actions column.

Parameter	Description
Name	Enter a custom name for the restore job.
Backup job	Only successful or partially failed backup jobs support restoration. tip You can go to the Log of backup job tab on the backup job details page and search for level=error to check and confirm the scope of resources that failed to be backed up by the partially failed backup job. This helps ensure that key data is not lost when the platform restores resources.
Target cluster	Select the target cluster for restoring backup data. Make sure that the migrate-plugin add-on is installed in the selected cluster. tip If the selected cluster does not have the required migrate-plugin add-on installed, click Install and wait for the add-on to be installed successfully.
Redefine namespace	By default, the namespace for restore is the same as the source namespace. You can also redefine the restore namespace mapping. If the target namespace does not exist, it will be created in the target cluster. Source namespace: The namespace of the source cluster for backup. Target namespace: The namespace of the target cluster where backup data is restored.
PersistentVolume	By default, this feature is disabled. To restore PV, enable PV restoration, and configure the mapping between the source storage type and the storage type in the restore target cluster. Volume restore supports StorageClass redefinition to map the StorageClass in the source backup to the StorageClass in the target cluster: Source storage type: The source storage type in the backup data of the source cluster. By default, all StorageClasses in the backup volumes are included. Target storage type: The target storage type after the backup data is restored to the target cluster. tip The PersistentVolume restore configuration is displayed only when the source cluster backup job has enabled PV backup. When the backup job in the source cluster has PV backup enabled but the actual backup is empty, no relevant data can be obtained for the source storage type, and the selection list is empty.

Subsequent operations

After the restore job is completed, you can view the restore status using the Status field. If the status is Partially failed, go to the Log of restore job tab on the restore job details page and search for level=error to view the failed content and reason for failure. For common cases of partial failure and solutions to partially failed jobs, see Troubleshooting partially failed jobs.

If you no longer need a restore job, you can delete the restore job. To do so, click Backup center > Application backup, go to the Restore job tab, find the job in the Restore job list, and click Delete in the Actions column.

warning

Deleting a restore job will also delete restoration logs and other related information. Exercise caution when you perform this operation.

Last updated: 2026.06.24 11:15:04