migrate-controller - Container Service for Kubernetes - Alibaba Cloud Documentation Center

migrate-controller is a component based on the open source project Velero. It is deeply integrated with Alibaba Cloud ECS snapshots and Cloud Backup to provide backup, restore, and migration for your data and application templates. This topic describes the migrate-controller component, provides usage instructions, and includes a change log.

Component introduction

For more information about how to install the migrate-controller component, see Install the migrate-controller backup service component and configure permissions.

migrate-controller backs up your Kubernetes applications and persistent volume (PV) data. It supports multiple filtering policies to back up applications, such as by namespace, label, or resource. For data, it supports cloud disk snapshots and Cloud Backup file backups. You can also convert snapshots to reduce the Recovery Time Objective (RTO) during a restore.

Usage instructions

Use the migrate-controller component to back up, restore, and migrate applications. For more information, see Back up and restore applications in a cluster and Migrate applications across clusters in the same region.

Change log

September 2025

Version number	Registry Address	Change time	Change description	Impact
v1.8.7-b5e0b99	registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.7-b5e0b99	September 15, 2025	Adds support for adjusting volume capacity during restoration by transforming the StorageClass. Optimizes the information displayed when a backup is partially successful. Fixes an occasional error that occurs when you back up cloud disk volumes using Cloud Backup.	This change may interrupt backup jobs that are in progress.

July 2025

Version number	Registry Address	Change time	Change description	Impact
v1.8.6-17482bb-aliyun	registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.6-17482bb-aliyun	July 11, 2025	Adds support for the ECS Metadata Server hardening mode. Optimizes the concurrency logic for Cloud Backup restore jobs. Adds support for restoring data to an OSS StorageClass. Displays the corresponding snapshot instance ID in the backup results when a cloud disk volume is successfully backed up. Fixes an issue where associating a backup repository with a cluster for the first time occasionally fails.	This change may interrupt backup jobs that are in progress.

March 2025

Version number	Registry Address	Change time	Change description	Impact
v1.8.5-566ac53-aliyun	registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.5-566ac53-aliyun	March 31, 2025	Adds support for specifying the endpoint of an OSS Bucket when you create a backup repository. Optimizes the concurrency logic for Cloud Backup backup jobs. Fixes a backup issue for multi-attach cloud disks.	This change may interrupt backup jobs that are in progress.

January 2025

Version number	Registry Address	Change time	Change description	Impact of changes
v1.8.4-9bc1d22-aliyun	registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.4-9bc1d22-aliyun	January 24, 2025	Fixes an issue where the Cloud Backup client fails to be automatically deployed during restoration. Fixes an issue where the corresponding Cloud Backup job is not automatically canceled when you delete a backup that is in progress. Fixes an issue where ECI instances cannot be restored in some scenarios. Upgrades the Cloud Backup client to v2.25.1 to support regions such as China (Guangzhou). Adds support for modifying the access modes (AccessModes) of volumes when you perform a StorageClass transformation. Optimizes the error messages for StorageClass transformations.	This change may interrupt backup jobs that are in progress.

December 2024

Version number	Registry Address	Change time	Changes	Impact
v1.8.3-5bb9107-aliyun	registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.3-5bb9107-aliyun	December 05, 2024	Optimizes the data protection feature. Adds support for selecting multiple tags based on OR logic to specify the persistent volume claims (PVCs) to be backed up. Adds support for specifying a list of StorageClasses to select the PVCs to be backed up. Automatically appends the Secret resources referenced by the backed-up volumes and automatically modifies the reference information based on the `NamespaceMapping` configuration during restoration. Automatically appends the IngressClass resources that are specified by annotations in the Ingress.	This change may interrupt backup jobs that are in progress.

September 2024

Version number	Registry Address	Change time	Change description	Impact of the change
v1.8.2-deadfe3-aliyun	registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.2-deadfe3-aliyun	September 18, 2024	Adds support for automatic `apiVersion` upgrades for `ingresses.extensions` resources. Adds support for automatic switchover for FlexVolume PVCs and PVs when they are restored to a CSI cluster. Adds an `AccessModes` check when you restore cloud disk volumes. Adds the `imageRegistryMapping` field to enable automatic transformation of image repository addresses.	This change may interrupt backup jobs that are in progress.

July 2024

Important

Updates to migrate-controller v1.8.1-187f707-aliyun and later require Container Service for Kubernetes (ACK) version 1.20 or later.

