All Products
Search
Document Center

Container Service for Kubernetes:migrate-controller

Last Updated:Dec 12, 2024

The migrate-controller component is developed based on open source Velero. migrate-controller is deeply integrated with the snapshot technologies and Cloud Backup service of Alibaba Cloud. You can use migrate-controller to back up, restore, and migrate data and application templates. This topic introduces migrate-controller and describes the release notes for migrate-controller.

Introduction

For more information about how to install migrate-controller, see Install migrate-controller and grant permissions.

You can use migrate-controller to back up applications and persistent volumes (PVs) in your Kubernetes clusters. A variety of policies are supported to filter the applications that you want to back up. For example, you can back up applications based on namespaces, labels, and resource types. migrate-controller allows you to create disk snapshots and use Cloud Backup to back up files. migrate-controller also allows you to reduce the recovery time objective (RTO) of data restoration by using snapshots.

Usage notes

You can use migrate-controller to back up, restore, and migrate applications. For more information, see Back up and restore applications and Migrate applications across clusters in the same region.

Release notes

December 2024

Version number

Image address

Release date

Description

Impact

v1.8.3-5bb9107-aliyun

registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.3-5bb9107-aliyun

2024-12-05

  • The data protection feature is optimized.

    • Selecting PVCs for backup using multiple tags with the OR logical operator is supported.

    • Selecting PVCs for backup by specifying a list of StorageClasses is supported.

  • The Secrets referenced in volume backups are automatically appended, and their reference information is modified during restoration based on the NamespaceMapping configuration.

  • The IngressClasses specified by annotations in Ingress backups are automatically appended.

Ongoing backup tasks may be interrupted.

September 2024

Version number

Image address

Release date

Description

Impact

v1.8.2-deadfe3-aliyun

registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.2-deadfe3-aliyun

2024-09-18

  • Automatic upgrade for the apiVersion of the ingresses.extensions resources is supported.

  • Automatic failover of persistent volume claims (PVCs) and PVs managed by FlexVolume during the restoration of clusters that use Container Storage Interface (CSI) is supported.

  • The AccessModes field is checked during the restoration of disk volumes.

  • The imageRegistryMapping field is added for the automatic conversion of image repository addresses.

Ongoing backup tasks may be interrupted.

July 2024

Important

To update migrate-controller to v1.8.1-187f707-aliyun or later, the Kubernetes version of your Container Service for Kubernetes (ACK) cluster must be later than 1.20.

Version number

Image address

Release date

Description

Impact

v1.8.1-187f707-aliyun

registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.1-187f707-aliyun

2024-07-29

  • The display status of backup and recovery tasks is optimized.

  • The feature of specifying a backup name to restore the latest backup is supported.

  • The feature of skipping a specific backup task of the backup plan is supported.

  • The issue of backup failure caused by CSI throttling, which is triggerred by simultaneously backing up a large number of non-ESSDs is fixed.

Ongoing backup tasks may be interrupted.

May 2024

Version number

Image address

Release date

Description

Impact

v1.8.0-0d05f43-aliyun

registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.8.0-0d05f43-aliyun

2024-05-20

  • The authentication logic for accessing cloud resources in ACK managed clusters is optimized.

  • The issue that the IngressClass resources cannot be automatically backed up is fixed.

  • The feature of backing up volume data by namespace is supported.

Ongoing backup tasks may be interrupted.

Important

If this is the first time you install this version in a cluster within your Alibaba Cloud account or update to this version, you must click Cloud Resource Access Authorization to authorize ACK to access cloud resources. You need to complete the authorization only once for each Alibaba Cloud account.

April 2024

Version number

Image address

Release date

Description

Impact

v1.7.10-9211ff5-aliyun

registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.7.10-9211ff5-aliyun

2024-04-22

  • The issue related to monitoring data collection in the backup center is fixed.

  • Deployment issues of some sub-components in ACK Serverless clusters are fixed.

  • The backup process is accelerated when small amounts of volume and application data need to be backed up.

  • In clusters with earlier versions of the CSI plug-in installed, the default validity period of disk snapshots is changed to 30 days.

