Cloud 移行を計画する
Atlassian Server 製品の移行準備に役立つドキュメント。
Jira のサイト インポート機能によって、Server から Cloud に移行する
[システムを復元] 画面 (一般にサイト インポートとも呼ばれます) を [Jira Cloud をインポート] 画面と [Jira Server をインポート] 画面に置き換えました。
Jira Server バックアップをインポートするには、次の手順に従うようになりました。
[Jira 設定] > [システム] の順にクリックします。
[インポートとエクスポート] セクションで [Jira Server をインポート] をクリックします。
Jira Cloud バックアップをインポートするには、次の手順に従います。
[Jira 設定] > [システム] の順にクリックします。
[インポートとエクスポート] セクションで [Jira Cloudをインポート] をクリックします。
サイト インポートは、Server から Cloudへの移行では利用できなくなります。
2022年05月 1日 より、1 ～ 1000 名のユーザーを移行する場合に、サイト インポートを使用した Server から Cloud への移行ができなくなりました。1000 人を超えるユーザーの移行を検討している場合、サイト インポートは追って連絡があるまで引き続きご利用になれます。
Jira Server または Data Center ライセンスのあるユーザー数を表示するには、「Jira アプリケーションのライセンス」ページの「ライセンス認可済みのユーザー数を表示する」セクションをご覧ください。
すべての移行ニーズには、Jira Cloud Migration Assistant を使用することをお勧めします。アプリ、Jira Service Management、Advanced Roadmaps の移行など、この移行アシスタントにはさまざまなメリットがあります。
このお知らせの詳細については、コミュニティ投稿をご覧ください。この変更に関する技術的または互換性に関する懸念については、お問い合わせください。
Jira Cloud Migration Assistant は、「すべてのデータを一度に移行」をサポートするようになりました。
Jira Cloud Migration Assistant 1.7.7 では、既存のプロジェクト単位の移行機能に加えて、すべてのデータを一度に移行できます。
Migration Assistant の「すべてのデータを一度に移行」する機能では、Site Import が現在サポートしているのと同じタイプのデータが移行されます。
Migration Assistant の今後のリリースでは、すべてのデータを一度に移行する機能の信頼性とパフォーマンスを高めると同時に、移行できるデータのタイプを増やしていく予定です。
このお知らせの詳細については、コミュニティ投稿をご覧ください。
テスト移行または UAT の場合、テスト用の Cloud サイトは製品サイトもホストしている組織に含まれないものを使用することをお勧めします。関連するユーザーとグループの移行を円滑に行うには、製品サイトが別の組織でホストされている必要があります。
このガイドでは、Jira のネイティブなサイト バックアップおよび復元機能 (サイト インポート) を使用して Jira Server から Jira Cloud に移行する方法について説明します。
Jira Software、Jira Service Management (旧 Jira Service Desk)、Jira Work Management (旧 Jira Core) のみを移行する予定の場合は、個別のプロジェクトまたはサイト全体を Server から Cloud に移行できる Jira Cloud Migration Assistant を使用することをお勧めします。
Jira のサイト インポートを使用する前に、ご自身に最適な移行方法をご確認ください。Cloud 移行方法を比較してください。
移行計画
このページの手順を完了する前に、Cloud 移行ガイドを参照することをお勧めします。Cloud 移行ガイドの詳細をご確認ください。
Jira Cloud Migration Assistant の添付ファイル移行とサイト インポートの互換性が実現しました。サイト インポートで Jira Cloud Migration Assistant の添付ファイルを移行する方法についてご確認ください。
ステップ 1: 移行前のチェックリストを完了する
テストまたは本番環境の移行を試行する前に、Jira サイト インポートの移行前チェックリストを完了させてください。このチェックリストを実行することで、移行に向けて環境やデータを準備して、移行の失敗を引き起こす一般的な原因を回避できます。Jira サイト インポートの移行前チェックリストに関する詳細をご確認ください。
ステップ 2: ユーザーの移行方法の決定
ユーザーとグループをインポートする最適な方法は、移行対象の製品、Server における現在のユーザーとグループの管理方法、SCIM (ユーザー プロビジョニング) 用に Atlassian Access を使用する予定かどうかに応じて異なります。ユーザー移行戦略の詳細をご確認ください。
ステップ 3: Jira Server データベースのバックアップ
このステップでは、Jira Server データベースを XML 形式でバックアップします。同じサイトに複数の Jira アプリケーション (Jira Software、Jira Core、および Jira Service Management (旧 Jira Service Desk) など) がある場合、このバックアップは、すべてのプロジェクト タイプ (ソフトウェア、ビジネス、サービス) を既定で含みます。
Jira システム管理者権限を持つユーザーとしてログインします。
> [システム] の順に選択します。
[インポートとエクスポート] > [システムをバックアップ] を選択して Jira のバックアップ ページを開きます。
[ファイル名] フィールドに、バックアップ ファイルの名前を入力します。
[バックアップ] ボタンをクリックし、Jira データのバックアップが完了するのを待ちます。Jira はバックアップを Jira アプリケーションのホーム ディレクトリ (jira-home) の export サブディレクトリに、zip 化された XML アーカイブ ファイルとして保存します。この場所に書き込むために必要なファイル システム権限が Jira に与えられていることを確認します。
バックアップが完了すると、確認メッセージが表示されます。これで、Server からファイルを取得できます。
ステップ 4: Jira Server の添付ファイル、プロジェクト アバター、およびロゴのバックアップ
添付ファイル、プロジェクト アバター、またはロゴを移行したい場合、それらも同様にバックアップする必要があります。これらは、Jira アプリケーションのホーム ディレクトリのサブディレクトリである、Jira アプリケーションの data ディレクトリに保管されています。
このステップを完了するには、 /data/attachments、/data/avatars、および /logos/ ディレクトリの zip アーカイブを作成する必要があります。次の構造を使用していることを確認します。
1
2
3
4
5
6
7
8
9
10
11
12
attachments-1.zip
└─── data
├── attachments
│ ├── ProjectKey1
│ │ └── 10000
│ │ ├── IssueKey-1
│ │ ├── IssueKey-2
│ │ └── IssueKey-3
│ ├── ProjectKey2
│ └── ProjectKey3
└── avatars
└── logosデータのバックアップには複数の方法があります。Jira でデータをバックアップする方法についてご確認ください。
*nix サーバーでは次のようなコマンドを実行できます。
cd <Jira Home Dir> zip -r data.zip logos/ data/avatars/ data/attachments/
zip ファイルを作成したら、Server からローカルのワークステーションに転送する必要があります。これを行うための一般的な方法には、SFTP、rsync、wget、curl の使用が含まれます。
ステップ 5: Jira Cloud サイトをバックアップする
Server のバックアップを Jira Cloud サイトにインポートすると、Cloud サイト内のすべてのデータが上書きされます。このデータは復元できません。そのため、Server のバックアップを Jira Cloud サイトにインポートする前に、Jira Cloud サイトをバックアップする必要があります。バックアップ ファイルのコピーをダウンロードして保管してください。Cloud サイトをバックアップするには、次の手順に従います。
Jira Cloud サイトに site-admin 権限でログインします。
[Jira 設定] > [システム] の順にクリックします。
[インポートとエクスポート] セクションで、[バックアップ マネージャ] をクリックします。
[Cloud のバックアップ] セクションで [Cloud のバックアップを作成する] をクリックします。チェックボックスを選択して、バックアップに添付ファイル、アバター、ロゴを含めるようにしてください。
ステップ 6: Server のデータベース バックアップを Jira Cloud にインポートする
インポートする前に:
Cloud へのインポートを完了する前に、ユーザー名やメール アドレスの監査を行うべき場合があります。主に次の点を確認します。
すべてのメール アドレスは、トップレベル ドメインで終了している必要があります。たとえば、john_doe@company は .com を含まないため無効であり、インポートをブロックします。
すべてのメール アドレスは有効なドメインを使用している必要があります。たとえば、example.com は有効なドメインと認識されないため、john_doe@example.com は許可されません。
すべてのユーザーが一意のメール アドレスを持っている必要があります。
addon_ から始まるユーザー名は、名前を変更するか削除する必要があります。このプレフィックスは Atlassian Marketplace アプリ用に確保されています。この問題は、過去にアトラシアンの Cloud 製品からの移行を行っている場合に発生することがあります。
無効または重複するメールが見つかった場合は、これらのメールを含む CSV ファイルをダウンロードするオプションが提供されます。次のいずれかを実行する必要があります。
[NewEmail] 列に正しいメール アドレスを入力します。
または
ユーザーを移行しない場合は、tombstone 列で FALSE を TRUE に変更する必要があります。
次に、[CSV のアップロード] オプションを使用して修正したファイルをアップロードし、インポートを再び実行する必要があります。
このステップでは、アトラシアンの Server サイトの URL のリストが表示される場合があります。移行後にリンクに古い Server サイトではなく新しい Jira Cloud サイトを関連させるには、次の手順に従います。
リストから Cloud にインポートしている Jira サーバー インスタンスの URL を選択します。
[インポートを実行] をクリックして移行を続行します。
バックアップ ファイルを解凍して、ファイル構造が以下に類似していることを確認します。
1
2
3
JIRA-backup-20161021
├── activeobjects.xml
├── entities.xml新しい Jira Cloud サイトに site-admin 権限を持つユーザーとしてログインします (まだ行っていない場合)。
[Jira 設定] > [システム] の順にクリックします。
[インポートとエクスポート] セクションで [Jira Server をインポート] をクリックします。
[データのインポート] を選択し、「ステップ 2: Jira Server データベースのバックアップ」でダウンロードしたファイルを選択します。
Jira によってファイルの確認が行われ、データのインポート方法の設定を選択するプロンプトが表示されます。
まず、出力メール設定を選択します。選択したオプションにかかわらず、管理者は移行後に出力メール設定を手動で変更できます。
出力メールを [Enable] することを選択した場合、課題への新しいコメントや課題のトランジションなどのインタラクション時に Jira によって自動メールが送信されます。
出力メールを [Disable] することを選択した場合、Jira はインタラクションに対する自動メールを送信しません。
ユーザー移行オプションは利用できなくなりました
サイト インポートによる Server から Cloud への移行に対する次のユーザー移行オプションは終了しました。
既存のクラウド ユーザーとマージ
既存のクラウド ユーザーを上書き
ユーザーを移行するには、Jira Cloud Migration Assistant を使用します。Jira Cloud Migration Assistant でユーザーとグループを移行する方法をご確認ください。
この変更に関する技術的な懸念がある場合は、お問い合わせください。
Jira Cloud Migration Assistant を使用してユーザーを移行しており、他のすべてのプロジェクト データもインポートする場合は、[Jira Cloud Migration Assistant を使用してユーザー データを移行しました。] を選択します。
[インポートの実行] をクリックします。インポートの進捗を追跡できるページに転送されます。バックアップのサイズによっては、インポートの完了に時間がかかる場合があります。
インポートが完了すると、確認画面に転送されます。
テスト中に Cloud の受信メール ハンドラーを無効にする
初期設定では、受信メール ハンドラーはインポート後に有効になります。これによって、Cloud のメール ハンドラーが Server のメール ハンドラーの代わりにメールを処理する可能性があります。メールが誤って処理されないように、テスト中はこれらの機能を無効にすることを強くお勧めします。
以下を実行できます。
[Jira 設定] > [システム] の順にクリックします。
[グローバル メール設定] を選択して、[メールのプル機能] と [メールのプロセス機能] をオフにします。
[受信メール] を選択して、すべてのメール サーバーとハンドラーを削除します。
Jira Service Management を使用している場合は、[設定] > [製品] > [メール リクエスト] の順に移動して、[メール アドレス] セクションが空であることを確認します。
メディア (添付ファイル、ロゴ、プロジェクト アバター) を引き続きインポートする必要がある場合は、ここで [メディアのインポート] を選択します。アプリケーション アクセスを管理する前に [インポートとエクスポート] ページに戻る必要があります。このステップは完了済み、またはメディアのインポートを計画していない場合は、[アプリケーション アクセスを付与] をクリックしてステップ 6 にスキップできます。
このステップのトラブルシューティング
Import error
次のエラーが発生した場合:
Import error
There was an error importing file JIRA-backup-20161021.zip: Validation failed.The following issues were reported:
The import archive doesn't contain entities.xml file.
この場合、XML ファイルを直接 zip 化するのではなく、.xml ファイルを含むフォルダを zip 化している可能性があります。Jira Cloud へのインポートの前に、バックアップから無効な文字を削除する必要があります。無効な文字を削除する方法を確認する
インポートの停止
インポート中、次のパーセント値 / ステップで時間がかかる場合があります。
50% - データベースのアップグレード中
90% - ユーザーおよびグループのインポート中
これは通常の挙動です。完了までお待ちください。
サイトのインポートでは、外部ディレクトリで管理されるユーザーの移行はサポートされていません。データを移行するには、Jira Cloud Migration Assistant を使用することをお勧めします。Jira Cloud Migration Assistant を使用してすべてのデータを移行できない場合は、ユーザーのみを移行することを検討してください。たとえば、最初に移行アシスタントを使用してすべての Jira ユーザーを移行してから、Jira サイト インポートを使用してプロジェクトをインポートできます。
テキスト フィールドの検索が機能しない
バックグラウンドでのインデックス再作成が完了するまで、特定の Jira 機能では JQL によるテキスト フィールドの検索が機能しない可能性があります。移行したデータの量によっては、インデックス再作成に最大 48 時間かかる場合があります。次の機能が影響を受ける可能性があります。
ダッシュボード – ガジェット、円グラフ、統計
課題ビュー
企業管理対象プロジェクト – ボードとバックログ
Jira Service Management – 課題数、課題リスト、SLA など
ステップ 7: Jira Server メディアを Jira Cloud へインポートする
新しい Jira Cloud サイトに site-admin 権限を持つユーザーとしてログインします (まだ行っていない場合)。
[Jira 設定] > [システム] の順にクリックします。
[インポートとエクスポート] セクションで [Jira Server をインポート] をクリックします。
[メディアのインポート] を選択し、「ステップ 3: Jira Server の添付ファイル、プロジェクト アバター、およびロゴのバックアップ」で作成およびダウンロードしたメディア zip を見つけて選択します。
インポートの進捗を追跡できるページに転送されます。バックアップのサイズによっては、インポートの完了に時間がかかる場合があります。
インポートが完了すると、確認画面に転送されます。
メディアをさらにインポートする必要がある場合、すべてのメディア ファイルのインポートが完了するまでこのステップを繰り返します。次のメディアをエクスポートする前に、前回のメディア インポートが正常に完了したことを新しいタブでテストすることをおすすめします。
このステップのトラブルシューティング
大きな添付ファイルのインポートには長い時間がかかります
大規模なファイルのインポートに失敗したり、完了に時間がかかったりする場合があります。
ファイルが 10 GB よりも大きい場合、バックアップを 2 ～ 5 GB に分割してそれぞれを個別にインポートする必要がある場合があります。ファイル構造は次のようにします。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
attachments-1.zip
└─── data
├── attachments
│ ├── ProjectKey1
│ │ └── 10000
│ │ ├── IssueKey-1
│ │ ├── IssueKey-2
│ │ └── IssueKey-3
│ ├── ProjectKey2
│ └── ProjectKey3
└── avatars
└── logos
attachments-2.zip
└─── data
└── attachments
├── ProjectKey4
├── ProjectKey5
└── ProjectKey6
attachments-3.zip
└─── data
└── attachments
└── ProjectKey#Jira エクスポートの一部を Jira Cloud にインポートする方法をご確認ください。
無効なファイル名
すべての添付ファイルに、有効なファイル名の ID があることをご確認ください。拡張子の付いたファイル名は無効となり、インポートが失敗する可能性があります。
例：
正しい形式
誤った形式
ページが突然リロードされて、進捗やメッセージが表示されなくなる
添付ファイルのインポート ステップには、アップロード、処理、および実際のインポートを含む独自のフェーズがあります。大規模な添付ファイルの処理フェーズで中断が発生する場合があります。これが起こった場合、ページが突然リロードされ、以降は進捗やメッセージが表示されなくなります。
問題が発生しなかった場合、処理ステップのあとに次のようなメッセージが表示されます。
Attention
This will import non-database content (such as attachments and avatars) into your Jira instance. You should only do this after a full database import because the full import will remove any existing data that you import using this page.
This operation could take anywhere from several minutes to several hours depending on the size and number of attachments.
Note that this operation cannot be undone.
これが表示された場合、処理は完了しています。[Proceed] ボタンをクリックし、添付ファイルのインポートを完了します。
処理中にインポートが失敗した場合、添付ファイルを小規模な zip ファイルに分割してそれぞれを個別にインポートします。添付ファイルを小規模な zip ファイルに分割する方法をご確認ください。
ステップ 8: Server からインポートされたグループを確認してアクセス権を付与する
すべてのデータを Cloud サイトにインポートしたら、Server からインポートされたグループを確認してアクセス権を付与する対象を決定する必要があります。
セキュリティ上の理由により、インポート プロセスで既定のアプリケーション アクセス設定の適用や新規ユーザーへのアクセス権の付与が自動的に行われることはありません。ユーザーがログインできるようにするためには、管理者がアプリケーション アクセスを付与する必要があります。
新しい Jira Cloud サイトにログインして、[Jira 設定] > [ユーザー管理] の順にクリックします。
[サイト設定] セクションで [製品アクセス] を選択します。
[Review imported groups] を選択し、既定グループのアクセスを確認します。
インポートにより、既定の Jira Server グループ Jira-administrators は Jira Cloud で administrators に変更される点にご注意ください。
ステップ 9: Server からインポートされたグループに自身を再度追加する
セキュリティ上の理由により、移行を実行しているユーザーのグループ設定はインポートされません。つまり、移行を実行したユーザーは自分自身を以前のグループに再度追加する必要があります。これには 2 つの方法があり、[グループ] セクションまたは [ユーザー] セクションのどちらかで行えます。
ユーザー セクションで行う場合
https://admin.atlassian.com に移動します。
複数の Cloud サイトをお持ちの場合は、移行した Cloud サイトを選択する必要があります。
[ユーザー管理] セクションで、[ユーザー] を選択します。
自身のプロファイルを見つけます。
... アイコンをクリックします。
[ユーザーをグループに追加] を選択します。
自身を追加する必要があるグループを選択します。
[グループに追加] をクリックします。
グループ セクションで行う場合
https://admin.atlassian.com に移動します。
複数の Cloud サイトをお持ちの場合は、移行した Cloud サイトを選択する必要があります。
[ユーザー管理] セクションで、[グループ] を選択します。
自身を追加する必要があるグループを選択します。
[メンバーを追加] を選択し、自身をグループに追加します。
残りのグループについて、必要に応じて手順を繰り返します。
ステップ 10: 移行後のチェックを完了する
移行のタイプによっては、移行の完了後に何らかの操作が必要な場合があります。移行計画ガイドで詳細をご確認ください。
その他のトラブルシューティング
移行中に問題が発生した場合、アトラシアンのさまざまなリソースを活用できます。最初に、アトラシアンの公開課題トラッカーで既知の問題を検索することをお勧めします。Jira の移行で発生する一般的な問題についての情報 (ステータスや推奨される回避策など) を見つけることができます。
次のような既知の問題があります。
詳細情報とサポート
移行をサポートするための多数のチャンネルをご用意しています。
移行計画の詳細については、アトラシアン移行プログラムの Web サイトをご参照ください。
技術的な問題が発生している、または戦略やベスト プラクティスに関するサポートが必要な場合は、サポート チームにお問い合わせください。
専門的なアドバイスについては「アトラシアン コミュニティ」をご参照ください。
専門家によるサポートが必要な場合は、アトラシアン パートナーにご相談ください。
アトラシアン サーバー製品のサポートは 2024 年 2 月に終了します。サーバーのサポート終了スケジュールで詳細をご参照ください。
この内容はお役に立ちましたか?