まだ間に合う!! JazzHub上で管理されているプロジェクトの移行(2017/7/5までに要対応)

IBM Bluemix上のIBM Bluemix DevOps ServiceでJazzHubをご利用されている皆様、2017/7/5でサービスが終了になる旨はメールやJazzHubのWebサイトで通知されておりますので、ご存知のことと思います。

今回は後継となるContinuous Deliveryサービスへのマイグレーションについてその方法を簡単にまとめました。移行期限までおよそ1週間しかありませんが、作業自体は10分程度で終わるので、あきらめずにマイグレーションにトライいただければと思います。

# JazzHubサービスは2017/7/5で提供終了。後継はContinuous Deliveryサービス。

既存のJazzHubサービスは、IBM RationalのCollaborative Lifecycle Management製品群などで用いられているJazzのテクノロジーに基づいた機能のうち変更管理・構成管理機能を提供しています。構成管理機能としてはJazzがもつSCM機能とGitレポジトリーを持ち、GitHubとの連携も行う事ができます。
これらの機能はContinuous DeliveryサービスがもつGit Repos and Issue Trackingツールに移行可能です。その手順は後ほどご説明致します。また、Web IDEやDelivery Pipelineなどの機能もそのままContinuous Deliveryサービスから利用可能で、従来の機能をほぼ損なうことなく、今後もご利用いただけます。
Continuous DeliveryサービスではToolchainと呼ばれる開発から運用までのさまざまなツール統合を円滑に行う仕組みを提供します。これはお客様がご利用されている開発ツールやCI/CDツールとBluemixを組み合わせてご利用いただけることを目的としており、オープンソースのツールやIBM製品との統合が可能です。

2017年6月29日現在利用可能なツールは以下の通りです。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/31115c24-bbde-5ede-3e19-62a7feab73ca.png)


#移行の手順

ここからは移行の手順を説明してまいります。Bluemix上で稼働するCloud Foundryアプリケーションで、構成管理にGitを使用し、Delivery Pipelineサービスを使ってアプリケーションのリリースまでを行うようなプロジェクトを対象としています。

マイグレーションを実施すべきプロジェクトを把握するため、既存のJazzHubプロジェクトは https://hub.jazz.net/ からアクセス可能です。
プロジェクトの画面リスト上で、移行可能なプロジェクトは"Ready To Upgrade"、すでに移行済みのプロジェクトは"Upgraded"と表示されます。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/81cefb47-bdb9-50bd-7f8c-102656516fb2.png)

上の図で移行したいプロジェクトの名称部分(グレーの枠でマスクしている部分のうち右側)をクリックします。
プロジェクトの概要ページが表示されますが、画面上部にある"upgrade now"の部分(以下の図で緑色の枠で囲った部分)をクリックします。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/6a26cb0f-c2f3-b59d-15d7-cc612cd107ec.png)

「ツールチェーンへのアップグレード」画面が表示されます。「組織」と「ツールチェーン名」を指定します。特に「組織」は複数の「組織」にアクセスできる方の場合、注意が必要です。このプロジェクトが所属すべき「組織」をリストから正しく選択する必要があります。ツールチェーン名は迷った場合、従来のプロジェクト名と同じにするのがよいかもしれません。
「組織」と「ツールチェーン名」を選択した後は画面をスクロールさせて下の方にある設定を続けます。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/f3fed075-d843-3857-609b-8297fb476168.png)

続いて「Git Repos and Issue Tracking」の設定を行います。
設定値のままで構いませんが、一番下にある「コード変更のデプロイメントを追跡」について、リリース時にどういう変更を含むのかを管理する構成管理機能と変更管理機能を連携させている場合にはチェックを入れます。「Eclipse Orion Web IDE」と「Delivery Pipeline」には設定すべき項目がありません。
これで設定は終わりですので、「作成」をクリックします。
(2017/06/30追記)
Track and Planの変更管理機能に関する設定画面がこの例ではなかったので、一つ下に追加スクリーンショットを追加しました。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/44be2c66-a8d4-7e49-9dda-ea062e7be6a7.png)
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/56b0f199-6b14-5ee3-bbfe-c14e21b266ab.png)


