Prerequisites for automated migration

Before you perform the migration steps, you need to make sure that you have met the prerequisites discussed in this section. Both Export and Import activities have their own set of prerequisites to adhere to.

Prerequisites for export

You need to make sure that you have:

1. The Export XML file available in GitHub.
   You can generate the Export XML file by following the instructions given on this page.
2. The Linux OS installed on your system and you have installed the following tools/plugins:
   

   1. Helm

   2. kubectl client

   3. Jenkins

      If you have Jenkins installed on Windows OS, you need to add a Linux agent in Jenkins. Refer to this page to know how to create a Linux agent.

   4. Java 1.8+

3. Installed the following Jenkins plugins:

   1. Kubernetes

   2. Git (git plugin 4.8.3, Git client plugin 3.9.0)

   3. Mask Password

   4. Credentials Binding plugin (1.27)

   5. Parameter Separator (Optional)

   6. BlueOcean (Optional)

4. The access to the source Kubernetes environment where the application is installed.
5. The access to GitHub repository where you have placed the Export XML file.

6. Created the credential IDs for GitHub, database, and Kubernetes in Jenkins. You can do so by following the instructions given here.

   You can generate credential IDs in Jenkins by using Credentials Binding plugin that helps you store an application's credentials in Jenkins. As you store the credentials in Jenkins, a credential ID is generated which is accessible globally in Jenkins and can be used in lieu of the actual credentials for the application. 

   a. To create the Credential ID for GitHub and database, you need to select the type of credentials as Username and password.

   b. To create the Credential ID for Kubernetes in Jenkins, you need to select the type of credentials as Secret file. 

Prerequisites for import

You need to make sure that you have:

1. The Export ZIP file is ready.
2. The Import and Retain XMLs are available in GitHub.
3. Met the rest of the prerequisites same as that for Export.