Jira Cloud Migration Assistant を使用した移行

descriptionJira Cloud Migration Assistant を使用して Jira Server から Jira Cloud にプロジェクトを移動するためのステップバイステップの手順。

Jira Cloud Migration Assistant は、サーバー上の Jira Core または Software のプロジェクト、ユーザー、およびグループを簡単にクラウドに移動するために役立つアプリです。このアプリの構築と保守はアトラシアンが行なっています。アプリは無料でインストールおよび使用できます。

インストール後、クラウドへの移動対象を選択し、好きなタイミングで移行を開始できます。移行プロセスの間は、すべての項目の進捗状況を監視できます。

サーバー製品と Data Center 製品の重要な変更

当社はサーバー製品と Data Center 製品に変更を行っています。2021 年 2 月 2 日に新しいサーバー ライセンスの販売が終了、2024 年 2 月 2 日にサーバー製品のサポートが終了することも含まれます。変更の内容については、こちらでご確認ください。

Jira Cloud Migration Assistant を 使用する タイミング

次の場合に Jira Cloud Migration Assistant を使用します。

  • サーバーからクラウドへ、Jira Software または Core を移行する
  • You want to migrate only some projects from server to cloud. 
  • You are migrating to a new or existing cloud site.  

Learn more about the compatibility of the Jira Cloud Migration Assistant. 


Jira Cloud Migration Assistant では、Service プロジェクトまたは Confluence スペースを移行することはできません。すべての移行方法を確認して、お客様の状況に適した方法を見つけてください。


サーバーからクラウドへの移行に関する準備とプランには、弊社の移行ガイドをご利用ください。 

Jira Cloud Migration Assistant について

Jira Cloud Migration Assistant を使用する移行は、Jira のサイト インポート機能の使用とは異なります。このツールを使用する前に、次の点をご確認ください。

  • データの上書きまたは削除は行いません。Jira Cloud Migration Assistant でデータを移行すると、それはクラウド サイトにすでに存在するデータに追加されます。サーバーまたはクラウド サイトからデータが削除されることはありません。

  • 一部のデータがリンクされます。複数回の移行を行う場合、重複を防ぐためにデータのリンクが試行されます。データのリンク方法についてご確認ください。 
  • Jira Core and Jira Software data only. With the latest version of the Jira Cloud Migration Assistant, you can migrate Jira Core or Software projects with most fields supported. It does not yet support Jira Service Management (formerly Jira Service Desk) or some custom fields. Check out the latest updates for what can and can’t be migrated.

  • クラシック プロジェクトのみ。Jira Cloud の次世代プロジェクトへの移行はサポートされていません。 

Jira Cloud Migration Assistant を移行に使用するのを決定する前に、Jira Cloud Migration Assistant で移行可能なデータを確認することをおすすめします。 

はじめる前に

テストまたは本番環境の移行を試行する前に、移行前のチェックリストで Jira Cloud Migration Assistant 用のすべてのステップを完了していることをご確認ください。このチェックリストは、移行に向けて環境やデータを準備し、移行の失敗となる一般的な原因を回避するのにも役立ちます。

Jira バージョン 8.14 を使用している場合、移行アシスタントは自動的にサーバー インスタンスにインストールされます。

Jira Cloud Migration Assistant アプリのインストール (Jira 7.6 以降)

アプリケーションのインストール手順は、次のとおりです。

  1. In Jira Server or Data Center go to Settings > Manage apps.
  2. [新しいアプリを見つける] を選択して「Jira Cloud Migration Assistant」を検索します。
  3. [インストール] を選択したら完了です。

Atlassian Marketplace からインストールすることもできます。

You can access the migration assistant by going to Settings > System > look for the Import and Export category > select Migrate to cloud.

移行アシスタントが見つからない場合、Jira のサポート対象バージョンを利用しているかどうかをご確認ください。

ご利用の Jira Server サイトがファイアウォールの背後にある場合、ドメイン atlassian.com へのアクセスを許可する必要があります。

移行前にアプリを評価してインストールする

サーバー上で重要なデータを管理している場合は、そのデータの移行に最適なプロセスについてアプリのベンダーに確認してください。


サーバー上でアプリを監査してそれを評価し、移行の前にクラウド サイト上にインストールすると、肝心なときにアプリによって移行がブロックされるようなリスクを排除できます。

Selecting the option Assess your apps will allow you to see which apps you have installed on your server. Once you've audited what is installed, you can use the table to assess your apps, in preparation to migrate.

