Bitbucket の移行前チェックリスト

このガイドでは、Cloud 移行のプロセス前とプロセス中の推奨アクティビティについて概説します。ここでは、チームの登録、テクノロジー オプションの評価、現在の Bitbucket Server/Data Center サイトが移行可能かどうかの確認、移行の実行について説明します。 

Bitbucket Cloud への移行を決定する

1. 移行できる内容を把握する

現在、Bitbucket Cloud Migration Assistant では次の移行をサポートしています。

• リポジトリ Git 情報: リポジトリが Server にあるプロジェクトの一部である場合、リポジトリは Server プロジェクト名で新しいプロジェクトに移行されるか、Cloud の移行先に既に存在する同名のプロジェクトに追加されます。注: 現時点では、フォークされたリポジトリの移行はサポート対象外です。Cloud への移行前にフォークからオープン プル リクエストをマージして、データの破損を防ぎます。

• プル リクエスト情報: タイトル、説明、プル リクエストのステータス (オープン、マージ、拒否)、コードの差分、コメント、タスク、作成者/レビュアー。

• ユーザー: 移行するユーザーを選択します。すべての Server ユーザーをクラウドに移行することも、移行するリポジトリとユーザー アクセスに応じて一部のユーザーだけを移行することもできます。注: Bitbucket の請求をアップデートするため、Free プランを利用していて 5 人以上のユーザーを移行する場合は、Bitbucket Cloud の Standard プランまたは Premium プランが必要です。

アトラシアンが管理するワークスペースのみ

• グループ: すべてのグループを移行するか、同時にクラウドに移行するユーザー、リポジトリ、権限に関連する Server のグループを移行するか、Server から Cloud にグループを移行しないかを選択できます。

• 権限: Server から Cloud への移行を選択したすべてのグローバル権限と、ユーザー、グループ、リポジトリに関連するすべての権限をコピーするか、Bitbucket Cloud に権限をコピーしないかを選択できます。注: Server 内の非アクティブなユーザーの権限やブランチング モデルへの関連付けは、クラウドに移行されません。

Bitbucket Cloud Migration Assistant を使用して移行されるものと移行されないものに関する詳細は、「Bitbucket Cloud Migration Assistant で移行されるもの」をご確認ください。

2. セキュリティとコンプライアンスの各要件を確認する

移行を成功させるためには、組織のセキュリティ要件を順守することが不可欠です。アトラシアンのセキュリティ、プライバシー、コンプライアンス ポリシーの詳細については、Atlassian Trust Center をご確認ください。この時点で、Bitbucket Cloud が要件を満たしていることを確認するために、調達やセキュリティの各チームと連携することをお勧めします。Atlassian Trust Center の詳細をご確認ください。

3. Evaluate Marketplace apps

Before deciding to migrate, review any Marketplace apps and custom integrations you have to determine what you'll need for your Bitbucket Cloud site. The Atlassian Marketplace offers a variety of Marketplace apps and integrations that extend the functionality of Bitbucket Cloud. These include free integrations with leading SaaS productivity and collaboration products like Slack and Gmail, and subscription-based licensing of some of your most beloved Server apps. Keep in mind while you're evaluating that while Atlassian’s Cloud and Server instances provide the same benefits, they can differ in features and functionality. As you evaluate, you may discover that Bitbucket Cloud includes functionality that is fulfilled through an app on Server. You may also have in-house or custom-built apps to consider. Learn more about the differences in administering Bitbucket Data Center and Cloud

Marketplace app data is not typically included when migrating from Bitbucket Server to Bitbucket Cloud. Some Marketplace app do have the capability to export and import their data but you'll need to check with the app developers or their documentation to confirm if this is possible.

If you do need to map Bitbucket Server apps to Bitbucket Cloud, first check if there is a Cloud equivalent of your Server app in our Marketplace. If there is a Cloud equivalent, your next step would be to check with the app developer to see if it stores any data. If it does, you'll need to work with the Marketplace app vendor to understand your data migration options. Atlassian doesn't directly handle migrating data generated from third-party Marketplace app. If there's no equivalent and the app stores data, you should still contact the vendor to see if there's a way to export the data. 