作成処理が終わると以下のような画面が表示されます。この時点ではまだマイグレーションが完了していない可能性があります。「Git Repos and Issue Tracking」の機能へはマイグレーションが完了してからアクセスするようにしてください。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/5e43304f-03d2-eb92-ba61-f72f8d63b918.png)

プロジェクト一覧のページ (https://hub.jazz.net) で、状態が"Upgrading"のと表示されている間はマイグレーション中です。完了すると"Upgraded"となります。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/297dad82-1801-4be9-41bc-d046fad415d6.png)

(2017/6/30追記)
ちなみにエラーが発生した場合には以下のような画面となります。
トラブルシューティングのページ (https://console.bluemix.net/docs/services/ContinuousDelivery/upgrade_projects.html#upgrade_troubleshoot) を確認いただき、移行を行うための条件が整っているかなどをご確認ください。 
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/25aa5f51-f5b5-bbde-5b88-20ebffa94d1e.png)
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/3ffd28ea-02db-8a5f-9176-b5fda6a53491.png)

これで作業は完了です。

# Continuous Deliveryサービスへのアクセス

移行作業は終わったので、従来のIBM DevOpsサービスで利用できた機能へのアクセス方法をご紹介しておきます。
Bluemixのコンソール (https://console.bluemix.net) で左上にあるハンバーグ・メニュー(緑色の枠で囲った部分)をクリックします。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/a97665d3-a7f0-db10-cee3-e6da3a776598.png)

メニューから"サービス"を選択します。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/515c285c-f8d6-7852-bf3e-8495548a0bd0.png)

メニューの内容が更新されるので"DevOps"を選択します。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/35533330-79fb-daae-cd84-9e628e0c5e05.png)

「ツールチェーン」のページが表示されるので、先ほど作成したツールチェーンの名前をクリックします。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/cee33663-c7a1-2a04-878b-1a98b84ca82e.png)

さきほど新しいツールチェーンを作成したあとに表示されたのと同じ画面にたどり着きました。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/e6ae6f96-dcc3-1e60-a1f2-ec445d01665e.png)

## Continuous Delivery上の各機能へのアクセス 
### Issues
Issuesをクリックすると、"Git Repos and Issue Tracking"の変更管理機能の画面が表示されます。従来のJazzHubのチケット管理で付与していた属性はラベルとして移行されます。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/60235f4d-98a6-643a-e8ae-d790b550b916.png)

### Git
Gitをクリックすると"Git Repos and Issue Tracking"のプロジェクト概要ページが表示されます。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/06bb73a7-555f-8232-26c7-c2feba05f958.png)
Eclipseなどの外部のIDEを使用している場合には個人用のアクセス・トークンの作成が必要となります。詳しくは以下のリンクをご参照ください。
https://console.bluemix.net/docs/services/ContinuousDelivery/git_working.html#git_working

### Web IDE
Web IDEをクリックすると従来のWeb IDEと同様の画面が表示されます。
Delivery Pipelineへのリンクは廃止されていますが、他はほぼ同じです。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/076e20db-2ce9-919f-89df-97f58e840a8d.png)


### Delivery Pipeline
Delivery Pipelineをクリックすると従来のDelivery Pipelineと同様の画面が表示されます。従来と同じ使い勝手でご利用いただけます。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/83689/a5040806-4c94-c3b5-9faa-3e3f2a3b184e.png)

# まとめ
今回はJazzHub上で管理されているプロジェクトのContinuous Deliveryへの移行方法をご説明いたしました。万が一移行がうまくいかない場合にはBluemixコンソール上のサポート・メニューからBluemix supportに早期にご連絡いただきますよう、お願い致します。