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

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

移行を計画する準備ができていない場合は、Cloud 移行の詳細または Cloud ロードマップについてご確認ください。

Bitbucket Cloud への移行を決定する

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

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

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

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

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

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

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

3. アプリを評価する

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

下の移行セクションのステップ 1 で説明したその他の移行方法のいずれかを使用している場合は、リポジトリのみが Cloud に移行されます。

移行サポート

移行のサポートが必要な場合は、アトラシアン製品の豊富な移行経験を持つ世界中に広がるパートナー ネットワークを利用できます。お客様の移行をサポートできるパートナーをお探しの場合は、アトラシアン パートナー ページのお問い合せフォームをご利用ください。

移行

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

Bitbucket Cloud への移行には、Bitbucket Cloud Migration Assistantの利用をお勧めします。Migration Assistant を利用して Cloud に移行する方法については、「Bitbucket Cloud Migration Assistant を使用して移行する」をご参照ください。

移行方法の選択 

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

推奨: Atlassian Marketplace から Bitbucket Cloud Migration Assistant をダウンロードして使用します。Migration Assistant の使用に関する詳細は、「Bitbucket Cloud Migration Assistant を使用して移行する」をご確認ください。Bitbucket Cloud Migration Assistant をインストールして使用するには、Bitbucket Server のバージョン 7.0 以降を使用している必要があります。

アトラシアンのリポジトリ インポーターを使用して個々のリポジトリをインポートします。インポートを使用した移行を行うには、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 Cloud サポート チームへのお問い合わせや、アトラシアン コミュニティの利用をご検討ください。

詳細情報とサポート

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

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

その他のヘルプ