4. コストを確認する 

Bitbucket Cloud サブスクリプションを除き、Bitbucket Cloud への移行に対する費用は発生しません。ただし、支払いオプションと全体的なコストの評価は必要です。

ユーザー単位の月間サブスクリプションとして提供される Bitbucket Cloud には、Free、Standard、Premium の 3 つの異なる料金プランがあります。Bitbucket ライセンスの詳細をご確認ください。

If you're planning on using Marketplace apps in Bitbucket Cloud, remember to factor these into your cost considerations.

既存の Bitbucket Server ライセンスと保守は Bitbucket Cloud に移転されません。2 つのライセンスは独立しており、それぞれに支払いが発生します。

5. Bitbucket Cloud を試用する

無料の Bitbucket Cloud 移行トライアルにサインアップして、Bitbucket Cloud をお試しください。Bitbucket Server と Bitbucket Cloud では、デザイン、ユーザー インターフェイス、管理エクスペリエンスが異なる可能性がありますが、これらは切り替えられません。移行前に Bitbucket Cloud を試用して、Bitbucket Server との違いを確認し、ユーザーのオンボーディングに役立つ情報共有やトレーニングを検討することをお勧めします。無料のクラウド移行トライアルに関する詳細をご確認の上、お申し込みください。 

移行の準備

移行することを決定したら、それに向けた準備を進めます。

1. チームを集める

Bitbucket Server から Cloud への移行は、ユーザーのエクスペリエンスやワークフロー、組織全体のさまざまな関係者に影響する可能性があります。組織の規模とユーザー数に応じて、移行では複数のチーム全体のロールや責任が定義されている、完全に独立したプロジェクトが必要となる場合があります。Bitbucket Cloud への移行に関心がある、または移行の影響を受ける可能性のある個人や関係者に、できるだけ早期に連絡することをお勧めします。可能であれば、これらのスタッフをチームに加えてプロセスの一部として参加を依頼します。

2. 早期に頻繁に連絡する

移行スケジュールについて組織に知らせる前に、チーム メンバーと移行計画を共有します。発生する問題やエラーについて、ユーザーにどのように警告するかを決定します。この段階では、移行のコミュニケーション計画に次のような内容を含める必要があります。

• 移行のタイミング

• ユーザーが想定すべきダウンタイム

• 移行中はあらゆる変更を加えないよう、ユーザーに依頼する

• 移行後の古いサイトへの影響。アクセスまたは読み取りが引き続き可能かどうか

3. Bitbucket Server を準備する

現在の環境を評価して、データの移行前に変更が必要かどうかを判断します。移行前にすべてのオープンなプル リクエストを終了、マージまたはクローズすることをお勧めします。これによって、移行後にすべての新しいプル リクエストが Bitbucket Cloud で直接作成されます。また、Server ユーザー ベースを確認して、非アクティブなユーザーや新しい Cloud 移行先に移行不要なユーザーを整理します。

注: サーバーでは、同名または slug のリポジトリを複数持てますが、Bitbucket Cloud ではそれぞれのリポジトリ名と slug が一意である必要があります。問題を回避するには、クラウドに移行する前に、リポジトリの名前と slug がサーバー インスタンス全体で一意であることをご確認ください。

4. 認証オプションを評価する 

Bitbucket Cloud は、Atlassian Guard Standard のサブスクリプションで SAML SSO をサポートしています。組織内のすべてのユーザーに SAML SSO を設定できます。ユーザーが Bitbucket Cloud の Web インターフェイスにアクセスすると、ログインするために SSO プロバイダーにリダイレクトされます。ただし、ユーザーの SSO 認証情報は Git 操作には有効ではありません。ユーザーは https 認証にアプリ パスワードを使用するか、Git 操作のために SSH 認証に切り替える必要があります。

5. ユーザーの移行

Bitbucket Cloud 移行アシスタントを使用している場合は、移行するユーザーを選択できます。すべての Server ユーザーをクラウドに移行することも、移行するリポジトリとユーザー アクセスに応じて一部のユーザーだけを移行することもできます。