Ongoing backup tasks may be interrupted.

February 2024

Version number

Image address

Release date

Description

Impact

v1.7.9-a3e0c6a-aliyun

registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.7.9-a3e0c6a-aliyun

2024-02-22

  • PVCs can be restored from PVC backups.

  • The feature of skipping labeled volumes during data backup is supported.

  • The display of detailed information about partial cluster resource restoration failures is optimized.

  • The logic of temporary resource reclamation for backup and restoration processes is optimized.

  • If you use an ACK Edge cluster, the component is installed on an on-cloud node by default and accesses Object Storage Service (OSS) over an internal network.

Ongoing backup tasks may be interrupted.

December 2023

Version number

Image address

Release date

Description

Impact

v1.7.8-4cbd7cc-aliyun

registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.7.8-4cbd7cc-aliyun

2023-12-30

  • PVCs that use disks can be backed up and restored.

  • Off-tree storage drivers such as CephFS and RBD are supported.

  • The logic of StorageClass conversion and backup is optimized.

Ongoing backup tasks may be interrupted.

v1.7.7-1dfe3ba-aliyun

registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.7.7-1dfe3ba-aliyun

2023-12-04

  • Elastic Compute Service (ECS) disk volumes can be restored across regions.

  • A global backup timeout period can be specified for Velero applications.

  • The issue that the Cloud Backup token is missing after migrate-controller is reinstalled is fixed.

Ongoing backup tasks may be interrupted.

November 2023

Version number

Image address

Release date

Description

Impact

v1.7.6-1f392df-aliyun

registry-{{.Region}}-vpc.ack.aliyuncs.com/acs/velero-installer:v1.7.6-1f392df-aliyun

2023-11-03

  • Some data restore issues are fixed.

  • The API version is modified by default when the backup cluster and the restore cluster run different Kubernetes versions.

  • Applications and data can be backed up in clusters that use FlexVolume. However, applications and data can be restored only in clusters that use CSI.

  • Applications can be restored from backups that contain volume data.

  • Only partial namespaces can be restored from a backup consists of multiple namespaces.

  • The ARM64 architecture is supported.

Ongoing backup tasks may be interrupted.

September 2023

Version number

Image address

Release date

Description

Impact

v1.7.5-07179f2-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.7.5-07179f2-aliyun

September 25, 2023

  • Backup plans can be suspended.

  • By default, clusters whose Kubernetes or CSI versions are earlier than 1.18 use Cloud Backup to back up disks.

  • The issue that backup or snapshot tasks are stuck in the InProgress state is fixed.

  • Listeners are automatically disabled when you restore LoadBalancer Services that use existing Server Load Balancer (SLB) instances.

  • Applications can be backed up and restored in ACK Serverless clusters.

Ongoing backup tasks may be interrupted.

August 2023

Version number

Image address

Release date

Description

Impact

v1.7.4-05b90e7-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.7.4-05b90e7-aliyun

2023-08-15

  • Snapshots of other types can be recreated.

  • Connectivity check is supported for backup vaults and the backup synchronization interval can be specified.

  • Backups from other cloud service providers can be restored when CSI is used.

  • Cloud Backup can be used through the internal network by using Cloud Enterprise Network (CEN).

  • Data of backup vaults and backup tasks can be collected.

Ongoing backup tasks may be interrupted.

July 2023

Version number

Image address

Release date

Description

Impact

v1.7.2-7510a43-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.7.2-7510a43-aliyun

2023-07-10

  • Permission configuration issues in ACK dedicated clusters are fixed.

  • Expired backup tasks can be automatically deleted.

  • A namespace list can be configured to exclude namespaces from a backup plan when you create the backup plan.

  • The namespace setting of a backup plan can be automatically adjusted when the specified namespaces are deleted.

  • Snapshots can be created for custom storage types, including disks or File Storage NAS (NAS) file systems.

  • Standard log output is supported by hbr-client.

Ongoing backup tasks may be interrupted.

May 2023

Version number

Image address

Release date

Description

Impact

v1.7.1-dc3dd68-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.7.1-dc3dd68-aliyun

2023-05-30

