Connector template migration script is designed and written in python 3.11.
The connector script helps to migrate connectors from Aspire 4.0 to Aspire 5.0.
The script is designed to be robust and easily extensible using templates with transformation matrices.
It can currently migrate the following connector types: Filesystem, SMB, SharePoint online.
The workflows are now ignored and not migrated.
There are implemented these features:
aspire-migration-component
Run Aspire 4.0 and Aspire 5.0
URL_ASPIRE = "http://localhost:50505/aspire/_api" # --- https with certificates # CA_CERTS = ('client-2048.crt', 'client-2048.key') # http = urllib3.PoolManager(cert_reqs='REQUIRED', ca_certs=CA_CERTS)
4. Run script
python __init.py__ -p smb_connector-content-source.zip
5. After few second connector is migrated to Aspire 5.0, objects "seed", "connection", "connector", "credential" created with description "migration-{date}".
You can also check the created report about migration "migration-{date}.log" which will be in the directory "reports" to see what exactly happened.
We can get information about script by command
python __init.py__ -h
Output
usage: __init__.py [-h] [-d DESC] [-v VER] [-p PATH] [-t TAGS] [-i IDS] Migration ASPIRE script. Migrate connector from ASPIRE version 4.0 to ASPIRE version 5.0 options: -h, --help show this help message and exit -d DESC, --desc DESC Custom description of all migrated ASPIRE objects (seed, connector, connection, credential) -v VER, --ver VER Version of transformation matrix. -p PATH, --path PATH Path to connector file zip. -t TAGS, --tags TAGS Tags for seed. -i IDS, --ids IDS Ids with should be used in seed or connection Check log after migration. All is well that ends well.
Templates are in directory "migration_template"
The structure of the project looks similary a situation below.
-- migration
-- migration_template
-- 4.1
-- default
-- aspire-filesystem-source
-- aspire-sharepointonline-source
-- aspire-smb-source
-- type_transform_matrix.json
Connectors can have different properties related to their version 4.0, 4.1, 5.0, 5.1 etc. When we want to work with different version than "default", we need to create new directory there "4.1" everything from directory "default" needs to be copied to this new directory. Changes needs to be done in "*_transform_matrix.json" for current connector.
After we are done with changes, script must to be run with other parameter "-v [name of new directory]"
python __init.py__ -v 4.1 -p smb_connector-content-source.zip