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

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

Bitbucket Cloud への移行を決定する

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

Currently, we support migrating the following with the 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 内の非アクティブなユーザーの権限やブランチング モデルへの関連付けは、クラウドに移行されません。

For more details on what is and is not migrated using the Bitbucket Cloud Migration Assistant, check out What gets migrated with Bitbucket Cloud Migration Assistant.

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

Adhering to your organization's security requirements is critical to a successful migration. For more information about Atlassian's security, privacy, and compliance policies, check out the Atlassian Trust Center. At this point, you may want to work with your procurement or security teams to make sure Bitbucket Cloud meets your requirements. Learn more about 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 is offered as a monthly subscription on a per-user basis, with three different pricing plans: Free, Standard, and Premium. Learn more about Bitbucket licensing

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 を試用する

Sign up for a free Bitbucket Cloud migration trial to give Bitbucket Cloud a spin. Keep in mind that the design and user interface and administration experience can vary across Bitbucket Server and Bitbucket Cloud, and you can't switch between the two. We recommend trying Cloud before migrating to get comfortable with the differences and identify any communications or training needed to help onboard your users. Learn more about and claim your free cloud migration trial. 

移行の準備

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

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 プランのユーザーとして計上されません。

移行サポート

If you need assistance with your migration, we have a wide network of partners globally that are very experienced in Atlassian migrations. Learn more about Atlassian Partners

移行

必要な前提条件を満たして移行前のフェーズに関連するタスクを完了すると、移行の実行準備が整います。以下に概説するステップでは、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 の新しいリポジトリにプッシュすることもできます。

If you have a lot of repositories, Bitbucket Cloud provides APIs for you to script the creation and pushing of repositories in bulk.

テスト移行の実行

We recommend performing a trial run in a testing or staging site to ensure that everything is working as expected and the migration runs smoothly. You can do this using a free Bitbucket Cloud migration trial. The test migration will help you:

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

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

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

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

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

Server サイトの統合

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

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

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

• Bitbucket Server の公開課題

• Bitbucket Cloud の公開課題

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

詳細情報とサポート

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

• Our Bitbucket Cloud support team can help with technical questions or issues related to your migration.

• For help with a large-scale migration, we also have a wide network of partners globally that are experienced in Atlassian migrations. Get in touch to find one who can help with your migration.

• Looking for peer advice? Ask the Atlassian Community.

• Want expert guidance? Work with an Atlassian Partner.

• Check out our After migrating to Bitbucket Cloud help documentation to get a clear understanding of what needs to be done once you’ve migrated to Bitbucket Cloud.

Support for Atlassian Server products ends in February, 2024. Learn more about the Server end of support timeline.