Jira Cloud Migration Assistant を使用してサーバーからクラウドに移行する

descriptionStep-by-step instructions on how to use the Jira Cloud Migration Assistant to move your projects from Jira Server to Jira Cloud.

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

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

Important changes to our server and Data Center products

We’re making changes to our server and Data Center products, including the end of sale for new server licenses on February 2, 2021 and the end of support for server on February 2, 2024. Learn what this means for you

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

Use the Jira Cloud Migration Assistant when:

  • You are migrating Jira Software or Core from server to cloud
  • 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. 


The Jira Cloud Migration Assistant does not migrate Jira Service Desk projects or Confluence spaces. Review all the migration methods to find the one that is right for your circumstance.


Use our migration guide to prepare and plan for your migration from server to cloud. 

Jira Cloud Migration Assistant について

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

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

  • 一部のデータがリンクされます。複数回の移行を行う場合、重複を防ぐためにデータのリンクが試行されます。データのリンク方法についてご確認ください。 
  • Jira Core と Jira Software のデータのみ。最新のバージョンの Jira Cloud Migration Assistant では Jira Core または Software のプロジェクトを移行でき、ほとんどのフィールドがサポートされます。Jira Service Desk と一部のカスタム フィールドは、まだサポートされていません。移行対象のデータと対象外のデータの最新情報をご確認ください。

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

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

はじめる前に

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

Jira Cloud Migration Assistant アプリのインストール

アプリを Jira バージョン 7.6 以降にインストールするには、次の手順を実行します。

  1. In Jira Server or Data Center go to SettingsManage apps.

  2. [新しいアプリを見つける] を選択して「Jira Cloud Migration Assistant」を検索します。

  3. [インストール] を選択したら完了です。

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

インストールしたら、[設定] > [システム] > [インポートとエクスポート] カテゴリで [Migrate to cloud] を選択して、移行アシスタントにアクセスできます。

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

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

Assess and install your apps before migrating

If you have critical data managed by apps on your server, be sure to check with the app vendor about the best process to migrate that data.


Auditing apps on your server, assessing them, then installing apps on your cloud site before migration removes the risk of your apps blocking your migration at a crucial time.

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.

For more information on using this table in the Jira Cloud Migration Assistant, you can refer to this information on assessing and migrating apps with the 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. 移行対象を選択する

プロジェクト、ユーザーおよびグループ、またはユーザーとグループのみ (プロジェクト データを含めない) の移行を選択できます。移行対象を選択する前に、移行アシスタントでの移行対象のデータと移行対象外のデータをご確認ください。



プロジェクト

If you want to migrate all or some of your projects choose Select project from the options. You will then be able to select which projects you want to migrate. If you aren’t migrating any projects you’ll be taken straight to check for errors.





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

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

Apart from other projects, you can also migrate archived projects. Search or use the filter to locate the archived projects.

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

ユーザーとグループ

After you have selected your projects you will have the option to select your users and groups. You can’t select a subset of users without any projects. This is because we use the project data to determine which users to add to the migration.

Learn more about user and group migration. 

We will never send invitation emails to your users during the migration process.

If you select Only users and groups related to the selected projects, you’ll get the option to add additional users based on project roles and groups. Use our guide to help you make a selection.

Before continuing, you will need to select whether you want to preserve group membership or migrate your users separately to their groups.

  • Preserve group membership. This option will add your users to their groups as part of the migration. Your users will have access to their projects and will be added to your Jira Cloud license.

  • Migrate users and groups separately. This option will migrate the selected users and groups, but the users will not be added to the groups as part of the migration. Your users will be given Atlassian Accounts, but they won’t have access to projects and they won’t be added to your Jira Cloud license.

Once you have made your selection, select Next.

3. エラーを確認する

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

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

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

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

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

  • projects, boards, and filters are publicly available and searchable online

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


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

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

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


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


If you have selected to migrate a subset of your users, the check may take a little longer to run as it will need to scan through all your project data.

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

4. 移行の確認

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

On this screen, 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:

  • Requires attention - This lists items that require your attention, for example, items that are not supported via migration

  • Users and groups - This lists users and groups that will be included in your migration



If everything looks correct and you want to start your migration, click Run. If you would like to start your migration later or you still have errors to fix, click Save.

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

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 つのビューの違いを確認できるようなトレーニングやチュートリアル ビデオを用意することができます。従来の課題ビューと新しい課題ビューとを切り替える方法についてはこちらの手順をご確認ください。



詳細情報とサポート

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






最終更新日: 2020 年 9 月 20 日

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

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