Clone an integration to create a copy of its flows, APIs, and tools that you can change, audit, or test in the same environment or in another one. The clone and the original are directly related, so after you clone you can pull changes between them in either direction. You clone the entire integration. You can't clone a single flow.
After you clone, you configure the clone's connections, and you might need to set up lookup caches and topics. For what a clone carries, see ILM supported resources and limits.
Prerequisites:
- You have Manage access to the integration, or you're an account owner or administrator. See Manage user roles & permissions to an account.
- To clone into another environment, the target environment is active, and you have Manage access or higher in both the source and target environments.
Clone an integration
- If your account has more than one environment, select the source environment at the top of the page.
- Go to Home
. Select the integration.
- In the integration header, select Clone integration.
- On the Clone integration page, enter the details:
- Name — Enter a unique name for the clone. Name is prefilled with "Clone - " and the integration name. You can rename the integration tile or a flow later.
- Description — Optionally, enter a description.
- Environment — Select the environment for the clone. You see only active environments where you have Manage access or higher. If you clone into another environment, you complete the clone's setup in that environment, either right away or later. See Create and manage multiple environments.
- Review the list of items in the new integration, including flows, APIs, tools, and other components.
- Select Clone integration.
A message asks whether to configure the clone now or later. If you cloned into a different environment, it asks whether to switch to that environment to configure the integration.
Configure the cloned integration
Connections aren't copied from the original integration, so you configure them for the clone. The Install integration page lists a numbered step for each connection. If the clone stays in the same environment, integrator.io preselects the connection that the original flows use. If you cloned into a different environment, select an existing connection in that environment or create one.
- For each connection step, select Configure. In the Set up connection panel, select Use existing connection and choose the connection, or select Set up new connection and enter the connection details. Then select Done.
- Choose a different connection for each connection in the original integration. See ILM supported resources and limits.
- For each lookup cache, reuse an existing lookup cache in the same environment, or clone it. See ILM supported resources and limits for when a clone keeps cache entries.
- After you complete every step, select Install. Install stays unavailable until you complete the connection steps.
For how to handle topics in a clone, including Start from, see ILM supported resources and limits.
Clone an integration from a ZIP file
If you don't have access to the production environment or the integration, you can upload an integration ZIP file that someone sent you to install the integration as a clone. A clone installed from a ZIP file isn't linked to the original integration, so you can't pull changes between them.
- Go to Home
. Select Upload.
- In the Upload an existing integration panel, select a file or drop the ZIP file. The file must be a .zip file of 1 MB or less.
- Review the list of components in the Upload integration panel, and then select Install integration.
- If a disclaimer appears, read it, and then select Proceed.
- Configure the connections. See Configure the cloned integration.
To create the ZIP file, see Install integration or download integration ZIP file.