JCMAt (Jira Cloud Migration Assistan) による移行時のプロジェクト名とプロジェクト キーの競合


アトラシアン コミュニティをご利用ください。


プラットフォームについて: Data Center のみ - この記事は、Data Center プラットフォームのアトラシアン製品にのみ適用されます。


When migrating from Server/DC to cloud, the Jira Cloud Migration Assistant runs a set of pre-checks to verify the Source and Destination do not have Projects with the same name or project key


Verify the Jira Cloud Migration Assistant app is installed. Create a new migration plan and select all projects or the desired projects you would like to migrate. Run the pre-check for the migration plan to scan the source projects and compare them with the destination projects on the cloud. If there is a conflict the output will look like the following:

Notice the Project section includes a dropdown arrow that can be extended. Selecting that will provide you with the exact projects that have a conflict:


Delete the Duplicate Project in Cloud

Make sure that the project in scope is one that was previously migrated by the JCMA and not a project that was already in production.

When you run a migration plan, data is migrated to the cloud. This data is never deleted by JCMA so any subsequent migration plan with the same project will fail to be migrated because the project already exists in the cloud. If you run into this scenario when running multiple tests, select Move to Trash from within the Project settings or while on the Project dashboard. Make sure to delete the project from the trash afterward:

  1. Choose  > Projects.
  2. サイドバーから [ごみ箱] を選択します。 
  3. 企業管理対象プロジェクトを見つけて、[•••] > [完全に削除する] の順に選択します。

Rename the Project on the Source Instance

If there is already an existing Project on the destination cloud site that is different than the source, the recommended approach is to rename the project on the Source instance. 

Editing the project key and/or project name

  1. Choose Administration () > Projects, and select the relevant project.
  2. 変更するプロジェクトを見つけます。
  3. 変更するプロジェクトの [アクション] 列で [編集] を選択します。
  4. Edit the project key and project name, and click Save details. Only project types for applications you have installed will be available.
NOTE: It might be the case that there is only a conflict with the name or key and not both. Verify by comparing the Project details on the source and destination. Changing a project key is more impactful and should be avoided if possible.

What to expect after editing a project key

The project will immediately begin re-indexing. This needs to complete before continuing with the migration plan. You can allow the re-index to run in the background. Critical changes are noted here: Editing a project key. Among those changes are as follows:


  • プロジェクトのエンティティ リンクの修正 — Jira を別のアトラシアン製品に接続している場合、Jira プロジェクトと他のアプリケーションの関連 "プロジェクト" (例: Confluence スペース) 間でエンティティ リンクが自動的に作成されます。Jira プロジェクトのキーを変更した場合、「プロジェクト間でリンクを作成する」の説明に従って、プロジェクトのエンティティ リンクを修正する必要があります。
  • Updating Jira Software agile board filters - If your Jira Software agile boards use the old project key, the board filters may need to be updated to reflect the new project key. Otherwise, the board might not display issues from the renamed project.
  • Links will appear to work on the source environment because they reference the original project key. However, once this project is migrated to the cloud, the links that still referenced the original project key will now be pointing to the cloud project. Here is a scenario that explains this behavior:
    • The Migration plan fails because there is a Source project ABC and an existing project ABC on the Destination cloud site.
    • The user changes the Source project from ABC to DEF to eliminate the conflict.
    • Links on the Source appear as https://jira.server.com/browse/ABC-123. After editing the project key, this link will redirect users to https://jira.server.com/browse/DEF-123 because Jira is aware of the original project key.
    • After migrating this project to the cloud, the link https://jira.server.com/browse/ABC-123 will be broken. It is possible that Atlassian support can update the base URL to point to the destination cloud. However, ABC-123 is the issue key of the existing project in the cloud and there is no longer any reference to the original project key from the source that retains this reference in the cloud.
  • The recommendation is to update these links manually on the source so that they point to the new project key DEF-123. Do this prior to migrating.

JQL クエリ

  • While the filters will appear to work on the source instance, they must be updated prior to migrating. Similar to links, these filters will reference the old project key and this data will not be preserved in the cloud. Only by updating the JQL queries can you best ensure that the data is migrated correctly. It's best to update board filters, dashboard filter gadgets, and any other global queries with the new key.


  • This functionality will be broken once the project is migrated to the cloud. 
  • Please make sure the expectation is set with all impacted users/developers.
  • Any development tooling will need to be reconfigured for the new project key. Make sure to check if the reconfiguration can occur on the development tool in use. That might not be the case for all of them.
最終更新日: 2022 年 1 月 11 日


Powered by Confluence and Scroll Viewport.