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

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

Bitbucket Cloud への移行を決定する

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

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

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

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

• ユーザー: すべてのアクティブまたはライセンス済みの各ユーザー、Server インスタンスのプル リクエストに添付されている非アクティブなユーザー (所有者/作成者またはレビュアー) が、Bitbucket Cloud に移行されます。

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

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

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

3. アプリを評価する

移行の決定前に、アプリやカスタム統合を確認して Bitbucket Cloud サイトに必要なものを判断する必要があります。Atlassian Marketplace には、Bitbucket Cloud の機能を拡張するさまざまなアプリや統合が用意されています。たとえば、Slack や Gmail などの生産性向上とコラボレーションを実現する主要な SaaS 製品と連携する、無料の統合機能があります。また、人気の Server アプリの一部には、サブスクリプション ベースのライセンスもあります。評価する際は、アトラシアンの Cloud と Server の各製品は同じメリットを実現するものの、特長や機能が異なる可能性がある点にご留意ください。評価を進めるなかで、Server 上のアプリで対応できる機能が Bitbucket Cloud に含まれていることに気付く場合があります。また、社内アプリやカスタム ビルドのアプリについても検討が必要な場合があります。Bitbucket Data Center と Cloud の管理の違いに関する詳細をご確認ください。

一般に、Bitbucket Server から Bitbucket Cloud への移行にアプリのデータは含まれません。一部のアプリはデータのエクスポートおよびインポート機能を提供していますが、これが使用可能かどうかをアプリの開発元に問い合わせたり、アプリのドキュメントで確認したりする必要があります。

Bitbucket Server アプリを Bitbucket Cloud にマッピングする必要がある場合は、Marketplace に Server アプリの Cloud に対する同等製品がないかどうかを最初にご確認ください。Cloud の同等製品がない場合は、アプリがデータを保存しているかどうかをアプリの開発者にご確認ください。データが保存されている場合は、アプリ ベンダーに確認してデータ移行オプションを検討する必要があります。アトラシアンは、サードパーティ製のサーバー アプリが生成したデータを Cloud アプリへ直接移行する処理は行いません。同等品やアプリ ストア データがない場合でも、データをエクスポートする手段の有無についてベンダーに連絡する必要があります。 

4. コストを確認する 

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

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

Bitbucket Cloud で Atlassian Marketplace のアプリを使用することを計画している場合、それらも考慮に入れてコストを検討します。

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

5. Bitbucket Cloud を試用する

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

移行の準備

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

1. チームを集める

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

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

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

• 移行のタイミング

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

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

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

3. Bitbucket Server を準備する

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

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

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

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

5. ユーザーの移行

Bitbucket Cloud Migration Assistant をご利用の場合は、Server ユーザー (アクティブと非アクティブの両方) が Bitbucket Cloud の Bitbucket 移行ユーザー グループに追加されます。移行されたユーザーは Bitbucket Cloud 内のどの部分にもアクセスできません。Bitbucket 移行ユーザー グループには権限を追加しないでください。グループを作成するか、移行したユーザーを既存のグループに移動して、ユーザーに Bitbucket Cloud の任意のリポジトリやその他のコンテンツに対する必要なアクセスと権限を付与する必要があります。リポジトリのグループを整理する方法についてご確認ください。

注: 非アクティブなユーザーは、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 へのアクセス頻度が低い時間に移行を実施することをご検討ください。これによって、Server と Cloud 間でデータの矛盾が発生するリスクを減らせます。

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

Server サイトの統合

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

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

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

• Bitbucket Server の公開課題

• Bitbucket Cloud の公開課題

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

詳細情報とサポート

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

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

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

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

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

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

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