Confluence Cloud Migration Assistant を使用して移行する

Confluence Cloud Migration Assistant は、 Confluence Server または Data Center から Confluence Cloud への、コンテンツ、ユーザー、およびグループの簡単な移動を支援するアプリです。アトラシアンが構築と保守を行うこのアプリは、無料でインストールして使用できます。

このアプリによって、Cloud に移動するコンテンツを選択して、好きなタイミングで移行を開始できます。移行プロセスの間は、すべての項目の進捗状況を監視できます。

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

次の場合は、Confluence Cloud Migration Assistant を使用します。

• Confluence Server または Data Center のユーザーやデータを Confluence Cloud サイトに移動したい

• Confluence Server または Data Center から Confluence Cloud サイトに移行する前にアプリを評価したい

• Confluence Server または Data Center から Confluence Cloud へのテスト移行を実行したい

• アトラシアン株式会社からアプリの使用を推奨された

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

Confluence Server サイトのバージョンが 6.13 以降の場合、Confluence Cloud Migration Assistant は事前にインストールされているため、別途インストール不要です。ただし、アプリの更新を求められる場合があります。 

バージョン 5.10 ～ 6.12 にアプリをインストールするには以下の手順を実行します。

1. Confluence Server で、 > [アプリを管理] の順に移動します。

2. [新しいアドオンを検索] を選択します。 

3. Confluence Cloud Migration Assistant を検索します。 

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

Migration Assistant を見つける

Migration Assistant を検索するには、次の手順に従います。

1. [Confluence 管理] に移動し、Atlassian Cloud カテゴリで [移行アシスタント] を選択します。

移行パスを作成するには、4 つのステップがあります。

1. アプリを評価する

2. アプリを準備する

3. すべてのメール ドメインを確認する

4. データを移行する

以降のセクションでは、各段階の詳細について説明します。

移行するアプリがない場合は、手順 3 に進んでください。

以降のセクションでは、各段階の詳細について説明します。

1. アプリを評価する

Server にインストールしたアプリを確認して、移行準備中のアプリを評価するには、Confluence Cloud Migration Assistant を使用します。移行前にアプリを評価して (必要に応じて) Cloud サイトの代替アプリを選択すると、肝心なときにアプリによって移行がブロックされるようなリスクを排除できます。アプリの評価方法をご確認ください。

アプリの評価を開始するには、次の手順に従います。

Migration Assistant のホーム画面で [アプリを評価] を選択します。

Confluence Cloud Migration Assistant でのアプリ評価に関する詳細をご確認ください。

アプリを評価し終えたら [完了] を選択します。Migration Assistant のホーム画面に戻るので、次のステップとしてアプリの準備を選択できます。

2. アプリを準備する

この段階では 3 つのメイン タスクを実行します。

• Cloud サイトに接続する

• アプリをインストールする

• アプリの移行に同意する

Migration Assistant のホーム画面で [アプリを準備] を選択します。これによって [Cloud に接続] 画面が表示されます。

2.a. Cloud サイトに接続する

このステップでは、任意の Cloud サイトをリンクします。これには 3 つの方法があります。

• ドロップダウンから既存の Cloud サイトを選択する

• アトラシアンの Free プランにサインアップする (最大 10 ユーザー、無料の Cloud サイト)

• 無料の製品トライアルをセットアップする

インストール先を選択したら [続行] をクリックします。

2.b. アプリをインストールする

[アプリをインストール] 画面で、次の手順に従います。

1. リストされている各アプリに対して [アプリのインストール] を選択して、Cloud サイトにインストールします。

2. 各アプリのサポートとプライバシー ポリシーを読みます。

3. [続行] を選択します。これによって [アプリの移行に同意] 画面が表示されます。

2.c. アプリの移行に同意する

アプリの移行が実行されると、各 Server アプリから Cloud サイト上の Cloud バージョンの Server アプリにデータが移動されます。各アプリを構築した Marketplace Partner (ベンダー) は、データを移動するための移行パスを作成しています。

このプロセスでアプリ データの移行を実際に実行するのは、アトラシアンではなく Marketplace Partner です。このため、各 Marketplace Partner の契約を確認して同意し、パートナーがデータにアクセスして移行できるようにする必要があります。

評価フローを完了するには、各アプリについてアプリの移行を承諾して同意する必要があります。