Jira Cloud Migration Assistant のこの表の使用方法については、「Cloud Migration Assistant でアプリを評価および移行する」でこの情報について参照してください。 

移行のセットアップと実行

To set up a new migration, select Manage your migration. You'll then be able to Create a new migration

There are five key steps to set up and run your migration from server to cloud.

以降のセクションでは各ステップを詳細に説明するとともに、発生する可能性がある一般的なエラーについて解説します。移行アシスタントの使用中に質問や問題があった場合、アトラシアンのテクニカル サポート チームにお問い合わせください。

1. 移行先の Jira Cloud サイトに接続する

まず、移行に名前を設定し、移行先のクラウド サイトを選択することを求められます。サーバー サイトと宛先のクラウド サイトの両方で管理者である必要があります。

すでにクラウド サイトに接続済みの場合、ドロップダウンでそれを確認できます。何も表示されない場合、新しいクラウド サイトに接続するか、トライアルにサインアップする必要があります。 

準備が整ったら、サーバー サイトからクラウド サイトへのデータの転送をアトラシアンに許可するチェックボックスを選択します。 このアクセスをアトラシアンに許可できない場合、移行アシスタントを使用した移行は行えず、 代わりに手動でのインポートを実行する必要があります。

ご利用の Jira Server サイトがファイアウォールの背後にある場合、ドメイン atlassian.com へのアクセスを許可する必要があります。また、他の Atlassian ドメインへのアクセスを許可する必要がある場合もあります。 



2. Choose your migration options

You have a set of tasks to choose all the relevant migration options. You can choose:

  • projects, users and groups
  • users and groups only (without any project data)

移行対象を選択する前に、移行アシスタントでの移行対象のデータと移行対象外のデータをご確認ください。




After selecting the options, you can use this screen to view the summary of your selections and choose Edit to make changes. 


プロジェクト

You can choose to migrate all or some of your projects.




移行に含めたいプロジェクトを選択します。特定のプロジェクトを選択することも、上部のボックスを選択してすべてのプロジェクトを選択することもできます。宛先の Jira Cloud サイトにすでに存在するプロジェクト キーを持つプロジェクトを移行することはできません。

多数のプロジェクトや添付ファイルがある場合、いくつかの小規模な移行に分割することもできます。これにより、メンテナンス時間またはダウンタイムを短くすることができます。

他のプロジェクトとは別に、アーカイブされたプロジェクトも移行できます。アーカイブされたプロジェクトは、検索するかフィルターを使用して探します。

When you've chosen all your projects, select Add to migration.

If you aren’t migrating any projects, you can proceed to select users and groups.

ユーザーとグループ

プロジェクトを選択したら、ユーザーとグループを選択するオプションが表示されます。プロジェクトなしでユーザーのサブセットを選択することはできません。これは、プロジェクト データを使用して移行に追加するユーザーを決定するためです。

ユーザーおよびグループの移行の詳細はこちらをご覧ください。 

移行プロセス中にユーザーに招待メールが送信されることはありません。

[Only users and groups related to the selected projects (選択したプロジェクトに関連するユーザーとグループのみ)] を選択すると、プロジェクトのロールとグループに基づいて追加のユーザーを追加するオプションが表示されます。選択する際には、ガイドをご利用ください。

続行する前に、グループ メンバーシップを保持するか、ユーザーをグループに別途移行するかを選択する必要があります。

  • グループ メンバーシップの保持。このオプションでは、移行の一環としてユーザーをグループに追加します。ユーザーにはプロジェクトへのアクセス権が付与され、Jira Cloud ライセンスに追加されます。

  • ユーザーとグループを別々に移行します。このオプションでは、選択したユーザーとグループが移行されますが、ユーザーは移行の一部としてグループに追加されません。ユーザーには Atlassian アカウントが付与されますが、プロジェクトにアクセスできず、Jira Cloud ライセンスには追加されません。

Once you have made your selection, select Add to migration.


3. エラーを確認する

このステップでは、Jira Cloud Migration Assistant が移行を確認して一般的なエラーを見つけます。次の点が確認されます。

  • 移行アシスタントが最新かどうか

  • ユーザーが有効なメール アドレスを持っているかどうか

  • ユーザーが一意のメール アドレスを持っているかどうか

  • グループが統合されるかどうか
  • プロジェクトが競合するかどうか 

  • プロジェクト、ボード、フィルターは一般に公開されており、オンラインで検索可能です

このステップでは上述の問題のみが確認されます。 移行プロセスでは ほかの問題が発生する可能性があります。


(tick) 緑色のチェック マークが表示された場合、チェックは完了しています。

