/
Migrating from Cloud to another Cloud instance

Migrating from Cloud to another Cloud instance

Below are instructions on how to migrate AssertThat BDD, Cucumber & Test Management plugin from Jira Cloud to another cloud instance

 Migration instructions

Prerequisites:

  1. Install https://marketplace.atlassian.com/apps/1219033/assertthat-bdd-cucumber-for-jira?tab=overview&hosting=datacenter plugin on your target Jira Cloud instance

  2. Enable AssertThat BDD & Cucumber for Jira plugin for the projects that you are going to migrate on the Cloud instance. AssertThat Configuration & Enable for project

  3. Download and install Python on the instance you are going to use for running migration scripts https://www.python.org/downloads/

In order to retain the linkage between scenarios and user stories source Jira Cloud project key and target Jira Cloud project key should match exactly.

Migration steps

  1. Clone repository https://bitbucket.org/AssertThat/assertthat-bdd-cloud-to-cloud-migration/src/main/

  2. Install dependencies. Run
    pip install -r requirements.txt

  3. Update global configuration in ./config/global.json

    { "source_jira_cloud_url": "https://mycompany.atlassian.net", "source_jira_cloud_username": "user-admin@example.com", "source_jira_cloud_api_token": "", "source_default_assertthat_access_key": "", "source_default_assertthat_secret_key": "", "source_assertthat_host": "https://bdd.assertthat.app", //do not change "target_jira_cloud_url": "https://assertthat-dev.atlassian.net", "target_jira_cloud_username": "user-admin@example.com", "target_jira_cloud_api_token": "", "target_assertthat_host": "https://bdd.assertthat.app" //do not change }


    source_jira_cloud_url - The URL of the cloud Jira instance where the projects are being migrated from e.g. https://mycompany.atlassian.net
    source_jira_cloud_username - The email address of the Jira Cloud user which has Browse users and groups global permission. More details here https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-users/#api-rest-api-3-users-search-get
    source_jira_cloud_api_token - API token of the Jira cloud user used in source_jira_cloud_username https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/
    source_default_assertthat_access_key - pick one project where the AssertThat plugin is enabled on the Cloud instance and get the access key from the plugin configuration page AssertThat Configuration & Enable for project
    source_default_assertthat_secret_key - pick one project where AssertThat plugin is enabled on Cloud instance and get the secret key from the plugin configuration page AssertThat Configuration & Enable for project
    source_asserttthat_host - Leave as default set to https://bdd.assertthat.app
    target_jira_cloud_url - The URL of the cloud Jira instance where the projects are being migrated to e.g. https://mycompany.atlassian.net
    target_jira_cloud_username - The email address of the Jira Cloud user which has Browse users and groups global permission. More details here https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-users/#api-rest-api-3-users-search-get
    target_jira_cloud_api_token - API token of the Jira cloud user used in target_jira_cloud_username Manage API tokens for your Atlassian account | Atlassian Support
    target_asserttthat_host - Leave as default set to https://bdd.assertthat.app

  4. Run ‘get-projects.py' script, which will create a file listing the cloud projects for migration ./output/source-projects.json

    python get-projects.py

  5. Explore the ./output/source-projects.json and remove projects that are out of scope of the migration.

  6. For each project in ./output/source-projects.json fill in the corresponding Jira Cloud source project details source_assertthat_access_key, source_assertthat_secret_key, and Jira Cloud target project details - source_assertthat_access_key, source_assertthat_secret_key, target_jira_project_id which can be found on the project configuration page in Jira Cloud AssertThat Configuration & Enable for project

  7. Run 'migrate-config.py' which will migrate project configurations from source to target Jira Cloud

    python migrate-config.py

  8. Run 'migrate-features.py' which will migrate the features

    python migrate-features.py

  9. Run 'migrate-executions.py' which will migrate manual execution results for each of the Scenarios that are linked to Jira story.

    python migrate-executions.py

     

  10. Run Re-indexing Using AssertThat scenario properties in JQL search | Reindexing

In case of any issues or questions please reach us at support@assertthat.com