NFS CSI drivers are supported by volume backup.

Ongoing backup tasks may be interrupted.

April 2023

Version number

Image address

Release date

Description

Impact

v1.7.0-38fb1fb-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.7.0-38fb1fb-aliyun

2023-04-26

  • The preserveNodePorts parameter can be specified to force the system to retain or change the NodePort of the application that you want to restore when you create a restore task.

  • Backup files can be used to restore applications and data when partial data is backed up by using Cloud Backup.

Ongoing backup tasks may be interrupted.

March 2023

Version number

Image address

Release date

Description

Impact

v1.6.12-ee49a53-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.12-ee49a53-aliyun

2023-03-10

  • migrate-controller is supported by ACK Edge clusters.

  • Custom preserveNodePorts are supported.

Ongoing backup tasks may be interrupted.

February 2023

Version number

Image address

Release date

Description

Impact

v1.6.11-e5b62fc-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.11-e5b62fc-aliyun

2023-02-10

  • The issue that the process of converting Container Network File System (CNFS) volumes to disk snapshots is stuck in the Inprogress state for a long period of time is fixed.

  • Snapshot conversion and restoration in multi-zone clusters are supported.

  • If you restore a backup file in a cluster that does not exist, the StorageClasses used to provision the volumes in the backup file are automatically changed to alicloud-disk-topology-alltype or alibabacloud-cnfs-nas.

Ongoing backup tasks may be interrupted.

December 2022

Version number

Image address

Release date

Description

Impact

v1.6.10-c2c6d70-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.10-c2c6d70-aliyun

2022-12-15

  • Backup of large namespaces is supported.

  • Issues related to the generation of hbr-client-token in special cases are fixed.

Ongoing backup tasks may be interrupted.

v1.6.9-9761639-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.9-9761639-aliyun

2022-12-02

The copy of a backup file that is synchronized to clusters is retained after you delete the backup file.

Ongoing backup tasks may be interrupted.

November 2022

Version number

Image address

Release date

Description

Impact

v1.6.8-582985c-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.8-582985c-aliyun

2022-11-07

  • The configurations of NodePort Services can be customized when the NodePort Services are restored.

  • The feature of restoring only application templates in a backup file is supported.

  • An admission controller is supported to block access to migrate-controller if the cluster uses the FlexVolume plug-in.

Ongoing backup tasks may be interrupted.

September 2022

Version number

Image address

Release date

Description

Impact

v1.6.7-3ac3f52-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.7-3ac3f52-aliyun

2022-09-23

  • The issue that specific API versions used by the CustomResourceDefinition (CRD) resource object are not supported when you back up applications is fixed.

  • The source cluster of an application can be queried when you restore the application.

Ongoing backup tasks may be interrupted.

v1.6.6-987b391-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.6-987b391-aliyun

2022-09-01

The backup process of the backup center is optimized.

Ongoing backup tasks may be interrupted.

August 2022

Version number

Image address

Release date

Description

Impact

v1.6.5-425ec0c-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.5-425ec0c-aliyun

2022-08-11

  • Backup files can be continuously synchronized among clusters.

  • Backup files can be used to restore resources in individual namespaces.

Ongoing backup tasks may be interrupted.

May 2022

Version number

Image address

Release date

Description

Impact

v1.6.3-6fd55d8-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.3-6fd55d8-aliyun

2022-05-11

  • The endpoints of virtual private clouds (VPCs) can be used to access ACK, container backup services, and container disaster recovery services.

  • Clusters that cannot connect to the Internet can be backed up.

Ongoing backup tasks may be interrupted.

March 2022

Version number

Image address

Release date

Description

Impact

v1.6.1-1af0d36-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.6.1-1af0d36-aliyun

2022-03-22

  • This image version is compatible with ACK clusters that run Kubernetes 1.22.

  • The issue that the expiration time of backup files is inconsistent is fixed.

  • The default node taints are supported by hbr-client.

Ongoing backup tasks may be interrupted.

December 2021

Version number

Image address

Release date

Description

Impact

v1.5.9-37df39a-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.5.9-37df39a-aliyun

2021-12-24

