Updated on 2024-07-23 GMT+08:00

Preparations

Hardware Resources

Before the migration, ensure that you have prepared a server with kubectl installed to enable networking between the source cluster and the destination cluster. The server must have at least 5 GB local disk space and at least 8 GB memory for the migration tool to work properly and store related data, such as collected data of the source cluster and recommendation data of the destination cluster.

The migration tool can run on Linux (x86 and Arm) and Windows, meaning that the server can run on these OS types.

Tool Package

Tool-based migration has been implemented throughout the cluster evaluation, image migration, application backup, and application migration phases. You need to download these tools in advance and upload them to the preceding server.

Before using the following tools in Linux OSs, run the chmod u+x tool name command (for example, chmod u+x kspider-linux-amd64) to grant the execute permission.

Table 1 Preparations

Tool

Description

Download Link

Remarks

kspider

kspider is a tool used to collect information about the source cluster. It provides cluster-related data such as the Kubernetes version, scale, workload quantity, storage, and in-use images. The data helps you understand the current status of the cluster and evaluate migration risks, and select a proper destination cluster version and scale.

Linux (x86):

https://ucs-migration-intl.obs.ap-southeast-3.myhuaweicloud.com/toolkits/kspider-linux-amd64

Linux (Arm):

https://ucs-migration-intl.obs.ap-southeast-3.myhuaweicloud.com/toolkits/kspider-linux-arm64

Windows:

https://ucs-migration-intl.obs.ap-southeast-3.myhuaweicloud.com/toolkits/kspider-windows-amd64.exe

These tools can run on Linux (x86 and Arm) and Windows. After the tool package is decompressed, two binary files and one application are obtained, which are applicable to Linux and Windows, respectively.

kspider includes:

  • kspider-linux-amd64
  • kspider-linux-arm64
  • kspider-windows-amd64.exe

image-migrator includes:

  • image-migrator-linux-amd64
  • image-migrator-linux-arm64
  • image-migrator-windows-amd64.exe

k8clone includes:

  • k8clone-linux-amd64
  • k8clone-linux-arm64
  • k8clone-windows-amd64.exe

image-migrator

image-migrator is an image migration tool that can automatically migrate images from the Docker image repository built on Docker Registry v2 to SWR, or from the image repository on a third-party cloud to SWR.

Linux (x86):

https://ucs-migration-intl.obs.ap-southeast-3.myhuaweicloud.com/toolkits/image-migrator-linux-amd64

Linux (Arm):

https://ucs-migration-intl.obs.ap-southeast-3.myhuaweicloud.com/toolkits/image-migrator-linux-arm64

Windows:

https://ucs-migration-intl.obs.ap-southeast-3.myhuaweicloud.com/toolkits/image-migrator-windows-amd64.exe

k8clone

k8clone is an easy-to-use Kubernetes metadata cloning tool. It can save Kubernetes metadata (objects) as a local package and restore the metadata to the destination cluster.

Linux (x86):

https://ucs-migration-intl.obs.ap-southeast-3.myhuaweicloud.com/toolkits/k8clone-linux-amd64

Linux (Arm):

https://ucs-migration-intl.obs.ap-southeast-3.myhuaweicloud.com/toolkits/k8clone-linux-arm64

Windows:

https://ucs-migration-intl.obs.ap-southeast-3.myhuaweicloud.com/toolkits/k8clone-windows-amd64.exe