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

はじめる前に

Bitbucket Cloud アカウントにサインアップすると、30 日間の評価期間が与えられます。クラウドへの移行予定があり、評価期間の延長をご希望の場合は、請求とライセンスのサポート チームにお問い合わせください。評価期間をさらに 60 日間延長できます。

注：移行を実行するには、Standard プランまたは Premium プランが必要です。プランと請求に関する詳細をご確認ください。

Bitbucket Cloud への移行計画に関する詳細については「Bitbucket Server から Cloud への移行を計画する」をご参照ください。

Bitbucket Cloud Migration Assistant をダウンロードしてインストールする

Bitbucket Cloud Migration Assistant は、リポジトリやプル リクエストを Bitbucket Server からクラウドに移動させるのに役立つアプリです。Bitbucket Server インスタンス内のすべてのアクティブ ユーザーも Bitbucket Cloud のワークスペースに移行されます。それらにアクセスし、ワークフローを横断して適切な権限や設定を付与できます。

アトラシアンによって構築および保守されている Bitbucket Cloud Migration Assistant は、無料でインストールして使用できます。Migration Assistant の最新バージョンには Atlassian Marketplace からアクセスできます。Bitbucket Cloud Migration Assistant をインストールして使用するには、Bitbucket Server のバージョン 7.0 以降を使用している必要があります。

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

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

新しい移行を設定するには [移行を管理] を選択します。その後、新しい移行を作成できるようになります。 

サーバー インスタンスをクラウドに移行するために必要な内容をよりよく理解するには「仕組み」ページをご参照ください。次の 5 つの主なステップで、サーバーからクラウドへの移行を設定して実行します。これらのステップを確認したら [クラウドに接続] ボタンを選択して開始します。

クラウドに接続

1. クラウド移行計画の名前を追加します。

2. [Choose cloud destination (クラウド移行先を選択)] を選択して、移行計画にクラウド移行先のワークスペースを追加します。

   1. 移行をすでに開始または保存しましたか？クラウド移行をすでに開始している、または後日完了するために移行を保存している場合は、[ワークスペースを選択] ドロップダウンのリストからクラウド移行先のワークスペースを選択し、[次へ] を選択します。

   2. Bitbucket Cloud を初めてお使いですか？Bitbucket Cloud アカウントをまだ持っていない場合は [Bitbucket アカウントを無料で作成] を選択します。[アトラシアンの管理] でワークスペースを作成することをお勧めします。既に Jira や Confluence を使用している場合にワークスペースを作成すると、Bitbucket Cloud が既存の組織に追加されます。ヘルプ ドキュメント「ワークスペースへの参加、またはワークスペースの作成」の手順に従ってください。

3. [クラウドの移行先を選択] モーダルが表示されたら [続行] を選択します。新しいページが表示されたら、既存の Bitbucket Server ベース URL と新しいクラウドの移行先を入力します。

4. Bitbucket Server ベース URL を探すには、次の手順に従います。[管理] > [管理] ナビゲーション バーの [システム] にある [サーバー設定] の順に選択して [サーバー設定] にある [ベース URL] をコピーします。

5. [移行元] テキスト フィールドに Bitbucket Server ベース URL を追加します。

6. [移行先] で [ワークスペースを選択] ドロップダウン > サーバー インスタンスから移行先のワークスペースの順に選択します。

7. [Allow Atlassian to access migration data (アトラシアンに移行データへのアクセスを許可する)] チェックボックスをチェックします。

8. [確認] を選択します。

移行対象を選択

ユーザーを移行して、Bitbucket Cloud に移行するリポジトリを選択します。

ユーザーの移行

[アトラシアンの管理] のワークスペース

ワークスペースが admin.atlassian.com 内の組織にある場合は、Server インスタンスの管理者レベルのユーザーは全員、[アトラシアンの管理] の既定の「管理者」ロール グループに移行されます。その他のライセンス ユーザーは全員、[アトラシアンの管理] の Bitbucket ワークスペースの既定の「ユーザー」ロール グループに移行されます。

Bitbucket 管理のワークスペース

サーバーのユーザーは、Bitbucket Cloud の Bitbucket Migration ユーザー グループに追加されます。注: 移行されたユーザーは Bitbucket Cloud 内のアクセス権を持ちません。グループを作成するかユーザーを既存のグループに移動して、移行したユーザーに Bitbucket Cloud のリポジトリやその他のコンテンツに対する必要なアクセス権と権限を付与する必要があります。

• [Choose repositories (リポジトリを選択)] を選択して、クラウド移行プロセスの次のステップに進みます。

移行するリポジトリを選択する