(warning) 警告サインが表示された場合、続行できますが、潜在的な問題がある点を確認しておく必要があります。

(error) 赤いエラーが表示された場合、移行を実行する前にエラーを解決する必要があります。


エラーおよび警告メッセージを展開して、詳細情報やリンクを確認できます。 


ユーザーのサブセット移行を選択した場合、プロジェクト データをすべてスキャンする必要があるため、確認に時間がかかることがあります。

[Continue and fix later] を選択した場合、移行を保存し、あとから再開してエラーを確認できます。

4. 移行の確認

これは移行のセットアップの最終ステップです。

You can switch tabs to view details about what is included (users and groups / projects) in your migration or to download the pre-migration report, post migration report, and error logs.

In the Logs and reports tab, you can download the pre-migration report (.zip file) to scan through data before migrating it to your cloud site. The report includes the following information:

  • Summary -  This lists the summary data on what is expected to migrate and not migrate.

  • 留意事項 - 移行でサポート対象外の項目など、注意を要する項目の一覧が表示されます。

  • ユーザーとグループ - 移行するユーザーとグループの一覧が表示されます。

  • 設定項目 - 移行の一部であるすべてのカスタム フィールドとワークフローの一覧が表示されます。

すべてが適切に指定されており、移行を開始して問題ない場合は、[Run] をクリックします。後で移行を開始する場合、または修正が必要なエラーがある場合は、[Save] をクリックします。

移行を実行するよう選択した場合も、移行は引き続き移行ダッシュボードに保存されます。ここで、すべての移行の進捗状況と詳細を確認できます。

移行が完了したら、移行後のレポート (.zip ファイル) をダウンロードして、クラウド サイト内の移行後データのステータスを確認できます。レポートには次の情報が含まれます。

  • 概要 - 正常に移行されたものと移行されなかったものに関する概要データを示します。
  • 留意事項 - 移行でサポート対象外の項目など、注意を要する項目の一覧が表示されます。

5. 移行の管理と実行

保存した移行は移行ダッシュボードに一覧表示されます。ここで、移行の詳細を表示したり、移行を実行したりすることができます。移行のステータスの確認、進捗の監視、新しい移行の作成を行うこともできます。

移行はいくつでも作成できます。現時点では、移行を編集または削除することはできません 。不要な移行を作成した場合、新しい移行を作成します。



ステータスの定義

SAVED 移行が保存済みで、移行を実行できる状態です。

RUNNING 移行が現在進行中です。

FINISHED  移行のすべてのタスクが完了しています。

INCOMPLETE 一部のタスクが完了されましたが、エラーまたは移行できなかった情報があります。このステータスが表示される場合、一部のデータ (ユーザー、グループ、プロジェクト、課題など) は移行されており、同じプロジェクトの再移行を行いたい場合はクラウド サイトからこのデータを削除する必要がある可能性があります。

FAILED 移行を完了できませんでした。原因として、移行先のサイトにプロジェクト キーがすでに存在していることや、移行で予期せぬエラーが発生した可能性が考えられます。

移行の詳細

移行ダッシュボードで [View details] を選択することで、移行のすべての詳細情報を確認できます。詳細ページでは、移行の概要と、移行に含まれる各プロジェクトの詳細な進捗を確認できます。 

エラー ログ

移行が INCOMPLETE または FAILED の場合、エラー ログをダウンロードして詳細を確認できます。移行が停止されると、詳細ページの上部にエラー ログをダウンロードするためのリンクが表示されます。 



移行後

プロジェクト データの移行が完了したら、添付ファイルの移行が完了していない場合であっても、クラウド サイトでプロジェクトを確認できます。移行の詳細ページでプロジェクト名を選択します。

移行のタイプによっては、移行の完了後に実行が必要な操作があります。移行後の推奨事項の完全な一覧については、「移行計画ガイド」を参照してください。

ユーザーとグループ

ユーザーとグループが正しくセットアップされていることを確認するには、次の手順を実行します。

  • [管理] > [ユーザー管理] に移動して、グループのメンバーを確認し、権限を承認します。

  • 必要に応じ、汎用の管理グループにユーザーを追加します。汎用グループの例: "site-admins"、"system-administrators"、"atlassian-addons"、 "atlassian-addons-admin"。

  • 外部のユーザー管理システムを使用している場合は、ユーザーが正しく同期されていることを確認します。

  • 準備が整ったら、ユーザーを招待します。[管理] > [ユーザー] > [詳細の表示] の順に選択し、[招待の再送] を選択します。ユーザーが初めて ログイン すると、新しいパスワードを設定し、個人情報を追加するように求めるメッセージが表示される場合があります。

  • 新しいクラウド ワークスペースに慣れるため、トレーニングの実施またはオンボーディング メールの送信をお勧めします。 

