[Migration] Migration tool for APIM to APK migration

[RakhithaRR]

Description:

A new migration tool will be developed to to facilitate the the cross product migration from API Manager to APK. This implementation will be different from the existing APIM migration client. This new tool will have 3 main components namely; Extractor, Transformer, and Loader. This issue is created to track the progress of the implementation.

1. Extraction

   • Data extraction is done through Extractor component
   • This includes 2 sub-components Server - A webapp which should be added to APIM in order to generate the necessary data models Client - A java command line tool which pulls data from APIM and saves them in the local file system
   • Supports extracting API and Application related data.
   • Data is saved in json format organization-wise (per tenant). Only 1 file is created per API/Application which includes all data related to the artifact
   • Thumbnails, documents, etc. will also be available in the same json file as base64 encoded data

2. Transformation

• Data transformation is done through the Migrator component
• This is also a java command line tool
• Converts the previously extracted data to data models available in APK
• Transformed data is saved in the file system Model data is saved in the json format Other artifacts (if any) such as thumbnails, documents, etc. will be saved in their relevant format
• Some data will not be transformed based on the feature availability on APK. All such information will be logged in migrator’s log file

3. Loading

• Loading data is also done through the Migrator component
• This can be done independently from the Transformation based on the input arguments provided to the java command line tool
• Loading is done through the REST APIs available in APK
• Currently supports loading following artifacts Organizations Runtime APIs

[RakhithaRR]

Initial milestone release [1] of the APIM 3.2.0 to APK migration client was released on 16th May 2023

[1] - https://github.com/wso2-enterprise/apim-migration-resources/releases/tag/v3.2.0.1-m1

[SavinduDimal]

Forward port: apk-conf related changes to 4.x.0 versions.

• [x] https://github.com/wso2/apk/issues/1280
• [x] https://github.com/wso2/apk/issues/1315
• [x] https://github.com/wso2/apk/issues/1620