migrate-controller is an ACK component built on the open source Velero project. It integrates with Alibaba Cloud ECS snapshots and Cloud Backup to back up, restore, and migrate Kubernetes application templates and persistent volume (PV) data.
Component introduction
migrate-controller backs up Kubernetes applications and PV data, with support for multiple filtering policies — by namespace, label, or resource type. For data backup, it supports both ECS cloud disk snapshots and Cloud Backup file-based backups. To reduce the Recovery Time Objective (RTO) during restoration, you can convert Cloud Backup file backups into snapshots.
For installation instructions, see Install the migrate-controller backup service component and configure permissions.
Usage instructions
Use migrate-controller to back up, restore, and migrate applications:
Change log
All releases may interrupt backup jobs that are in progress. Before upgrading, complete or cancel any running backup jobs.
September 2025
| Version | Registry address | Release date |
|---|---|---|
| v1.8.7-b5e0b99 | registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.7-b5e0b99 | September 15, 2025 |
New features
-
Supports adjusting volume capacity during restoration by transforming the StorageClass.
Optimizations
-
Improves the information displayed when a backup is partially successful.
Bug fixes
-
Fixes an occasional error that occurs when backing up cloud disk volumes using Cloud Backup.
Impact: This change may interrupt backup jobs that are in progress.
July 2025
| Version | Registry address | Release date |
|---|---|---|
| v1.8.6-17482bb-aliyun | registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.6-17482bb-aliyun | July 11, 2025 |
New features
-
Supports the ECS Metadata Server hardening mode.
-
Supports restoring data to an OSS StorageClass.
-
Displays the corresponding snapshot instance ID in backup results when a cloud disk volume is successfully backed up.
Optimizations
-
Improves concurrency logic for Cloud Backup restore jobs.
Bug fixes
-
Fixes an issue where associating a backup repository with a cluster for the first time occasionally fails.
Impact: This change may interrupt backup jobs that are in progress.
March 2025
| Version | Registry address | Release date |
|---|---|---|
| v1.8.5-566ac53-aliyun | registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.5-566ac53-aliyun | March 31, 2025 |
New features
-
Supports specifying the endpoint of an OSS bucket when creating a backup repository.
Optimizations
-
Improves concurrency logic for Cloud Backup jobs.
Bug fixes
-
Fixes a backup issue for multi-attach cloud disks.
Impact: This change may interrupt backup jobs that are in progress.
January 2025
| Version | Registry address | Release date |
|---|---|---|
| v1.8.4-9bc1d22-aliyun | registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.4-9bc1d22-aliyun | January 24, 2025 |
New features
-
Supports modifying the access modes (
accessModes) of volumes during a StorageClass transformation. -
Upgrades the Cloud Backup client to v2.25.1, adding support for additional regions including China (Guangzhou).
Optimizations
-
Improves error messages for StorageClass transformations.
Bug fixes
-
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 an in-progress backup.
-
Fixes an issue where Elastic Container Instance (ECI) instances cannot be restored in some scenarios.
Impact: This change may interrupt backup jobs that are in progress.
December 2024
| Version | Registry address | Release date |
|---|---|---|
| v1.8.3-5bb9107-aliyun | registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.3-5bb9107-aliyun | December 05, 2024 |
New features
-
Supports selecting multiple tags based on OR logic to specify the persistent volume claims (PVCs) to back up.
-
Supports specifying a list of StorageClasses to select the PVCs to back up.
-
Automatically appends Secret resources referenced by backed-up volumes, and automatically updates reference information based on the
NamespaceMappingconfiguration during restoration. -
Automatically appends IngressClass resources specified by annotations in the Ingress.
Impact: This change may interrupt backup jobs that are in progress.
September 2024
| Version | Registry address | Release date |
|---|---|---|
| v1.8.2-deadfe3-aliyun | registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.2-deadfe3-aliyun | September 18, 2024 |
New features
-
Supports automatic
apiVersionupgrades foringresses.extensionsresources. -
Supports automatic switchover for FlexVolume PVCs and PVs when restoring to a Container Storage Interface (CSI) cluster.
-
Adds an
accessModescheck when restoring cloud disk volumes. -
Adds the
imageRegistryMappingfield for automatic transformation of image registry addresses.
Impact: This change may interrupt backup jobs that are in progress.
July 2024
migrate-controller v1.8.1-187f707-aliyun and later require ACK version 1.20 or later.
| Version | Registry address | Release date |
|---|---|---|
| v1.8.1-187f707-aliyun | registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.1-187f707-aliyun | July 29, 2024 |
New features
-
Supports restoring the latest backup by specifying the backup plan name.
-
Supports skipping a specific backup job in a backup schedule.
Optimizations
-
Improves status display for backup and restore jobs.
Bug fixes
-
Fixes an issue where backing up many non-Enhanced SSD (ESSD) cloud disks simultaneously triggers CSI throttling and causes some backups to fail.
Impact: This change may interrupt backup jobs that are in progress.
May 2024
| Version | Registry address | Release date |
|---|---|---|
| v1.8.0-0d05f43-aliyun | registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.0-0d05f43-aliyun | May 20, 2024 |
New features
-
Supports backing up volume data by namespace.
Optimizations
-
Improves cloud resource authentication logic for ACK managed clusters.
Bug fixes
-
Fixes an issue where IngressClass resources cannot be automatically backed up.
Impact: This change may interrupt backup jobs that are in progress.
When installing or upgrading to this version for the first time in a cluster under your Alibaba Cloud account, click Authorize to grant permissions on cloud resources. This is a one-time operation for the entire Alibaba Cloud account.
April 2024
| Version | Registry address | Release date |
|---|---|---|
| v1.7.10-9211ff5-aliyun | registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.7.10-9211ff5-aliyun | April 22, 2024 |
Optimizations
-
Improves 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, for clusters running an earlier version of the CSI storage plug-in.
Bug fixes
-
Fixes a data collection issue for backup center monitoring.
-
Fixes a deployment issue for some subcomponents in ACK serverless clusters.
Impact: This change may interrupt backup jobs that are in progress.
February 2024
| Version | Registry address | Release date |
|---|---|---|
| v1.7.9-a3e0c6a-aliyun | registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.7.9-a3e0c6a-aliyun | February 22, 2024 |
New features
-
Supports backing up and restoring from one PVC to another.
-
Supports skipping specific volumes during data backup by adding tags.
-
For ACK Edge clusters: the component is now installed on cloud nodes by default and accesses OSS over the internal network.
Optimizations
-
Improves the details displayed when a partial cluster resource restoration fails.
-
Improves the logic for reclaiming temporary resources during backup and restoration.
Impact: This change may interrupt backup jobs that are in progress.
December 2023
| Version | Registry address | Release date |
|---|---|---|
| v1.7.8-4cbd7cc-aliyun | registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.7.8-4cbd7cc-aliyun | December 30, 2023 |
| v1.7.7-1dfe3ba-aliyun | registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.7.7-1dfe3ba-aliyun | December 04, 2023 |
v1.7.8 — New features
-
Supports backing up and restoring PVCs of the cloud disk type.
-
Supports out-of-tree storage drivers, including CephFS and RBD.
v1.7.8 — Optimizations
-
Improves backup logic for StorageClass transformation.
v1.7.7 — New features
-
Supports cross-region restoration of ECS cloud disk volumes.
-
Supports globally adjusting the timeout period for Velero application backups.
v1.7.7 — Bug fixes
-
Fixes an issue where the Cloud Backup token is missing after the component is reinstalled.
Impact: This change may interrupt backup jobs that are in progress.
November 2023
| Version | Registry address | Release date |
|---|---|---|
| v1.7.6-1f392df-aliyun | registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.7.6-1f392df-aliyun | November 03, 2023 |
New features
-
Supports backing up applications and data in FlexVolume clusters (data can be restored only to CSI clusters).
-
For backups that include volumes: supports restoring only the applications.
-
For backups that include multiple namespaces: supports restoring only a subset of namespaces.
-
Supports the ARM64 architecture.
-
Automatically adjusts
apiVersionwhen the Kubernetes versions of the source and destination clusters differ.
Bug fixes
-
Fixes several data restoration issues.
Impact: This change may interrupt backup jobs that are in progress.
September 2023
| Version | Registry address | Release date |
|---|---|---|
| v1.7.5-07179f2-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.7.5-07179f2-aliyun | September 25, 2023 |
New features
-
Supports pausing backup schedules.
-
Supports application backup and restoration in serverless Kubernetes (ASK) clusters.
-
For clusters running Kubernetes or CSI versions earlier than 1.18: cloud disk data is now backed up using Cloud Backup by default.
-
Automatically disables the force listener feature when restoring a LoadBalancer service that uses an existing Server Load Balancer (SLB) instance.
Bug fixes
-
Fixes an issue where backup or snapshot creation jobs remain in the
InProgressstate for an extended period in some cases.
Impact: This change may interrupt backup jobs that are in progress.
August 2023
| Version | Registry address | Release date |
|---|---|---|
| v1.7.4-05b90e7-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.7.4-05b90e7-aliyun | August 15, 2023 |
New features
-
Supports recreating snapshots of other types.
-
Supports customizing the connectivity check and backup synchronization interval for backup repositories.
-
Supports cross-cloud provider backup and restoration based on the CSI protocol.
-
Supports data collection for backup repositories and backup jobs.
-
Allows registered clusters connected through Cloud Backup to access Cloud Backup over the internal network.
Impact: This change may interrupt backup jobs that are in progress.
July 2023
| Version | Registry address | Release date |
|---|---|---|
| v1.7.2-7510a43-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.7.2-7510a43-aliyun | July 10, 2023 |
New features
-
Supports automatically clearing expired backup jobs in a cluster.
-
Supports excluding namespaces when creating a backup schedule.
-
Supports automatic adjustment when a namespace specified in a backup schedule is deleted.
-
Supports selecting custom StorageClasses of the cloud disk and Network Attached Storage (NAS) types when creating a snapshot.
-
Enables standard log output for the hbr-client component.
Bug fixes
-
Fixes a permission configuration issue for ACK dedicated clusters in some cases.
Impact: This change may interrupt backup jobs that are in progress.
May 2023
| Version | Registry address | Release date |
|---|---|---|
| v1.7.1-dc3dd68-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.7.1-dc3dd68-aliyun | May 30, 2023 |
New features
-
Supports the NFS CSI Driver for volume backups.
Impact: This change may interrupt backup jobs that are in progress.
April 2023
| Version | Registry address | Release date |
|---|---|---|
| v1.7.0-38fb1fb-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.7.0-38fb1fb-aliyun | April 26, 2023 |
New features
-
Supports forcing or changing the NodePort of an application by configuring the
preserveNodePortsparameter when creating a restore job. -
Supports using a partially successful Cloud Backup data backup to restore both the application and the successfully backed-up data.
Impact: This change may interrupt backup jobs that are in progress.
March 2023
| Version | Registry address | Release date |
|---|---|---|
| v1.6.12-ee49a53-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.12-ee49a53-aliyun | March 10, 2023 |
New features
-
Supports ACK Edge clusters.
-
Supports customizing
preserveNodePorts.
Impact: This change may interrupt backup jobs that are in progress.
February 2023
| Version | Registry address | Release date |
|---|---|---|
| v1.6.11-e5b62fc-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.11-e5b62fc-aliyun | February 10, 2023 |
New features
-
Supports snapshot transformation and restoration in multi-zone clusters.
-
When the destination cluster for restoration does not exist, automatically converts the StorageClass of volumes in the data backup to
alicloud-disk-topology-alltypeoralibabacloud-cnfs-nas.
Bug fixes
-
Fixes an issue where converting CNFS volumes to cloud disk snapshots remains in the
InProgressstate for an extended period.
Impact: This change may interrupt backup jobs that are in progress.
December 2022
| Version | Registry address | Release date |
|---|---|---|
| v1.6.10-c2c6d70-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.10-c2c6d70-aliyun | December 15, 2022 |
| v1.6.9-9761639-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.9-9761639-aliyun | December 02, 2022 |
v1.6.10 — New features
-
Supports backing up a large number of namespaces.
v1.6.10 — Bug fixes
-
Fixes an hbr-client-token generation issue in specific cases.
v1.6.9 — Changes
-
Retains replicas that are synced to the cluster when a backup is deleted.
Impact: This change may interrupt backup jobs that are in progress.
November 2022
| Version | Registry address | Release date |
|---|---|---|
| v1.6.8-582985c-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.8-582985c-aliyun | November 07, 2022 |
New features
-
Supports customizing the NodePort configuration during application restoration.
-
Supports restoring only application templates from a backup.
Changes
-
Blocks FlexVolume users in admission control.
Impact: This change may interrupt backup jobs that are in progress.
September 2022
| Version | Registry address | Release date |
|---|---|---|
| v1.6.7-3ac3f52-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.7-3ac3f52-aliyun | September 23, 2022 |
| v1.6.6-987b391-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.6-987b391-aliyun | September 01, 2022 |
v1.6.7 — New features
-
Supports querying the source cluster of a backup during application restoration.
v1.6.7 — Bug fixes
-
Fixes an issue where some Custom Resource Definition (CRD) versions are not supported during application backup.
v1.6.6 — Optimizations
-
Improves the backup process in the backup center.
Impact: This change may interrupt backup jobs that are in progress.
August 2022
| Version | Registry address | Release date |
|---|---|---|
| v1.6.5-425ec0c-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.5-425ec0c-aliyun | August 11, 2022 |
New features
-
Supports continuous synchronization of cross-cluster backups.
-
Supports backup and restoration at the individual namespace level.
Impact: This change may interrupt backup jobs that are in progress.
May 2022
| Version | Registry address | Release date |
|---|---|---|
| v1.6.3-6fd55d8-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.3-6fd55d8-aliyun | May 11, 2022 |
New features
-
Supports accessing the container disaster recovery and backup service and Container Service using VPC domain names.
-
Supports backing up clusters without public network access.
Impact: This change may interrupt backup jobs that are in progress.
March 2022
| Version | Registry address | Release date |
|---|---|---|
| v1.6.1-1af0d36-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.1-1af0d36-aliyun | March 22, 2022 |
New features
-
Compatible with Kubernetes version 1.22 clusters.
-
Adds support for default node taints in hbr-client.
Bug fixes
-
Fixes an issue with mismatched backup expiration times.
Impact: This change may interrupt backup jobs that are in progress.
December 2021
| Version | Registry address | Release date |
|---|---|---|
| v1.5.9-37df39a-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.5.9-37df39a-aliyun | December 24, 2021 |
Changes
-
The hbr-client is now deployed on demand instead of on every node.
Impact: This change may interrupt backup jobs that are in progress.
November 2021
| Version | Registry address | Release date |
|---|---|---|
| v1.5.8-14de9e1-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.5.8-14de9e1-aliyun | November 28, 2021 |
New features
-
Supports multiple clusters.
-
Supports creating snapshot backups for PVCs of the cloud disk type.
-
Supports cross-region snapshot backups.
Optimizations
-
Improves concurrency for snapshot creation.
Impact: This change may interrupt backup jobs that are in progress.
October 2021
| Version | Registry address | Release date |
|---|---|---|
| v1.5.7-561a15f-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.5.7-561a15f-aliyun | October 15, 2021 |
| v1.5.6-94176c2-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.5.6-94176c2-aliyun | October 12, 2021 |
v1.5.7 — Optimizations
-
Improves the logic for internal access to Cloud Backup.
v1.5.6 — Optimizations
-
Improves the file system backup method.
-
Supports dynamically enabling the Cloud Backup client.
Impact: This change may interrupt backup jobs that are in progress.
September 2021
| Version | Registry address | Release date |
|---|---|---|
| v1.5.5-d5e168a-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.5.5-d5e168a-aliyun | September 20, 2021 |
| v1.5.2-d728be2-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.5.2-d728be2-aliyun | September 10, 2021 |
v1.5.5 — New features
-
Supports using backslashes (
\) in OSS subdirectory paths.
v1.5.5 — Optimizations
-
Updates the error message for failed backups.
-
Adds an error message when backing up file system data without enabling the Cloud Backup service.
v1.5.5 — Changes
-
The DaemonSet for the Cloud Backup client is no longer automatically installed by default. To use Cloud Backup, install the client manually.
v1.5.5 — Bug fixes
-
Fixes an issue where namespace creation fails during data restoration.
v1.5.2 — New features
-
Supports converting Cloud Backup file backups to cloud disk snapshots and NAS snapshots to reduce the RTO during restoration.
v1.5.2 — Changes
-
Compatible with earlier versions.
-
Upgrades the snapshot creation method.
-
Upgrades file backups to use Cloud Backup.
-
Upgrades the access control policy for ACK managed clusters.
-
Discontinues support for using Restic to back up data.
Impact: This change may interrupt backup jobs that are in progress.
July 2021
| Version | Registry address | Release date |
|---|---|---|
| v1.4.1-f745291-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.4.1-f745291-aliyun | July 13, 2021 |
New features
-
Supports enabling the snapshot feature based on the Kubernetes and CSI versions of the cluster.
Impact: This change may interrupt backup jobs that are in progress.
March 2021
| Version | Registry address | Release date |
|---|---|---|
| v1.3.1-3026c10-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.3.1-3026c10-aliyun | March 31, 2021 |
| v1.3.1-665c3ea-aliyun | registry.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.3.1-665c3ea-aliyun | March 31, 2021 |
| v1.3.0-9274575-aliyun | registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.0.1.2-h-e616322-aliyun | March 29, 2021 |
v1.3.1-3026c10 — Changes
-
Upgrades the component uninstallation logic and fixes component issues.
v1.3.1-665c3ea — New features
-
Supports cloud disk snapshots in registered clusters.
v1.3.0 — New features
-
Adds the cloud disk snapshot mode to support volume storage backups.
Impact: Ongoing backup tasks may be interrupted. To upgrade v1.3.0, submit a ticketsubmit a ticketsubmit a ticket to contact the helpdesk.
December 2020
| Version | Registry address | Release date |
|---|---|---|
| v1.0.1.2-h-e616322-aliyun | registry.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.0.1.2-h-e616322-aliyun | December 24, 2020 |
| 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 |
v1.0.1.2-h — Changes
-
Updates Velero for ACK registered clusters to community version 1.5.2.
Impact: Ongoing backup tasks may be interrupted. To upgrade, submit a ticketsubmit a ticketsubmit a ticket to contact technical support.
v1.0.1.2-a — Changes
-
Updates Velero for ACK managed clusters and ACK dedicated clusters to community version 1.5.2.
Impact: Ongoing backup tasks may be interrupted. To upgrade, submit a ticketsubmit a ticketsubmit a ticket to contact the helpdesk.
September 2020
| Version | Registry address | Release date |
|---|---|---|
| v1.0.1.1-30d319f-aliyun | registry.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.0.1.1-30d319f-aliyun | September 21, 2020 |
New features
-
Supports application migration, backup, and restoration for ACK registered clusters and ACK managed clusters.
Impact: First release.