Bitbucket Server から Cloud への移行を計画する

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

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

Jira または Confluence 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 の各製品は同じメリットを実現するものの、特長や機能が異なる可能性がある点にご留意ください。評価を進めるなかで、Server 上のアプリで対応できる機能が Bitbucket Cloud に含まれていることに気付く場合があります。詳細については「Bitbucket 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 Migration ユーザー グループに追加されます。移行されたユーザーは Bitbucket Cloud 内のいかなるアクセス権も持ちません。Bitbucket Migration ユーザー グループには権限を追加しないでください。グループを作成するか、移行させたユーザーを既存のグループに移動して、ユーザーに Bitbucket Cloud の任意のリポジトリやその他のコンテンツに対する必要なアクセス権と権限を付与する必要があります。詳細については「リポジトリのグループを整理する」をご参照ください。

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

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

移行サポート

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

移行

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

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

移行方法の選択 

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

Recommended: Download and use the Bitbucket Cloud Migration Assistant from the Atlassian Marketplace. For more information on using the migration assistant, refer to Use the Bitbucket Cloud Migration Assistant to migrate. You must be using version 7.0 or later of Bitbucket Server to install and use the 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 Cloud サポート チームへのお問い合わせや、アトラシアン コミュニティの利用をご検討ください。

移行後

移行が正常に完了したら、一連の移行後のタスクを実行し、すべてがスムーズかつ効率的に機能していることを確認します。

Cloud サイトを確認する

移行が完了したら、新しい Bitbucket Cloud サイトをレビューしてデータが正常に移行されていることを確認します。次をお勧めします。

  • コミットやブランチなどについてリポジトリを確認

  • さまざまなチームやユーザーがさまざまな機能をテストする時間を確保

  • アプリの操作や機能をテストして、動作の違いが見られた場合はそれを特定して必要に応じてユーザーに共有

ユーザー権限を確認して割り当てる

Bitbucket Cloud に移行すると、必要なグループを作成してその作成したグループにメンバーを割り当て、それらのグループが任意のリポジトリにアクセスするための権限を設定する必要があります。今後のリリースで Bitbucket Cloud にユーザー権限を移行できるように取り組んでいます。詳細については「Bitbucket Cloud 移行ロードマップ」をご参照ください。

現在の Server インスタンスにあるすべての権限とユーザーのリストをクエリする方法に関する詳細をご確認ください。

プロジェクトの設定と権限

現在、Server (と Data Center) 製品と Bitbucket Cloud のプロジェクト間にあるパリティをより多く作成することに取り組んでいます。Bitbucket Cloud で利用できるプロジェクト設定と権限のリリース日とタイミングの詳細については「Bitbucket Cloud ロードマップ」をご確認ください。

初期設定のレビュアーを追加する

Server から新しい Cloud 移行先に、初期設定のレビュアーを手動で追加する必要があります。初期設定のレビュアーが移行可能になるタイミングの詳細については「Bitbucket Cloud ロードマップ」をご参照ください。

ブランチの権限

Cloud に移行すると、Server でセットアップした権限と一致するようにブランチ権限を設定する必要があります。Bitbucket Cloud におけるブランチ権限の使用に関する詳細についてご確認ください。

webhook の管理

Webhook は、Migration Assistant では Bitbucket Cloud に移行されません。現在、この機能は Bitbucket Cloud ロードマップにありません。Bitbucket Cloud における Webhook の管理に関する詳細についてご確認ください

マージ チェック

新しい Cloud 移行先において、リポジトリ全体でマージ チェックを提案または実行する必要があります。Bitbucket Cloud におけるマージ チェックの詳細については「マージ前にチェックを提案または要求する」をご参照ください。

Bitbucket Cloud ワークスペースを Jira Software に接続する

コミット、ブランチ、プル リクエスト、ビルド、デプロイを Jira にレポートすることで、開発フローに膨大な可視性がもたらされます。Bitbucket Server から移行したことによってこの価値をよく理解しているため、Bitbucket Cloud ワークスペースを Jira インスタンスに接続することをご検討のはずです。

Jira Server をご利用の場合は「Bitbucket Cloud を Jira Server に接続する」をご参照ください。

Jira Cloud をご利用の場合は「Bitbucket Cloud を Jira Software Cloud に接続する」をご参照ください。

アプリをインストールする 

インストールが必要なアプリを特定したら、そのアプリを Bitbucket Cloud サイトに追加します。

Cloud について知る

Bitbucket Cloud の新機能とその機能を最大限に活用する方法を確認するには、Bitbucket Cloud ドキュメントをご確認ください。Bitbucket Cloud を初めて導入する場合は、このリソースをユーザーと共有することをお勧めします。また、Bitbucket Cloud の管理者として作業を開始する際は、Atlassian Cloud ドキュメントが役立ちます。

チームを迎える

移行が完了したので、組織の準備が整っていることを確認します。新しい Bitbucket Cloud サイトの情報をチームと共有する、包括的なローンチ コミュニケーション計画を作成することをお勧めします。これには次のようなトピックが含まれます。

  • 移行後に必要なアクションの例

    • パスワードのリセット

    • アバターのリセット

    • 移行されたリポジトリのローカルのリモート URL の更新

  • 新しいサイトへのアクセスに使用する URL

  • 質問の問い合わせ先 (たとえば、課題やフィードバックを送信できるチャット ルームや課題トラッカーがあるかどうか)

  • ユーザーが認識しておくべき重大な変更

  • その他の資料や FAQ へのリンク

Jira Cloud の利用を開始

これで Cloud 管理者になったので、アトラシアンの最新の機能やバグ修正を即座に利用できます。インストール、アップグレード、パッチはアトラシアンによってシームレスに管理されるため、週末の対応は不要です。 

Atlassian Cloud ドキュメントのブログをフォローすると、Bitbucket Cloud 製品の全ユーザーに影響する主要な変更を追跡できます。これには、すべての Atlassian Cloud 製品全体の新機能、バグ修正、その他の変更が含まれます。また、「Bitbucket Cloud の一般機能の改善ロードマップ」を確認することで、Bitbucket Cloud の最新機能をいち早く把握できます。

詳細情報とサポート

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

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

その他のヘルプ