プロジェクト

プロジェクトの移行が正常に完了したことを確認するには、次の手順を実行します。

  • プロジェクトおよび課題を確認するか、ユーザーに自身のプロジェクトの確認を依頼します。

  • Former User が意図せず表示されているところがないかどうかを確認します。これは、コンテンツをユーザーに関連付けることができなかったことを意味します。

  • JQL およびクイック フィルターに (migrated) フレーズがあるかどうかを確認します。これが見つかった場合、フィルターを動作させるには、(migrated) フィールドをクラウドの既存のバージョンに統合する必要があります。 
  • [設定] (歯車アイコン) > [Jira 設定] > [製品] > [アプリケーション リンク] に移動し、他のアトラシアン製品にリンクします。

  • その後、必要な他のアプリをインストールして、ユーザーのオンボーディングを実行できます。



既知の問題およびトラブルシューティング

  • データの整合性。ご利用の Jira サーバー サイトが高度にカスタマイズされている場合、移行時に他の問題が発生する可能性があります。たとえば、必須フィールドに null 値が使用されている場合、これはクラウド サイトではサポートされていないため、移行は失敗します。移行前にサーバー データのクリーン アップを行うことをおすすめします。

  • 特に大規模なプロジェクト。1 つのプロジェクトに 100,000 件以上の課題がある場合、Jira Cloud Migration Assistant がタイムアウトする可能性があります。100,000 件未満の課題を持つプロジェクトのみを移行することをおすすめします。複数の小規模なプロジェクトが合計で 100,000 件を超える課題を含む場合、それらは引き続き移行できます。 

  • すべてのユーザーとグループの移行。移行を行うたびに、すべてのユーザーとグループが移行されます。ユーザーおよびグループの数が多い場合、これによって大幅に時間がかかる可能性があります。最大で 5000 人のアクティブ ユーザーと無制限の非アクティブ ユーザーを移行できます。しかしながら、移行するユーザーの数が増えると、問題が発生する可能性が高まり、移行の時間も多くかかります。

  • 不完全な移行とプロジェクト。Incomplete ステータスが表示される場合、一部の情報は移行されていますが、少なくとも 1 個のエンティティの移行が行えていません。たとえば、プロジェクトの移行には成功したが、カスタム フィールドの値に null 値が使用されているために 1 件の課題の移行に失敗している可能性があります。このような場合、実際のデータはすべて完了していても、プロジェクトは incomplete と表示されます。多くの場合、このステータスが表示されても移行に問題はありません。エラー ログをダウンロードして問題の原因を確認できます。 
  • 移行前のサーバーへの変更。サーバー サイトへの変更を行った場合、すべてのデータを最新の状態にするため、10 分以上待ってから移行を行うようにします。 
  • プロジェクト キーの変更。移行前または移行中にサーバーでプロジェクト キーを変更することを選択した場合、すべての構成、フィルター、およびボードが新しいプロジェクト キーで更新されていることを確認してから新しい移行を試行するようにします。 
  • 移行に含まれないプロジェクトおよび課題へのリンク。小規模なバッチでの移行を行うことを選択した場合、未移行のプロジェクトまたは課題へのリンクは、リンクされた項目が移行されるまでは欠落した状態になります。 
  • 履歴エントリでの参照情報の欠落。履歴エントリが、欠落しているリンクまたは添付ファイルを参照している場合、履歴エントリは移行されません。リンクされた課題またはプロジェクトが後から移行された場合、履歴エントリが更新されます。 
  • Jira Software ボードでの結果の不一致。移行アシスタントは、移行後にボードの JQL フィルタが適切な値を返しているかどうかの確認は行いません。ボードのフィルターが未移行のプロジェクトまたはフィールドを参照している場合、移行後にそのボードで同じ結果が返されない可能性があります。この問題を解決するには、移行後にボードの JQL フィルタを編集します。 
  • Jira の新しい課題ビュー。クラウド サイトで新しい課題ビューを使用している場合、ユーザーが 2 つのビューの違いを確認できるようなトレーニングやチュートリアル ビデオを用意することができます。従来の課題ビューと新しい課題ビューとを切り替える方法についてはこちらの手順をご確認ください。



詳細情報とサポート

移行をサポートする多数のチャネルをご用意しています。







最終更新日 2021 年 1 月 19 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.