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

概要

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

移行を計画する準備ができていない場合は、クラウド移行の詳細かクラウド ロードマップについてご参照ください。

サーバー製品と Data Center 製品の重要な変更

アトラシアンでは新しいサーバー ライセンスの販売を終了しました。また、サーバー製品のサポートは 2024 年 2 月 2 日に終了します。Data Center については複数の主要な改善を含め、投資を継続いたします。変更の内容については、こちらでご確認ください。

このガイドの対象者

このガイドは次のような場合にご利用いただけます。

  • Bitbucket Server から Bitbucket Cloud への移行を行うかどうかを検討したいとき。

  • 移行を行うことを決定し、移行の計画および実行方法を確認したいとき。

Jira または Confluence Cloud への移行もお考えですか? 詳細については、「Jira Server から Cloud への移行リソース」または「Confluence Server から Cloud への移行リソース」をご確認ください。

移行前

  1. 移行できる内容について: 現在、Bitbucket Migration Assistant では次の移行をサポートしています。

    1. リポジトリ Git 情報 - リポジトリがサーバー内のプロジェクトの一部である場合、リポジトリはサーバー プロジェクト名で新しいプロジェクトに移行されるか、クラウドの宛先に既に存在する同名のプロジェクトに追加されます。注: 現時点では、フォークされたリポジトリの移行はサポートされていません。フォークからオープン プル リクエストをマージして、クラウドに移行する前にデータの破損を防ぎます。

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

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

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

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

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

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

  4. コストの確認: Bitbucket Cloud サブスクリプションを除き、Bitbucket Cloud への移行に対する費用は発生しません。ただし、支払いオプションおよび全体的なコストの評価は必要です。次の点を考慮します。

    1. Bitbucket Server とは異なり、Bitbucket Cloud はユーザー単位の月間サブスクリプションとして提供され、Free、Standard、および Premium の 3 つの異なる料金プランがあります。チームに最適なプランの決定や月額コストの見積りについては「Bitbucket のライセンス」をご参照ください。

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

    3. 既存の 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. プロアクティブかつ頻繁に連絡する: 移行スケジュールについて組織に知らせる前に、チーム メンバーと移行計画を共有します。発生する問題やエラーについて、ユーザーにどのように警告するかを決定します。この段階では、移行のコミュニケーション計画に以下のような内容を含める必要があります。

    1. 移行のタイミング

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

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

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

  3. Bitbucket Server を準備: 現在の環境を評価して、データの移行前に変更が必要かどうかを判断します。移行前にすべてのオープンなプル リクエストを終了、マージまたはクローズすることをお勧めします。これによって、移行後にすべての新しいプル リクエストが Bitbucket Cloud で直接作成されます。また、サーバー ユーザー ベースを確認して、非アクティブなユーザーや、新しいクラウド移行先に移行不要なユーザーを整理します。注: サーバーでは、同名または slug のリポジトリを複数持てますが、Bitbucket Cloud ではそれぞれのリポジトリ名と slug が一意である必要があります。問題を回避するには、クラウドに移行する前に、リポジトリの名前と slug がサーバー インスタンス全体で一意であることをご確認ください。

  4. 組織をセットアップする: 組織を使用すると、社内のすべての Atlassian Cloud ユーザーを 1 か所で確認してユーザーのアカウントを管理し、SAML SSO などのセキュリティ機能をセットアップできます。組織は、社内で 2 つ以上の Atlassian Cloud サイトを使用していて、すべてのサイト、製品、それらにアクセスできるユーザーを 1 か所で確認する際に、非常に便利です。Atlassian 組織のセットアップの詳細。

  5. 認証オプションの評価: Bitbucket Cloud では、Atlassian Access をサブスクライブしている場合に SAML SSO がサポートされます。組織のすべてのユーザーに SAML SSO を構成できます。ユーザーが Bitbucket Cloud の web インターフェイスにアクセスすると、ログインのためにご利用の SSO プロバイダにリダイレクトされます。しかしながら、ユーザーの SSO 資格情報を Git 操作で使用することはできません。ユーザーは https 認証でアプリ パスワードを使用するか、Git 操作での SSH 認証の使用に切り替える必要があります。

  6. ユーザー移行: Bitbucket Cloud Migration Assistant を使用している場合、サーバー ユーザーは Bitbucket Cloud の Bitbucket Migration ユーザー グループに追加されます。注: 移行されたユーザーは Bitbucket Cloud 内のアクセス権を持ちません。グループを作成するかユーザーを既存のグループに移動して、移行したユーザーに Bitbucket Cloud のリポジトリやその他のコンテンツに対する必要なアクセス権と権限を付与する必要があります。注: 移行セクションのステップ 1 で説明したその他の移行方法のいずれかを使用している場合は、リポジトリのみがクラウドに移行されます。

その他の考慮事項

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

移行

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

現時点では、Bitbucket Cloud への移行に関する推奨方法は、以下の移行方法にリストされている Bitbucket Cloud Migration Assistant を使用することです。Migration Assistant を使用してクラウドに移行する方法については「Bitbucket Cloud Migration Assistant を使用して移行する」をご参照ください。

  1. 移行方法を選択する: クラウドへデータを移行する際は、次の複数の方法を使用できます。

    1. 推奨: Atlassian Marketplace から Bitbucket Cloud Migration Assistant をダウンロードして使用します。Migration Assistant の使用に関する詳細については、ヘルプ ドキュメント「Bitbucket Cloud Migration Assistant を使用して移行する」をご参照ください。

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

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

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

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

    1. 実際の移行の前に解決する必要がある潜在的な問題や手順の確認。

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

    3. Bitbucket Cloud への移行前のデータの検証。

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

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

一般的なシナリオ

移行ではさまざまな事例が考えられます。一般的な移行シナリオと、それぞれへの対応方法についてのガイダンスを以下に示します。

  • サーバー サイトのマージ: リポジトリ インポーターを使用していて複数のサーバー サイトをマージする必要がある場合は、各サイトで同じプロセスを実行してリポジトリをインポートし、クラウド サイトにユーザーを追加します。

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

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

異なる問題が発生した場合や、移行に際してサポートが必要な場合は、Bitbucket Cloud サポート チームへのお問い合わせや、アトラシアン コミュニティの利用をご検討ください。

移行後

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

  • クラウド サイトの確認: 移行が完了したら 新しい Bitbucket Cloud サイト をレビューし、データが正常に移行されていることを確認します。以下を推奨します。

    • リポジトリのコミットやブランチの確認。

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

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

  • ユーザー権限: Bitbucket Cloud に移行すると、必要なグループを作成してこれらのグループにメンバーを割り当て、それらのグループが任意のリポジトリにアクセスするための権限を設定する必要があります。今後のリリースで Bitbucket Cloud にユーザー権限を移行できるように取り組んでいます。詳細については「Bitbucket Cloud 移行ロードマップ」をご参照ください。現在のサーバー インスタンスのすべての権限とユーザーのリストをクエリする方法の詳細については、サポート ドキュメント「Bitbucket のリポジトリのすべての権限とユーザーをリストにする | Bitbucket Data Center および Server | アトラシアン ドキュメント」をご参照ください。

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

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

  • ブランチ権限: クラウドに移行すると、サーバーで設定した権限と一致するようにブランチ権限を設定する必要があります。Bitbucket Cloud でブランチ権限を使用する方法の詳細については「ユーザー ブランチ権限のサポート ドキュメント」をご参照ください。

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

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

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

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

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

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

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

      • パスワードのリセット

      • アバターのリセット

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

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

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

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

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

Jira Cloud の利用を開始

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

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

詳細情報とサポート

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

その他のヘルプ