hbr-client is no longer deployed on each node but only on nodes that you specify.

Ongoing backup tasks may be interrupted.

November 2021

Version number

Image address

Release date

Description

Impact

v1.5.8-14de9e1-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.5.8-14de9e1-aliyun

2021-11-28

  • migrate-controller can be used in multi-cluster scenarios.

  • Snapshots of PVCs that are used to provision disk volumes can be created.

  • The concurrency of snapshot creation requests is improved.

  • Cross-region data restoration that uses snapshots is supported.

Ongoing backup tasks may be interrupted.

October 2021

Version number

Image address

Release date

Description

Impact

v1.5.6-94176c2-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.5.6-94176c2-aliyun

2021-10-12

The methods to back up file systems are optimized. The Cloud Backup client can be dynamically started.

Ongoing backup tasks may be interrupted.

v1.5.7-561a15f-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.5.7-561a15f-aliyun

2021-10-15

Internal access to Cloud Backup is optimized.

Ongoing backup tasks may be interrupted.

September 2021

Version number

Image address

Release date

Description

Impact

v1.5.5-d5e168a-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.5.5-d5e168a-aliyun

2021-09-20

  • The error message for backup failures is updated.

  • The issue that namespaces cannot be created when the system has ongoing data restore tasks is fixed.

  • The DaemonSet of the Cloud Backup client is no longer automatically deployed. You need to use Cloud Backup to manually deploy it.

  • Backslashes (\) are supported to specify the names of subdirectories in OSS buckets.

  • An error is reported when you back up a file system without having Cloud Backup enabled.

Ongoing backup tasks may be interrupted.

v1.5.2-d728be2-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.5.2-d728be2-aliyun

2021-09-10

  • Compatibility with earlier versions is supported.

  • Snapshot creation methods are upgraded.

  • Cloud Backup is used to back up files.

  • Disk snapshots and snapshots of File Storage NAS (NAS) file systems are supported to reduce the RTO of data restoration.

  • The permission control policies of ACK managed clusters are upgraded.

  • Restic is no longer supported to back up data.

Ongoing backup tasks may be interrupted.

July 2021

Version number

Image address

Release date

Description

Impact

v1.4.1-f745291-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.4.1-f745291-aliyun

2021-07-13

The snapshot feature can be enabled based on the Kubernetes version and the CSI plug-in version.

Ongoing backup tasks may be interrupted.

March 2021

Version number

Image address

Release date

Description

Impact

v1.3.1-3026c10-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.3.1-3026c10-aliyun

2021-03-31

The logic of component uninstallation is upgraded. Errors about components are fixed.

Ongoing backup tasks may be interrupted.

v1.3.1-665c3ea-aliyun

registry.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.3.1-665c3ea-aliyun

2021-03-31

Volume snapshots are supported in registered clusters.

Ongoing backup tasks may be interrupted.

v1.3.0-9274575-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.0.1.2-h-e616322-aliyun

2021-03-29

Volume snapshots are supported to back up volumes.

Ongoing backup tasks may be interrupted. If you want to update migrate-controller to this version,

submit a ticket to request technical support.

December 2020

Version number

Image address

Release date

Description

Impact

v1.0.1.2-h-e616322-aliyun

registry.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.0.1.2-h-e616322-aliyun

2020-12-24

Velero is updated to the open source version 1.5.2 in registered clusters.

Ongoing backup tasks may be interrupted. If you want to update migrate-controller to this version,

submit a ticket to request technical support.

v1.0.1.2-a-e616322-aliyun

registry-vpc.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.0.1.2-h-e616322-aliyun

2020-12-30

Velero is updated to the open source version 1.5.2 in ACK managed clusters and ACK dedicated clusters.

Ongoing backup tasks may be interrupted. If you want to update migrate-controller to this version,

submit a ticket to request technical support.

September 2020

Version number

Image address

Release date

Description

Impact

v1.0.1.1-30d319f-aliyun

registry.{{.Region}}.aliyuncs.com/acs/velero-installer:v1.0.1.1-30d319f-aliyun

2020-09-21

Application migration, backup, and restoration are supported in registered clusters and ACK managed clusters.

First version.