[アプリの移行に同意] 画面で、次の手順に従います。

1. 同意が必要であることが表示されている各アプリの [ポリシーを表示] を選択します。次を記載したカードが表示されます。

   1. Marketplace Partner (ベンダー) が read core data や read user data.などでアクセスできるすべての種類のデータ。

   2. Atlassian Marketplace 利用規約、Marketplace Partner のプライバシー ポリシー、Marketplace Partner 利用規約の各リンク。移行する各アプリについて、これらをお読みになることを強くお勧めします。
      
      

2. このカードで [確認] を選択します。

3. 該当するすべてのアプリに対して上記のアクションを実行したら、[完了] を選択して Migration Assistant のホーム画面に戻ります。

サードパーティ移行契約の詳細をご確認ください。

次の点について把握しておくことが重要です。

• 移行に同意する必要があるのは、自動移行パスのあるアプリのみです。

• サードパーティの移行に同意する場合は、同意をいつでも取り消せます。

• サードパーティの移行に同意しない場合、そのアプリは Confluence Cloud Migration Assistant を使用して移行できません。

• Marketplace Partner がアプリを更新する場合は、移行に再度同意する必要があります。

• アプリの移行に同意した後でも [同意を取り消す] を選択できます。これによって、サードパーティのデータ移行に対する同意が削除されます。もう一度同意するには、[ポリシーを表示] をクリックして同意を再確認します。

準備が整えば、アプリ評価は完了です。[完了] をクリックしてホームページに戻ります。 

移行前に Cloud サイトのデータ競合について確認する

Server と Cloud の各サイトでいくつかの手動チェックを実行することで、問題の発生や移行の失敗のリスクを軽減できます。

1. グループの競合を確認する

Cloud サイト内に、Server サイトと同名のグループが存在していないことを確認します (意図的にマージしようとしている場合を除く)。

Cloud サイト (Jira または Confluence) のグループと同名のグループが Server サイト内に見つかった場合、ユーザーは Server のグループから Cloud のグループにマージされます。Server グループは Cloud グループの権限を継承します。これは、移行している Confluence グループと同名の、Jira 製品アクセスを持つグループにも適用されます。これは、Cloud サイトではすべてのユーザーとグループが一元管理されるためです。

これを防ぐには、移行の実行前に、Server と Cloud のすべてのグループの名前が一意であることを確認する必要があります。

次のグループは管理者アクセスを管理しているため、ブロックリストに登録済みです。次のグループは一切移行されません: "site-admins"、"system-administrators"、"atlassian-addons"、 "atlassian-addons-admin"。上記のグループのユーザーは引き続き移行されるため、ユーザーをいずれかのブロックリスト グループに追加する場合は、移行後に手動で追加する必要があります。

2. スペース キーの競合を確認する

移行前に、Server と Cloud の各サイト間に同じスペース キーを持つスペースがないことを確認します。

Server サイトのスペースが Cloud サイトのスペースと同じスペース キーを持っていた場合、移行は失敗します。これは、Confluence Cloud 内の各スペースに、一意のスペース キーが必要なためです。競合が見つかった場合は、次の操作を実行できます。

• Cloud または Server の各サイトから重複スペースを削除する

• Cloud サイトをリセットする

• 対象のスペースの移行をやめる

Migration Assistant が競合を検出した場合、そのスペースは移行されません。

スペース キーの競合が過去のテスト移行によって発生している場合、移行前にクラウド サイトをリセットできます。Confluence Cloud サイトのリセット方法をご確認ください。

3. すべてのメール ドメインを確認する

移行する前に、ユーザーのメール ドメインを確認して、認識できない、または信頼できないメール ドメインからユーザーが移行されないようにする必要があります。これにより、Cloud サイトのセキュリティが向上します。ここで選択したドメインは、今後のすべての移行に適用されます。

ドメインの確認は、"移行アシスタントのホーム" 画面から開始できます。[すべてのメール ドメインを確認する] を選択します。これによって、"すべてのメール ドメインを確認する" 画面が表示されます。

この画面には、すべてのメール ドメインと各ドメインのユーザー数が一覧表示されます。すべてのドメインを "信頼済み" としてマークする必要があります。これによって、信頼できるメール ドメインからのみユーザーを移行できます。

リストされている各ドメインについて、次の 3 つのうち、いずれかの 1 つに決める必要があります。