Version number	Registry Address	Change time	Change description	Change Impact
v1.8.1-187f707-aliyun	registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.1-187f707-aliyun	July 29, 2024	Optimizes the status display for backup and restore jobs. Adds support for restoring the latest backup by specifying the backup plan name. Adds support for skipping a specific backup job in a backup schedule. Fixes an issue where backing up many non-ESSD cloud disks at the same time triggers CSI throttling and causes some backups to fail.	This change may interrupt backup jobs that are in progress.

May 2024

Version number	Registry Address	Change time	Change description	Impact
v1.8.0-0d05f43-aliyun	registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.0-0d05f43-aliyun	May 20, 2024	Optimizes the cloud resource authentication logic for ACK managed clusters. Fixes an issue where IngressClass resources cannot be automatically backed up. Adds support for backing up volume data by namespace.	This change may interrupt backup jobs that are in progress. Important When you install or upgrade to this version in a cluster under your Alibaba Cloud account for the first time, click Authorize to grant permissions on cloud resources. This authorization is a one-time operation for the entire Alibaba Cloud account.

April 2024

Version number	Registry Address	Change time	Change description	Impact
v1.7.10-9211ff5-aliyun	registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.7.10-9211ff5-aliyun	April 22, 2024	Fixes a data collection issue for backup center monitoring. Fixes a deployment issue for some subcomponents of ACK serverless clusters. Optimizes the backup speed for applications and volumes with small amounts of data. Changes the default time-to-live (TTL) of cloud disk snapshots created from backups to 30 days in clusters that run an earlier version of the CSI storage plug-in.	This change may interrupt backup jobs that are in progress.

February 2024

Version number	Registry Address	Change time	Change description	Impact
v1.7.9-a3e0c6a-aliyun	registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.7.9-a3e0c6a-aliyun	February 22, 2024	Adds support for backing up and restoring from one PVC to another. Adds support for skipping specific volumes during data backup by adding tags. Optimizes the details displayed when a partial restoration of cluster resources fails. Optimizes the logic for reclaiming temporary resources during backup and restoration. For edge clusters, the component is installed on cloud nodes by default and accesses OSS over the internal network.	This change may interrupt backup jobs that are in progress.

December 2023

Version number	Registry Address	Change time	Change description	Impact
v1.7.8-4cbd7cc-aliyun	registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.7.8-4cbd7cc-aliyun	December 30, 2023	Adds support for backing up and restoring PVCs that are all of the cloud disk type. Adds support for out-of-tree storage drivers such as CephFS and RBD. Optimizes the backup logic for StorageClass transformation.	This change may interrupt backup jobs that are in progress.
v1.7.7-1dfe3ba-aliyun	registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.7.7-1dfe3ba-aliyun	December 04, 2023	Adds support for cross-region restoration of ECS cloud disk volumes. Adds support for globally adjusting the timeout period for Velero application backups. Fixes an issue where the Cloud Backup token is missing after the component is reinstalled.	This change may interrupt backup jobs that are in progress.

November 2023

Version number	Registry Address	Change time	Change description	Impact
v1.7.6-1f392df-aliyun	registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.7.6-1f392df-aliyun	November 03, 2023	Fixes some data restoration issues. Automatically adjusts the apiVersion when the Kubernetes versions of the source and destination clusters for backup and restoration are different. Adds support for backing up applications and data in FlexVolume clusters by adding a configuration item. The data can be restored only to CSI clusters. For backups that include volumes, adds support for restoring only the applications. For backups that include multiple namespaces, adds support for restoring only some of the namespaces. Adds support for the ARM64 architecture.	This change may interrupt backup jobs that are in progress.

September 2023

Version number	Registry Address	Change time	Change description	Impact of the change
v1.7.5-07179f2-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.7.5-07179f2-aliyun	September 25, 2023	Adds support for pausing backup schedules. For clusters with Kubernetes or CSI versions earlier than 1.18, cloud disk data is backed up using Cloud Backup by default. Fixes an issue where backup or snapshot creation jobs remain in the InProgress state for an extended period in some cases. Automatically disables the force listener feature when you restore a `LoadBalancer` service that uses an existing SLB instance. Adds support for application backup and restoration in serverless Kubernetes (ASK) clusters.	This change may interrupt backup jobs that are in progress.

August 2023

