APIIDA API Gateway Manager

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 10 Next »

Migration Overview

The source in this case is the git repository of the API demo in version 2.0. This API requires the library demo, which is not available on the target.

Perform

The migration is carried out with Perfrom. You will then receive a detailed overview.

https://apiida.atlassian.net/wiki/spaces/AAGM/pages/1520009389/Migrations#Performing-a-Migration

Test

With Test, the migration is only tested, not carried out.

https://apiida.atlassian.net/wiki/spaces/AAGM/pages/1520009389/Migrations#Testing-a-Migration

Assign

Assign can be used to commission another user to carry out the migration. If configured, this user is informed. Not every user must have the rights to carry out a migration.

https://apiida.atlassian.net/wiki/spaces/AAGM/pages/1534165110/Users#Permission-groups-(RBAC)

Integration: E-Mail

Download

With Download all resources of the migration can be downloaded. These include all folders that are necessary for a successful migration, the logs if the migration has already been tested or carried out, all mappings for each target, the original, unmodified bundle from Restman, the prepared bundle adapted by the Gateway Manager and prepared for the migration.

Mappings

For each resource to be migrated, there is a mapping for each target. You can use the search to search and filter by both the name of the resource and the type.

Mappings can also be adjusted manually, but be careful!

The resources you select are automatically set to NewOrUpdate and overwrite the default mappings. In combination with the search and the checkboxes, it is possible to change many mappings at once. You can customise the mappings for each destination.

With the turquoise buttons on the far right of each mapping, the selected action can be saved as default.

Pipeline

In "Pipeline" you can perform various actions before and after the migration, such as "Disable via Admintools" or "Call an URL via GET". Default values can be set in Environments .

Template Variables

You should only edit the "Template Variables" if you know what you are doing.

Test the Migration

With "Create folder tree on destination(s)" the entire folder tree is mapped in the destination. Otherwise, the gateway would only create a maximum of two levels.

Perform the Migration

With "Deactivate Migrated APIs" you can play the newer version of the APIs on the gateways, but leave the old one active.

"Create folder tree on destination(s)" behaves identically as described in "Test".

Migration Results after

Test

After testing the migration, they get an overview of the results, the entire XML and the logs.

After testing the migration, they get an overview of the results, the entire XML and the logs. You can also download the folders, mappings, the bundle and more.

Perform

There is no such thing as an only partially successful migration! If something fails in the migration, the entire migration is not carried out. Your gateway will not be in an undefined state.

Revert Migration

With "Revert Migration" you can completely undo a migration that has been carried out.

It is intended as an immediate recovery. If the gateway's resources have changed in the meantime, unpredictable things can happen.

  • No labels