すべてのメール ドメインを確認して、信頼済みとしてマークする必要があります。すべてのドメインを信頼しなくても移行を続行できますが、移行を実行することはできません。

すべてのドメインを信頼済みドメインとしてマークしたあと、[完了] を選択してドメインの確認を完了すると、"移行アシスタントのホーム" 画面に戻ります。

過去に保存した移行がある場合:

1. 移行ダッシュボードから、新しい移行の作成、または既存の移行を実行できます。メール ドメインを確認するように指示するメッセージが表示されます。

2. すべてのメール ドメインを確認して、信頼済みとしてマークするには、[ドメインを確認] を選択します。

3. ドメインをあとで確認したい場合は、[Continue without reviewing (確認しないで続行)] を選択します。この段階では、すべてのドメインを信頼しなくても移行を続行できますが、移行を実行することはできません。

4. データを移行する

次の 5 つの主なステップで、Server または Data Center から Cloud への移行をセットアップして実行します。次のステップに従います。

1. クラウドに接続

2. 移行対象を選択

3. エラーの有無の確認

4. 移行の確認

5. 移行

以降のセクションでは各ステップを詳細に説明と併せて、発生する可能性がある一般的なエラーについて解説します。

データの移行を開始するには、次の手順に従います。

1. Migration Assistant のホーム画面で [データを移行] を選択します。これによって [移行ダッシュボード] が表示されます。

2. [新しい移行を作成] を選択します。これによって [動作の仕組み] 画面が表示されます。

3. 画面の情報を確認して [クラウドに接続] を選択し、続行します。

4.a. Cloud サイトに接続する

移行に名前を設定して移行先 Cloud サイトの選択を求められます。Server サイトと宛先の Cloud サイトの両方で管理者である必要があります。

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

準備が整ったら、Server サイトから Cloud サイトへのデータの転送をアトラシアンに許可するチェックボックスをオンにします。このアクセスをアトラシアンに付与できない場合は、Migration Assistant で移行できないため、代わりにスペース インポートを実行する必要があります。

Confluence Server サイトがファイアウォールの内側にある場合は、ドメイン atlassian.com へのアクセスを許可する必要があります。また、他の Atlassian ドメインへのアクセスを許可する必要がある場合もあります。許可リストに登録する必要がある IP アドレスとドメインについてご確認ください。

4.b. 移行対象を選択する

すべてをまとめて移行することも、いくつかの段階に分割することもできます。

選択肢は次のとおりです。

• スペース (およびその添付ファイル) を移行するか、スペースの移行をスキップする

• 添付ファイルのみ

• Confluence ディレクトリのユーザーおよびグループのすべてまたは一部

• スペースのすべてまたは一部 (およびそれらの添付ファイル)

• アプリの評価時に「クラウドで必要」とマークしたすべてのアプリ

添付ファイルのみ

他のスペース データを移行する前に、スペースの添付ファイルを移行することを選択できます。通常、添付ファイルの数が多いほど、予想されるダウンタイムも長くなります。最初に添付ファイルを移行することをお勧めします。これによって、残りのスペース データ移行の期間を短縮できます。

[Migrate attachments only (添付ファイルのみを移行)] を選択すると、選択したスペースに関連する添付ファイルのみを移行できます。添付ファイルのみを移行してダウンタイムを短縮する方法についてご確認ください

その後、スペースを移行する必要があります。これにより、スペースと添付ファイル間のリンクが復元されます。移行アシスタントは、すでに移行された添付ファイルを認識し、スキップします。新しい添付ファイルは移行されます。また、削除済みの添付ファイルのリンクも削除されます。 

ユーザーとグループ

ユーザーをすべて移行するか、一部を移行することを選択できます。

すべてのユーザーを移行する場合は、初回の実行時にすべてのユーザーが Cloud サイトに追加されます。以降のそれぞれの移行では、データが Cloud 内にすでに存在するユーザーにリンクされます。大規模なユーザーベースの移行に関する詳細をご確認ください。

ユーザーを移行すると、それらのユーザーは Cloud で該当するグループに追加されます。移行後にグループ権限を確認して承認する必要があります。グループ権限を承認すると、ユーザーに Confluence へのアクセス権が付与されて請求対象に含められます。

ユーザーへの招待は送信されません。ユーザーを招待するには、移行後に管理スペースから招待を送信するか、自身でログインできるように当該ユーザーへリンクを送信します。