1. クラウド移行先に移行するリポジトリを選択します。

2. クラウド移行先に移行するすべてのリポジトリとプロジェクト > [Add to migration (移行に追加)] の順に選択します。

エラーの有無の確認

このステップを開始する際に、Bitbucket Cloud Migration Assistant が移行をレビューして一般的なエラーがないかどうかを確認します。

Bitbucket Cloud Migration Assistant は、次のようなエラーについて確認します。

• Migration Assistant の最新バージョンを実行していることを確認する

• Bitbucket の Standard または Premium プランを利用していることを確認する

• [アトラシアンの管理] にワークスペースがあるかどうかを確認する

• すべてのアクティブ ユーザーが一意で有効なメール アドレスを持っていることを確認する

• すべてのプロジェクトに、文字数制限、書式、説明の長さなどの有効な情報が含まれていることを確認する

• すべてのリポジトリがサーバー インスタンスに存在することを確認する

• すべてのリポジトリが Bitbucket Cloud リポジトリのサイズ制限内に収まっていることを確認する

• すべてのリポジトリに、名前とスラッグの重複や文字制限、または書式の問題など、有効な情報が含まれていることを確認する

エラー メッセージのステータス

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

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

チェック後に赤いエラーが表示された場合は、移行を実行する前にエラーを解決する必要があります。

実行可能な対応策

• 移行を確認 - 警告レベルのエラーが存在しているものの移行を妨げていない場合に、移行する準備ができていればこれを選択します。

• 保存 - 移行を保存して、ブロッカーの修正後や移行を実行する時間ができてから戻れます。

• すべて更新 - ブロッカーの削除やエラーの修正を行った後、移行の確認を続行する前にこのページを「更新」して、未解決のエラーや残っているエラーがないかどうかを確認します。

移行の確認

これは、Bitbucket Cloud Migration Assistant で設定した移行を実行する前の最後のステップとなります。未解決のエラーが残っているものの警告のみでブロッカーではない場合は、移行を実行できますが問題が発生する可能性があります。クラウド移行先への移行を実行する前に、既存のエラーを修正または軽減しておくことがベスト プラクティスとなります。

未解決のエラーを修正する

既存のエラーを修正すると [更新] を選択して移行レビュー パネルを再読み込みできます。未解決のエラーに関する詳細を確認するには [詳細を表示] リンクを選択します。これによって、移行プロセスの [チェック] ステップに戻って既存のエラーにアクセスして修正できます。

今すぐまたは後日移行する

移行を実行する

すべてが正しく表示されて現在の移行を妨げるエラーが軽減された場合は [実行] を選択して移行の実行を開始します。移行アシスタントで説明したように、リポジトリや関連データのサイズとアップロード速度によっては、移行に数分から数時間かかる場合があります。

移行を保存する

後日実行するために移行を保存する、または保存する必要がある場合は [保存] を選択します。これによって、移行が移行ダッシュボードに保存されます。このダッシュボードにアクセスするには、Bitbucket Server の [管理] 設定に移動して、左側のナビゲーション サイドバーで [クラウドに移行] を選択します。

移行の詳細を表示して、Bitbucket Cloud ワークスペースにアクセスする

[実行] を選択して移行を開始すると、移行の詳細を確認できる画面が表示されます。見出し [This migration includes (この移行に含まれるもの)] にある [リポジトリ] ドロップダウンを展開すると、どのリポジトリが明示的に移行されているかを確認できます。

成功

移行が正常に完了したら [Go to cloud workspace (クラウド ワークスペースに移動)] を選択して、移行したデータを含む Bitbucket Cloud ワークスペースにアクセスします。

エラーありで成功

移行が完了しても、エラーが返されることがあります。[クラウド ワークスペースに移動] を選択してクラウド ワークスペースをチェックし、正常に移行された内容を確認します。この時点から、新しい移行を開始するかサーバーで現在のインスタンスの ZIP ファイルをダウンロードして、サポート チームにご連絡ください。

移行の失敗

移行に失敗した場合は、エラーを回避する新しい移行を作成するかサーバー インスタンスの ZIP ファイルを作成して、サポート チームにご連絡ください。

詳細情報とサポート

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

• Bitbucket Cloud サポート チームが、移行に関する技術的な質問や問題について支援します。

• 大規模な移行で支援が必要な場合、Atlassian 製品の豊富な移行経験を持つ、世界中に広がるパートナー ネットワークを利用できます。お客様の移行を支援できるパートナーをお探しの場合は、お問い合せください。

• また、アトラシアン コミュニティもご利用ください。

• エキスパートによる支援が必要な場合、アトラシアン パートナーにご相談ください。

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