apk icon indicating copy to clipboard operation
apk copied to clipboard
verified publisher icon wso2

[Migration] Migration tool for APIM to APK migration

Open RakhithaRR opened this issue 3 years ago • 2 comments

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
  1. 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
  1. 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

migrationflow drawio

RakhithaRR avatar Mar 03 '23 12:03 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

RakhithaRR avatar May 18 '23 04:05 RakhithaRR

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

SavinduDimal avatar Jun 21 '23 05:06 SavinduDimal