Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

On this page:

Table of Contents

...

minLevel1
maxLevel6
include
outlinefalse
indent
styledefault
exclude
typelist
class
printabletrue

Change how projects, configuration elements, and users get deployed

What makes the Configuration Manager for Jira (CMJ) Cloud a distinct admin tool is its ability to control how configurations will be deployed from one Jira Cloud site to another. You can decide how your projects, other configuration elements, and users will be deployed to the destination Jira Cloud site.

...

Info

What is mapping or configuration mapping?

Mapping or configuration mapping is an extensive map built by CMJ Cloud’s analysis process. It holds information on how the configuration elements in the deployment scope will be moved to the destination Jira Cloud site.

After reading this map, CMJ Cloud decides if it needs to:

  • create new elements,

  • merge matching source and destination elements, and

  • map destination elements to source elements without the need for updates to the destination.

Download and customize the default configuration mapping

Once you add projects to your deployment and reach the analysis phase, you'll have the Download mapping and Customize mapping buttons. You'll spot them at the top right of the Analyze changes page in the deployment wizard. For the exact locations of the Download mapping and Customize mapping buttons, watch the gif below.

...

You can take this file and make changes to it or construct your own mapping file and apply it to the configuration. For this purpose, you need to upload a mapping file with transformations to the Customize mapping action. Check out the guidelines for customizing the configuration mapping.

You can also check out the following use case page on Appfire's website to find more useful information and view a demo of how to customize the configuration mapping.

https://appfire.com/products/use-cases/modify-configuration-mapping-cloud-migration

Step-by-step guide for downloading and customizing configuration mapping

To customize the default configuration mapping:

  1. Start a deployment.

  2. On the Analyze changes page, click the Download mapping button on the top right.
    (info) You will get a JSON file with the default mapping for all projects, configuration elements, and users in the deployment scope.

    CMJC-download-and-customize-configuration.PNG
  3. Modify the JSON file to correct problems or change the deployment option of an element. Check the guidelines about customizing the configuration mapping.

  4. Click Customize mapping to upload the JSON file with the changes.

  5. Review the number of changed elements in the dialog. If there are no elements with problems reported, click Confirm to apply the transformations from the file.
    The video below shows how to upload and apply custom configuration mapping.

    CMJC-customize-mapping-fix-problems.mp4
  6. Once you're done with the transformations, click Deploy to move on with the deployment. When the deployment is done, the transformations applied through the JSON file will be tracked in the /wiki/spaces/DCMCMT/pages/143393070.

Info

After you click Confirm on the Customize mapping window, the CMJ Cloud performs a new analysis of the deployed configuration and applies the transformations from the file.