ユーザーおよびグループの移行時には、次の点にもご注意ください。

• 移行エクスペリエンスに影響する可能性のあるユーザー管理への変更を公開しています。admin.atlassian.com の組織で、[ユーザー] と [グループ] の各リストが [ディレクトリ] タブにある場合は、改善されたユーザー管理エクスペリエンスをご利用中です。つまり、複数サイト全体のユーザーとグループが組織にマージされます。

• ユーザーは、信頼できる情報源としてメール アドレスを使用して移行されます。その後の移行では、移行アシスタントはユーザーを再度移行するのではなく、メール アドレスを使用してユーザーをリンクさせます。大量のユーザーを移行する場合の詳細をご確認ください。 

• クラウドに移行する前に、すべてのユーザー アカウント (メール アドレス) を検証する必要があります。不明なユーザー アカウントの移行によって、Cloud サイトへの未承認のアクセスを許可することになる可能性があります。たとえば、“email@example.com” など、自分の組織が所有しないメール アドレスのユーザーをサーバー インスタンスに含めると、“@example.com” を所有する何らかのユーザーを Cloud の自分のサイトに招き入れる可能性があります。

• Confluence Cloud はサブスクリプション ベースで、ユーザー単位で請求が行われます。利用可能なライセンス オプションの詳細をご確認ください。 

• 外部のユーザー管理システムを使用している場合は、移行前にローカル ディレクトリと同期させることをお勧めします。これは、データを転送する前にユーザーとグループが最新であることを確認するためです。

• Server サイトにある無効ステータスのユーザーは、アクティブだがすべての製品アクセスを持たないユーザーとして移行されます。つまり、請求時にはアクティブな Confluence ユーザーとして計上されません。

• Cloud サイトにあるグループと同名のグループが Server サイト内に見つかった場合、そのユーザーはサーバーのグループからクラウドのグループにマージされます。

• グローバル設定とグローバル サイト権限はこのツールでは移行されません。これらは移行後に手動で設定する必要があります。

• 宛先クラウド サイトにすでにユーザーが存在していて、このアプリでユーザーを移行することを選択した場合は、次のようになります。

  • ユーザーが Cloud で製品アクセスを持っているが Server サイトでステータスが無効にされている場合は、移行後も Cloud 内で製品アクセスを持ちます。

  • ユーザーが Cloud で製品アクセスを持っていないが Server サイト内で有効にされている場合は、移行プロセスを通じて製品アクセスが付与されます。

スペース

スペースのすべてまたは一部を移行する場合は、オプションの [スペースを移行] を選択します。その後、移行するスペースを選択できるようになります。スペースを移行していない場合は、エラーの有無の確認に直接転送されます。

移行に追加するスペースを選択します。リストをフィルタリングすることも、特定のスペースを検索することもできます。すべてを一括で移行する場合は、[すべて選択] をクリックします。宛先の Confluence Cloud サイトにすでに存在するスペース キーを持つスペースは、移行できるようになりません。

スペースが MIGRATED ステータスの場合、対象のスペースは同じクラウド サイトにすでに移行されています。

スペースが QUEUED ステータスの場合、対象のスペースは実行待ちの移行にすでに追加されています。

すべてのスペースを選択したら、[Add to migration] を選択します。 

アプリ

アプリの評価中に「クラウドで必要」とマークしたすべてのアプリを移行することを選択できます。もしくは、この段階ではアプリを移行しないことも選択できます。

4.c. エラーをチェックする

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

• ご利用の Migration Assistant アプリが最新かどうか

• ユーザーに有効で一意のメール アドレスが紐付けられているかどうか

• 移行プロセスでのグループの統合

• クラウド サイトにすでに存在するスペース

• スペースが公開されオンラインで検索可能

• アプリ評価が完了したか、またはアプリ評価の決定を変更する必要があるかどうか

• この移行からアプリを削除する必要があるかどうか

以下の表では、リストされた各メッセージの横にある記号の意味について説明します。

記号/メッセージ	説明	必要なアクション
	緑のチェックはチェックが合格したことを示します。	移行の次のステップに進んでください。
	黄の警告サインが表示された場合は、このまま続行できますが潜在的な問題を含む可能性があります。	エラー メッセージまたは警告メッセージを展開して、詳細やリンクをご確認してください。
	赤のエラーは、移行を実行する前にエラーを解決する必要があることを意味します。	エラー メッセージまたは警告メッセージを展開して、詳細やリンクをご確認してください。

