Jira Cloud Migration Assistant (JCMA) ですべてのダッシュボードを移行する方法
プラットフォームについて: サーバーと Data Center のみ。この記事は、サーバーおよび Data Center プラットフォームのアトラシアン製品にのみ適用されます。
目的
This document provides instructions on how Jira dashboards can be migrated via Jira Cloud Migration Assistant (JCMA) to Atlassian Jira Cloud. For a comprehensive list of all objects that JCMA will/will not migrate, see here: What gets migrated with the Jira Cloud Migration Assistant.
- この機能をすべての移行プランで有効にすることはしないでください。
Migrate dashboards as the last part of the migration, using a dummy project to initiate migration
Dashboard migration assumes that all dependencies such as projects, filters, software boards, sprints, etc. are already migrated to the cloud. Otherwise, dashboard migration may fail with incomplete status and dashboard gadget failure may occur. Follow How to migrate all boards and filters with the Jira Cloud Migration Assistant (JCMA) | Atlassian Cloud | Atlassian Documentation for cross-project boards and all filters migration. Note that dashboards may be migrated regardless of dependency issues, but may not be rendered properly in the cloud.
IMPORTANT: Support, CMMs, and customers should be aware that feature flags are experimental. We’ll do our best to offer support if these feature flags break migrations. However, we can't guarantee fixes or incident responses. Feature flags don’t cover all edge cases. If using these feature flags is your only option, test your migrations thoroughly with the feature flags enabled. You should consider manual workarounds when facing issues with feature flags.
- ダーク機能を管理するには、Jira 管理者である必要があります
- JCMA リリース 1.6.2 から利用できます
要約
JCMA のダッシュボード移行では現在、次の内容がサポートされます。
ダッシュボード、ダッシュボードの共有権限、ガジェット、ガジェット ユーザー設定の移行
再移行
Dashboards will not be duplicated due to re-migration.
ガジェットは重複する可能性があります (例外については警告をご確認ください)
Fix missing dependency from the previous migration
ダッシュボード名に重複がある場合は移行に失敗します。
ガジェットの参照 (プロジェクト、フィルター、カスタム フィールドなど) が削除されたときにダッシュボードの再移行を行うと、手動での介入なしで、破損したガジェットが再構築されます。
管理者は再移行のためにガジェットまたはそのガジェットを削除できます。JCMA 移行により、不足している項目が作成されます。
ソリューション
Jira ダッシュボードの移行は、JCMA でデフォルトでは有効化されていません。ダーク機能を使い、Jira Server/Data Center からダッシュボードを移行できます。ダーク機能の利用方法については「Jira でダーク機能を有効化する」をご確認ください。
これは移行プロセスの最後のステップで、すべてのプロジェクトを移行したあとに、移行を開始するためのダミー プロジェクトを使って行われます。
- 次の URL に移動します。<Jira URL>/secure/admin/SiteDarkFeatures!default.jspa
- Input dark feature: com.atlassian.jira.migration.dashboard-migration.feature
- [Add] をクリックします。
Limitations and Known Issues
No system dashboard support means admins will not be able to migrate their system dashboards from the server to the cloud.
システム ダッシュボードはサポートされないとは、管理者がサーバーからクラウドにシステム ダッシュボードを移行することはできないことを意味します。
No third party gadget support yet you could get the boards themselves migrated.
お気に入りのボード機能はサポートされません。
Crucible Charts、Fisheye Charts,、Bubble chart、Introduction gadget、および、Fisheye Recent ChangeSets ガジェットはサポートされません
カスタム フィールドを利用していた一部のガジェットは適切に動作しない可能性がありますが、ユーザーは移行後にそれらを開いて修正できます。
Minor display differences may occur but they are not blockers in operation.
If JCMA fails to migrate some dashboards, the plan will be in
INCOMPLETE
status. JCMA does not show migration progress of dashboard migration.
Error and Workarounds
During dashboard migration, JCMA tries to migrate everything it can. In the case of missing dependencies during the import phase, the related dashboard will still be migrated. However, it might not render properly depending on the errors. Please validate migrated dashboards on the Cloud side.
Example dashboard gadget when project dependency is missing
Workaround is to either
Manually fix the dashboard on the cloud side.
Contact support to debug which dependencies are missing. Fix them on the server side and trigger a dummy project migration again, so JCMA can fix the broken component during re-migration.