Below are instructions on how to migrate the AssertThat BDD, Cucumber & Cucumber Test Management for Jira plugin from Jira Server or Data Center to Jira Cloud
Differences between Server/DC and Cloud versions of the app
Feature | Jira Server/Data Center | Jira Cloud |
---|---|---|
Features/scenarios upload and management |
|
|
Scenario Manager |
|
|
Traceability Matrix |
|
|
Automated Test Report |
|
|
Link Scenarios to User Stories |
|
|
Manual Scenarios execution |
|
|
AssertThat Test Plans |
|
*Being implemented
*AssertThat Test Plan (Server and Data Center) is not currently available on Jira Cloud. This functionality is being implemented and will be available soon. Please refer to https://www.assertthat.com/post/roadmap-q1-2022-q2-2022
|
\uD83D\uDCD8Â Migration instructions
Prerequisites:
Install https://marketplace.atlassian.com/apps/1219033/assertthat-bdd-cucumber-for-jira?tab=overview&hosting=cloud plugin on your Jira Cloud instance
Enable AssertThat BDD
...
, Cucumber & Test Management plugin for the projects
...
that you are going to migrate on the Cloud instance.
...
Download and install Python on the instance you are going to use for running migration scripts https://www.python.org/downloads/
Note |
---|
In order to retain the linkage between scenarios and user stories Jira Server/DC project key and Jira Cloud project key should match exactly. |
Migration steps
Clone repository https://bitbucket.org/AssertThat/assertthat-bdd-cloud-migration/src/master/
Install dependencies. Run
pip install -r requirements.txt
Update global configuration in ./config/global.json
Code Block language json { "jira_server_url": "http://mycompany-jira.com", "jira_server_username": "", "jira_server_password": "", "jira_cloud_url": "https://mycompany.atlassian.net", "jira_cloud_username": "admin@example.com", "jira_cloud_api_token": "", "asserttthat_host": "https://bdd.assertthat.app" }
jira_server_url - The
...
URL of your Jira server or Data Center instance e.g https://jira.mycompany.com
jira_server_username - The username of the Jira Server/DC user
...
with admin access to
...
projects
...
.
jira_server_password - The password of the Jira Server/DC user
...
with admin access to
...
projects
...
.
jira_cloud_url - The URL of the cloud Jira instance where the projects are being migrated to e.g. https://mycompany.atlassian.net
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
jira_cloud_api_token - API token of the Jira cloud user used in jira_cloud_username https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/
asserttthat_host - Leave as the default set to https://bdd.assertthat.appRun ‘get-server-projects.py' script, which will create a file ./output/server-projects.json
Code Block language py python get-server-projects.py
Explore the ./output/server-projects.json and exclude projects
...
that are out of scope of the migration.
For each project in ./output/server-projects.json fill in the corresponding Jira cloud project details
jira_cloud_project_id, assertthat_access_key, assertthat_secret_key which can be found on project configuration page in Jira Cloud
...
Run 'migrate-config.py' which will migrate
...
project configurations from Jira Server/DC to Cloud
Code Block language py python migrate-config.py
Run 'migrate-features.py' which will migrate the features from Jira Server/DC to Cloud
Code Block language py python migrate-features.py
Run 'migrate-executions.py' which will migrate manual execution results for each of the Scenarios
...
that are linked to the Jira story.
Code Block language py python migrate-executions.py
Run Re-indexing https://assertthat.atlassian.net/wiki/spaces/ABTM/pages/2192211987/Using+AssertThat+scenario+properties+in+JQL+search#Reindexing
In case of any issues or questions please reach us at support@assertthat.com
...