All Products
Search
Document Center

Container Service for Kubernetes:migrate-controller

Last Updated:Mar 26, 2026

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

Important

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 NamespaceMapping configuration 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 apiVersion upgrades for ingresses.extensions resources.

  • Supports automatic switchover for FlexVolume PVCs and PVs when restoring to a Container Storage Interface (CSI) cluster.

  • Adds an accessModes check when restoring cloud disk volumes.

  • Adds the imageRegistryMapping field for automatic transformation of image registry addresses.

Impact: This change may interrupt backup jobs that are in progress.

July 2024

Important

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.

Important

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 apiVersion when 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 InProgress state 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 preserveNodePorts parameter 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-alltype or alibabacloud-cnfs-nas.

Bug fixes

  • Fixes an issue where converting CNFS volumes to cloud disk snapshots remains in the InProgress state 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.