Version number	Registry Address	Change time	Change description	Impact
v1.7.4-05b90e7-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.7.4-05b90e7-aliyun	August 15, 2023	Adds support for recreating snapshots of other types. Adds support for customizing the connectivity check and backup synchronization interval for backup repositories. Adds support for cross-cloud provider backup and restoration based on the CSI protocol. Allows registered clusters connected through Cloud Backup to use Cloud Backup over the internal network. Adds support for data collection for backup repositories and backup jobs.	This change may interrupt backup jobs that are in progress.

July 2023

Version number	Registry Address	Change time	Change description	Impact
v1.7.2-7510a43-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.7.2-7510a43-aliyun	July 10, 2023	Fixes a permission configuration issue for dedicated clusters in some cases. Adds support for automatically clearing expired backup jobs in a cluster. Adds support for excluding namespaces when you create a backup schedule. Allows automatic adjustment when a specified namespace in a backup schedule is deleted. Adds support for selecting custom StorageClasses of the cloud disk and NAS types when you create a snapshot. The hbr-client component supports standard log output.	This change may interrupt backup jobs that are in progress.

May 2023

Version number	Registry Address	Change time	Change description	Change impact
v1.7.1-dc3dd68-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.7.1-dc3dd68-aliyun	May 30, 2023	Adds support for the NFS CSI Driver for volume backups.	This change may interrupt backup jobs that are in progress.

April 2023

Version number	Registry Address	Change time	Change description	Impact
v1.7.0-38fb1fb-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.7.0-38fb1fb-aliyun	April 26, 2023	Allows you to force keep or change the NodePort of an application by configuring the `preserveNodePorts` parameter when you create a restore job. Allows you to use a partially successful Cloud Backup data backup to restore the application and the successfully backed up data.	This change may interrupt backup jobs that are in progress.

March 2023

Version number	Registry Address	Change time	Change description	Impact
v1.6.12-ee49a53-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.12-ee49a53-aliyun	March 10, 2023	Adds support for ACK Edge clusters. Adds support for customizing `preserveNodePorts`.	This change may interrupt backup jobs that are in progress.

February 2023

Version number	Registry Address	Change time	Change description	Impact
v1.6.11-e5b62fc-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.11-e5b62fc-aliyun	February 10, 2023	Fixes an issue where the conversion of CNFS volumes to cloud disk snapshots remains in the InProgress state for an extended period. Adds support for snapshot transformation and restoration in multi-zone clusters. If the destination cluster for restoration does not exist, the StorageClass corresponding to the volumes in the data backup is automatically converted to the alicloud-disk-topology-alltype or alibabacloud-cnfs-nas StorageClass.	This change may interrupt backup jobs that are in progress.

December 2022

Version number	Registry Address	Change time	Change description	Impact
v1.6.10-c2c6d70-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.10-c2c6d70-aliyun	December 15, 2022	Adds support for backing up many namespaces. Fixes an issue with hbr-client-token generation in specific cases.	This change may interrupt backup jobs that are in progress.
v1.6.9-9761639-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.9-9761639-aliyun	December 02, 2022	Retains replicas that are synced to the cluster when a backup is deleted.	This change may interrupt backup jobs that are in progress.

November 2022

Version number	Registry Address	Change time	Change description	Change Impact
v1.6.8-582985c-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.8-582985c-aliyun	November 07, 2022	Allows users to customize the NodePort configuration during application restoration. Adds support for restoring only application templates from a backup. Blocks FlexVolume users in admission control.	This change may interrupt backup jobs that are in progress.

September 2022

Version number	Registry Address	Change time	Change description	Impact
v1.6.7-3ac3f52-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.7-3ac3f52-aliyun	September 23, 2022	Resolves an issue where some CRD versions are not supported during application backup. Adds support for querying the source cluster of a backup during application restoration.	This change may interrupt backup jobs that are in progress.
v1.6.6-987b391-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.6-987b391-aliyun	September 01, 2022	Optimizes the backup process in the backup center.	This change may interrupt backup jobs that are in progress.

August 2022

Version number	Registry Address	Change time	Change description	Impact
v1.6.5-425ec0c-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.5-425ec0c-aliyun	August 11, 2022	Adds support for continuous synchronization of cross-cluster backups. Adds support for backup and restoration at the individual namespace level.	This change may interrupt backup jobs that are in progress.

May 2022

Version number	Registry Address	Change time	Change description	Impact
v1.6.3-6fd55d8-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.3-6fd55d8-aliyun	May 11, 2022	Adds support for accessing the container disaster recovery and backup service and Container Service using VPC domain names. Adds support for backing up clusters that cannot connect to the public network.	This change may interrupt backup jobs that are in progress.

