Environment Export
Apiqcloud made provision that, you can easily move environments between Clouds in order to find out which one meets your requirements. Two main stages include under the procedure
1. - export of the already existing environment (we’ll consider this operation in details below)
2. - subsequent of that environment to import to the target Apiqcloud installation.
The operations will take just a few minutes. In a result, you’ll get an identical ready-to-work copy of your environment being run at another Apiqcloud installation.
During the export, all information about the environment (i.e. its topology settings, deployed applications, links to the archives with configurations and private data it contains, etc) is packed into a single .json file. This compact JSON package can be simply downloaded to your local computer for being stored and/or deployed at another Apiqcloud platform.
So in order to export a copy of your environment, log into your Apiqcloud account and follow the instruction below:
1. Select Settings button for the environment you would like to export (named my-application in our case).
Note that environment should have the Running status for being exported.
2. In the opened Settings tab, navigate to the Export section and click on the same-named button.
3. Within the appeared Environment Export dialogue, you can choose which data should be exported (tick all options to get the fully identical environment copy):
- Topology Settings - environment configurations you’ve set through the Environment topology wizard (this point is obligatory and enabled by default)
- Private Data - files in directories of your deployed application(s) and private data stored within your database server(s)
- Configuration Files - all files, accessible via Configuration Manager at your dashboard, and settings of the deployed GIT/SVN projects (e.g. repositories links, access credentials, attached private SSH keys, etc)
Once the required for export data is defined, click the Export button to proceed.
- Docker and Windows-based containers cannot be exported currently
- Data from Elastic VPS and Maven nodes won’t be exported, though they will be still included to the topology of your imported environment, so you’ll be able to reconfigure these servers manually afterwards
- Private SSH key, exported alongside with the rest of GIT repository settings, can’t be deleted from the imported environment and is not shown at the dashboard, though it will still be used for a connection. Nevertheless, it will be substituted if choosing a new one within the GIT project’s settings window
4. Once the export is successfully finished, a new clickable string (named due to the export time/date) will appear in the Exported Environment Copies list. Select it to download the compiled .json file with exported environment data to your local machine, or just right click on it to copy direct URL to this manifest (which can be also used during import).
In addition, you’ll receive the appropriate email notification with a link to the list of your exported environments.
That’s all! You have successfully exported your environment copy. Now, you can proceed to its importing to the target platform in order to complete the migration.