「チェック」メッセージを理解する

• システム: 次の表は、Confluence Cloud Migration Assistant のバージョンに関連するエラーと警告メッセージのリストです。

ユーザーとグループのエラー

すべてのユーザーは、有効で一意なメール アドレスを持っている必要があります。無効なメール アドレスや複数のユーザーが同じメール アドレスを使用していることが検出された場合は、エラーが表示されます。移行を実行する前に、これらのメール アドレスを修正する必要があります。

すべてのユーザーを移行することを選択した場合は、Cloud サイトに同名のグループがないかどうかが確認されます。同名のグループが見つかった場合は、Server グループのユーザーが同名の Cloud グループにマージされます。この問題は修正せずに続行できますが、権限昇格が行われていないことを確認することをお勧めします。

スペースのエラー

スペースを移行する場合、スペース キーの競合が確認されます。エラーが発生した場合、次のいずれかを行えます。

• Cloud または Server の各サイトから重複スペースを削除する

• Cloud サイトをリセットする

• 対象のスペースを移行から削除することで、移行を取りやめる

移行を実行するには、スペース キーのすべての競合を解決する必要があります。

アプリ固有のエラー

次の表は、アプリに関連するエラーと警告メッセージのリストです。

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

4.d. 移行を確認する

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

すべてが適切に指定されており、移行を開始して問題ない場合は、[Run1] をクリックします。後で移行を開始する場合、または修正が必要なエラーがある場合は、[Save] をクリックします。 移行を実行するよう選択した場合も、移行計画は引き続き移行ダッシュボードに保存されます。ここで、すべての移行の進捗状況と詳細を確認できます。

4.e. 移行を管理して実行する

保存した移行は、移行ダッシュボードに一覧表示されます。ここでは、移行の詳細を表示したり移行を実行したりできます。また、移行のステータス、実行中の移行の進捗状況の確認、実行中の移行の停止、新しい移行の作成を実行できます。

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

ステータスの定義

移行後

移行のタイプによっては、移行の完了後に実行が必要な操作があります。

ユーザーとグループ

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

• [インポートしたグループを確認] に移動して、グループのメンバーを確認して権限を承認します (無料プランの場合、権限は変更できません。ユーザーとグループは元のサイトと同じ権限を保持します)。

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

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

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

スペース

スペースの移行後、それらがスペース ディレクトリに表示されるには時間がかかる場合があります。ただし、直接リンク経由でアクセスすることはできます。

スペースの移行が正常に完了したことを確認するには、次の手順を実行します。

• コンテンツとスペースを確認するか、ユーザーに自身のコンテンツを確認してもらいます。

• Former User のインスタンスがあるかどうかを確認します。これは、コンテンツをユーザーに関連付けられなかったことを意味します。

• [設定] > [アプリケーション リンク] の順に移動して、他の Atlassian 製品をリンクします。

• Jira マクロ リペアによって、Jira への任意のリンクを更新します。Cloud サイトで [設定] > [Jira Macro Repair (Jira マクロ リペア)] の順に移動して、ステップに従います。

アプリ

移行ページに、アプリの移行の進捗状況を監視する [アプリ] セクションが表示されます。この進捗トラッカーから、各アプリのデータ移行に関する進捗状況を監視できるほか、移行の完了時にステータスを確認できます。

以下の表では、アプリ移行のさまざまな進捗状況を説明します。

その他のアクション

以下のアクションを実行することも可能です。

• レガシー エディターのページを新しいエディターに変換します。ページの変換方法をご確認ください。

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

移行後アクションの詳細については「Cloud 移行ガイド」をご確認ください。 

詳細情報とサポート

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

• 移行計画の詳細については、Atlassian Migration Program の Web サイトをご参照ください。

• 技術的な問題や、戦略やベスト プラクティスによるサポートについては、サポート チームにお問い合わせください。

• 専門的なアドバイスについては「アトラシアン コミュニティ」をご参照ください。

• 専門家によるサポートが必要な場合は、アトラシアン パートナーにご相談ください。

アトラシアン サーバー製品のサポートは 2024 年 2 月に終了します。サーバーのサポート終了スケジュールで詳細をご参照ください。