注: 非アクティブなユーザーは、Cloud に移行した後も非アクティブなままとなります。つまり、これらのユーザーは Bitbucket Cloud プランのユーザーとして計上されません。

移行サポート

移行に関する支援が必要な場合、アトラシアン製品の豊富な移行経験を持つ、世界中に広がるパートナー ネットワークを利用できます。アトラシアン パートナーの詳細をご確認ください。

移行

必要な前提条件を満たして移行前のフェーズに関連するタスクを完了すると、移行の実行準備が整います。以下に概説するステップでは、Server インスタンスから新しい Cloud 移行先への移行に関するガイダンスを提供します。

移行方法の選択 

次の方法で Cloud にデータを移行するできます。

推奨: Bitbucket Cloud Migration Assistant をご使用ください。インストールして使うには、Bitbucket Server のバージョン 7.0 以降を使用している必要があります。Bitbucket Cloud Migration Assistant の詳細をご確認ください。

アトラシアンのリポジトリ インポーターを使用して個々のリポジトリをインポートします。インポートを使用した移行を行うには、Bitbucket Server ドメインに外部からアクセス可能である必要があります。外部からアクセスできない場合、Bitbucket Cloud はインポートのために Bitbucket Server にアクセスできません。

Bitbucket Cloud で新しいリポジトリを作成し、ローカル リポジトリから Bitbucket Cloud の新しいリポジトリにプッシュすることもできます。

多数のリポジトリがある場合、Bitbucket Cloud の API を使用して、リポジトリの作成およびプッシュを一括で行うことができます。

テスト移行の実行

テストまたはステージング サイトでトライアルを実行して、すべてが期待どおり動作していて移行がスムーズに実行されるかどうかを確認することをお勧めします。これは、無料の Bitbucket Cloud 移行トライアルによって行えます。テスト移行は次のことに役立ちます。

1. 実際の移行の前に解決する必要がある潜在的な問題を特定して手順を確認します。これによって次を行えます。

   • 予想されるダウンタイムも含めた、実際の移行のタイムラインの明確化。

   • Bitbucket Cloud に移行する前のデータの検証。

2. タイムラインの構築: ユーザーの満足度のため、最適な移行ウィンドウを特定する必要があります。トラブルシューティングにかかる時間を考慮したうえで、移行にかかる時間を判断します。夜間、週末、またはチームの Bitbucket へのアクセス頻度が低い時間に移行を実施することを検討します。これにより、サーバー製品とクラウド製品との間でデータの矛盾が発生するリスクを減らすことができます。

3. クラウドに移行: 選択した移行方法を使用して、本番環境の移行を実行します。サーバーをロックダウンしたり、移行期間中に変更を加えないようにユーザーに通知したりすることを忘れないでください。ユーザーを安全にクラウドに招待する前に、テストとトラブルシューティングを実施する必要があります。 

Server サイトの統合

移行ではさまざまな事例が考えられます。リポジトリ インポーターをご利用で複数の Server サイトをマージする必要がある場合は、各サイトで同じプロセスに従ってリポジトリをインポートしてユーザーを Cloud サイトに追加します。リポジトリ インポーターの詳細をご確認ください。

移行のトラブルシューティング

移行中に問題が発生した場合、アトラシアンのさまざまなリソースを活用できます。最初に、アトラシアンの公開課題トラッカーで Bitbucket Server または Bitbucket Cloud に関する既知の問題を探すことをお勧めします。Bitbucket の移行で発生する一般的な問題の一部に関する情報 (ステータスや推奨される回避策など) を見つけることができます。

• Bitbucket Server の公開課題

• Bitbucket Cloud の公開課題

異なる質問が発生した場合、または移行を進めるのに支援が必要な場合は、Bitbucket Cloud サポート チームにお問い合わせください。

詳細情報とサポート

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

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

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

• 専門的なアドバイスについては、アトラシアン コミュニティもご利用ください。

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

• Bitbucket Cloud への移行後に実行すべきことを把握するには、「Bitbucket Cloud への移行後」ヘルプ ドキュメントをご確認ください。

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