Salto enables you to copy entire Jira and JSM projects between any two Jira instances, including cloud-to-cloud and DC-to-DC migrations.
When copying a project, Salto allows you to carefully choose which configurations are copied and which aren't, to make sure you do not copy unnecessary elements.
Note that Salto only supports deploying Company managed projects, due to Atlassian API limitations.
Setup
To start, make sure you connected the two instances to Salto. You should see both environments on your left tab.
You can ensure that the project was successfully fetched by Salto, by reviewing it in your source environment's Explore tab. Go to Jira->Records->Projects to view all projects, or search for it by using the search bar at the top.
Starting a new deployment
Start a new deployment by clicking the Compare & Deploy button in the Compare & Deploy tab. Then, select your source and target environments, and provide a title (and an optional description) for this deployment.
Salto will display all the differences between these environments, including new additions, modifications, and deletions.
Selecting all project elements
Start by selecting the project element itself. You can find it by filtering for "Additions" (configurations which exist only in the source environment) and "Project" type configurations, then using the search box to locate your project.
Select it, then click the project element to see all its dependencies.
Start by reviewing and selecting the project's Required dependencies, highlighted in red: schemes, workflows, custom fields, etc. These must be deployed to ensure a successful deployment.
Then, review the additional dependencies for any elements that may not be strictly required but can be selected to ensure a complete migration. These include configurations that refer the project, such as automations or filters.
After selecting the project and its dependencies, you should also review the Missing Dependencies tab to identify any second-degree dependencies that have been detected. Whenever a new element is selected, Salto will automatically rerun this operation to identify and flag any additional sub-dependencies.
Finally, review the Dependencies tab which will show you any optional dependencies of any of the selected elements. You can select them if needed.
When you're done selecting all the elements to copy, click the Preview deployment button to prepare your deployment package.
Previewing and deploying your project
In the Preview screen, Salto flags any potential issues related to merging your selected changes, offering solutions to address them.
You can review issues by clicking the affected elements, or visit the Salto Validations tab to review all issues one by one.
Once you’re happy with everything included in your deployment, click Deploy to move them to the other instance.