こんにちは。
リックソフトの大崎です。

前編ではJiraとBitbucketのCloud移行のために知っておきたい知識をご紹介しました。
今回は実際に移行する手順をご紹介します。

■Jira Software Server の移行

まずは Jira Cloud Migration Assistant を使用して、Jira Software プロジェクトを Atlassian Cloud へ移行します。

1. Jira Cloud Migration Assistant のインストール

Jira 8.14 以上のバージョンでは Jira Cloud Migration Assistant は元々インストールされていますが、Jira 8.14 以前のバージョンでは手動でインストールする必要があったり、移行実施時点での Jira Cloud Migration Assistant が最新バージョンである必要があります。

Jira アプリの管理画面を開き、Jira Cloud Migration Assistant をインストールします。

2. 移行の実施

Jira 管理画面、Jira Cloud Migration Assistant のページから移行を行います。

画面に従い移行先のサイトを指定します。

移行するプロジェクトを選択します。

移行するデータに問題ないことを確認したら、移行を実行します。

移行完了です。

3. Jira Software Cloud と Bitbucket Serverを連携してみる

Jira Cloud Migration Assistant を使用した Jira の移行が完了したので、Jira Software Cloud 側で課題を確認します。

Jira Software Cloud の課題を表示してみると、報告者や担当者、コメントなどの情報は移行されていますが、開発パネルに表示されていた Bitbucket の開発情報は表示されていません。

Jira Software Cloud の環境はまだ Bitbucket と接続していないので、開発に関する情報を連携できないためです。

Jira Software Cloud と Bitbucket Server のアプリケーションリンクを作成してみます。

Jira Software Cloud の製品管理画面 > 統合 > アプリケーションリンク のページから Bitbucket Server インスタンスのベース URL を入力し、新しいリンクを作成します。

Jira Software Cloud と Bitbucket Server のアプリケーションリンクが正しく作成されると、課題に開発情報が表示されるようになりました。

Bitbucket Server への OAuth を許可すれば、ブランチやコミットの詳細な内容も確認することができます。

これで、Jira と Bitbucket の移行に期間があいてしまっても開発作業は継続して進めることができます。

■Bitbucket Server の移行

続けて、Bitbucket Cloud Migration Assistant を使用して Bitbucket Server を Cloud へ移行します。

1. Bitbucket Cloud Migration Assistant のインストール

Bitbucket Cloud Migration Assistant は正式リリースされていないため Atlassian Marketplace からインストールすることはできません。

Early Access Program (EAP)サイトである Download the Bitbucket Cloud Migration Assistant (英語) のページからアプリの .jar ファイルをダウンロードし、Bitbucket 管理画面 > アプリの管理 画面から .jar ファイルをアップロードしてインストールしてください。

2. 移行の実施

Bitbucket 管理画面、Bitbucket Cloud Migration Assistant のページから移行を行います。

画面に従い移行先のワークスペースを指定します。

移行するリポジトリを選択します。

移行するデータに問題がないことを確認したら、移行を実行します。

移行完了です。

3. Jira Software Cloud と Bitbucket Cloudを連携してみる

Bitbucket Cloud Migration Assistant を使用した Bitbucket Server の移行が完了したので、Bitbucket Cloud 側でプロジェクト、リポジトリの情報を確認します。

対象のワークスペースを確認してみると、問題なくすべてのプロジェクトやリポジトリが移行されていました。

移行後の Bitbucket Cloud はまだ Jira Software Cloud と接続していないので、Jira Software Cloud - Bitbucket Cloud 間での連携はされていません。

Jira のアプリケーション管理画面 > 統合 > DVCSアカウント のページから、Bitbucket Cloud のワークスペースをリンクします。

ワークスペースとの接続が完了しました。

Bitbucket Cloud のワークスペースと接続が完了したら Jira Software Cloud と Bitbucket Server インスタンスのアプリケーションリンクを削除し、Jira Software Cloud - Bitbucket Cloud との連携として Jira 課題から開発情報を確認することができます。

■Bitbucket Cloud Migration Assistant を使用してみての注意点と今後に期待すること

今回ブログでご紹介した移行検証では、規模の小さい環境で検証をしてみたので比較的スムーズに移行することができました。

弊社内でもいくつかの移行検証をしてみましたが、シェルスクリプトや REST API を駆使したプログラムを作って移行するよりも、Web 画面の操作でプロジェクト、ユーザー、プルリクエストも移行することができるので非常に楽に移行することができました。

検証の中で気づいた注意点や今後に期待することをいくつか記載します。

Bitbucket Cloud には CI ツールが統合されており、デプロイ可能な権限も設定することが可能といったメリットがあります。

また 最近のリリースと今後の新機能への取り組み に記載されているように、Bitbucket Cloud には今後も新しい機能が多く追加されていく見込みです。

Bitbucket Cloud Migration Assistant で移行できる情報も今後増えていくことで移行時のオーバーヘッドは減り、インスタンスの管理が不要な Cloud を使用する意義は大いにあるのではないでしょうかないでしょうか。

■移行に困らないために

現時点では Bitbucket Cloud Migration Assistant による移行は完全ではありませんが、お客様からのフィードバックにより改善されていくと思います。

まずは移行に対して何が問題となるのかを把握するために Bitbucket Cloud Migration Assistant で移行を試していただくことは有意義かと思います。

Bitbucket Cloud Migration Assistant による移行ができなくても、リポジトリインポーター を使用したり手動でのプッシュなどで移行する方法もあります。

リックソフト株式会社では、お客様のクラウド移行に対して、相談窓口や無料の簡易診断を行なっておりますので遠慮なく相談ください。

アトラシアン製品 (Jira , Confluenceなど) の 移行に関するお問い合わせ・ご相談窓口