March 2022

Version number	Registry Address	Change time	Change description	Impact of the change
v1.6.1-1af0d36-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.1-1af0d36-aliyun	March 22, 2022	Compatible with version 1.22 clusters. Fixes an issue of mismatched backup expiration times. The hbr-client supports default node taints.	This change may interrupt backup jobs that are in progress.

December 2021

Version number	Registry Address	Change time	Change description	Impacts
v1.5.9-37df39a-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.5.9-37df39a-aliyun	December 24, 2021	The hbr-client is deployed on demand instead of on every node.	This change may interrupt backup jobs that are in progress.

November 2021

Version number	Registry Address	Change time	Change description	Impact
v1.5.8-14de9e1-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.5.8-14de9e1-aliyun	November 28, 2021	Adds support for multiple clusters. Adds support for creating snapshot backups for PVCs of the cloud disk type. Optimizes the concurrency of the snapshot creation feature. Adds support for cross-region snapshot backups.	This change may interrupt backup jobs that are in progress.

October 2021

Version number	Registry Address	Change time	Change description	Impact
v1.5.6-94176c2-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.5.6-94176c2-aliyun	October 12, 2021	Optimizes the method for file system backups and adds support for dynamically enabling the Cloud Backup client.	This change may interrupt backup jobs that are in progress.
v1.5.7-561a15f-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.5.7-561a15f-aliyun	October 15, 2021	Optimizes the logic for internal access to Cloud Backup.	This change may interrupt backup jobs that are in progress.

September 2021

Version number	Registry Address	Change time	Change description	Impact
v1.5.5-d5e168a-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.5.5-d5e168a-aliyun	September 20, 2021	Updates the error message for failed backups. Fixes an issue where namespace creation fails during data restoration. The DaemonSet for the Cloud Backup client is no longer automatically installed by default. To use Cloud Backup, install the client manually. Adds support for using backslashes (\) in OSS subdirectories. Adds an error message that is displayed when you back up file system data without enabling the Cloud Backup service.	This change may interrupt backup jobs that are in progress.
v1.5.2-d728be2-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.5.2-d728be2-aliyun	September 10, 2021	Compatible with earlier versions. Upgrades the snapshot creation method. Upgrades file backups to use Cloud Backup. Adds support for converting files to cloud disk snapshots and NAS snapshots to reduce the RTO during restoration. Upgrades the access control policy for ACK managed clusters. Discontinues support for using Restic to back up data.	This change may interrupt backup jobs that are in progress.

July 2021

Version number	Registry Address	Change time	Change description	Impact
v1.4.1-f745291-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.4.1-f745291-aliyun	July 13, 2021	Adds support for enabling the snapshot feature based on the Kubernetes and CSI versions.	This change may interrupt backup jobs that are in progress.

March 2021

Version number	Registry Address	Change time	Change description	Impact
v1.3.1-3026c10-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.3.1-3026c10-aliyun	March 31, 2021	Upgrades the component uninstallation logic and fixes component issues.	This change may interrupt backup jobs that are in progress.
v1.3.1-665c3ea-aliyun	registry.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.3.1-665c3ea-aliyun	March 31, 2021	Adds support for cloud disk snapshots in registered clusters.	This change may interrupt backup jobs that are in progress.
v1.3.0-9274575-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.0.1.2-h-e616322-aliyun	March 29, 2021	Adds the cloud disk snapshot mode to support volume storage backups.	Ongoing backup tasks may be interrupted. To upgrade, please submit a ticket to contact the helpdesk.

December 2020

Version number	Registry Address	Change time	Change description	Impact of the change
v1.0.1.2-h-e616322-aliyun	registry.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.0.1.2-h-e616322-aliyun	December 24, 2020	Updates Velero for ACK registered clusters to the latest community version 1.5.2.	Ongoing backup tasks may be interrupted. To upgrade, please submit a ticket to contact technical support.
v1.0.1.2-a-e616322-aliyun	registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.0.1.2-h-e616322-aliyun	December 30, 2020	Updates Velero for ACK managed clusters and ACK dedicated clusters to the latest community version 1.5.2.	Ongoing backup tasks may be interrupted. To upgrade, please submit a ticket to contact the helpdesk.

September 2020

Version number	Registry Address	Change time	Change details	Impact
v1.0.1.1-30d319f-aliyun	registry.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.0.1.1-30d319f-aliyun	September 21, 2020	Adds support for application migration, backup, and restoration for ACK registered clusters and ACK managed clusters.	First release.