Watson  Machine Learning v1 -> v2 マイグレーション方法

# はじめに
別記事
[2020年9月 Watson Machine Learning仕様変更まとめ](https://qiita.com/makaishi2/private/233d8be9cfb7889df4e0)
[Watson Machine Learning v2のREST APIをPythonで呼び出す](https://qiita.com/makaishi2/items/c6cd88c29f4c705fce8b)
の続編です。

Watson Machine Learningでは2020年9月にV1からv2に大きく変更がありました。
既存のすべてのインスタンスは最終的にv1からからv2に移行する必要があります。
この記事では、その具体的な手順について説明します。

当記事を書くにあたっては、以下の記事を参考にしています。
https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/migrating-assets.html

# 前提
Watson Machine Learningの**Standard Plan**を使っている場合を例に説明します。
無料の**Lite Plan**の場合、最後に説明するインスタンスのアップグレードは、すでにシステム側で自動的に行っています。なので、資産のアップグレード対応のみ行う形になります。

# 最初の状態
9月以降にStandard Planのプロジェクトを立ち上げると、次のようなワーニングメッセージが画面上部表示されます。

![スクリーンショット 2020-09-11 10.54.17.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/206130/58f64fe2-eb69-4da0-e090-94243a8d25b9.png)

この場合
1. 資産のマイグレーション
2. インスタンスのマイグレーション
を順に行う必要があります。

# 1. 資産のマイグレーション
プロジェクトの「**資産**」タブを開き、画面を下にスクロールして「**モデル**」の欄を表示します。

下のような画面が表示されているはずなので、「**Migrate now**」のボタンをクリックします。

![スクリーンショット 2020-09-11 10.55.32.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/206130/4ec128da-10d5-5f01-dbf8-ac9ae5924773.png)

次のようなマイグレーション対象選択の画面になります。すべての資産が選ばれている状態で、画面右下の「マイグレーション」をクリックします。

![スクリーンショット 2020-09-11 10.55.54.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/206130/c4b6acd8-2472-aef5-fdad-e69059e71263.png)

下のようなパネルが表示されるので、閉じずにしばらく待ちます。

![スクリーンショット 2020-09-11 10.56.20.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/206130/de1238a8-8ae8-e323-d691-c61e5f2a3402.png)

マイグレーションが完了すると、画面は下のように変化します。左側の「**View sumamry**」ボタンをクリックして下さい。

![スクリーンショット 2020-09-11 10.56.43.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/206130/311a9b88-1429-26f0-22e3-d7bf5e7ceeb3.png)

この場合だと、選択した2つのモデルがマイグレーションに成功したことが次の画面でわかります。この点を確認した上で、画面を終了させて下さい。

![スクリーンショット 2020-09-11 10.57.02.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/206130/29933647-8fb3-9825-28ef-9b1d418b72aa.png)

次のステップは、インスタンスのマイグレーションになります。
そのための準備として、**設定タブ**の**関連サービス**の欄を見て、Watson Machine Learningのインスタンス名を確認して下さい。
下の画面の例だと``pm-20-iw``が、その名前になります。
また、この画面の表示から、現在のインスタンスがマイグレーションが必要な状態であることもわかります。

![スクリーンショット 2020-09-11 11.14.43.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/206130/0ea703c3-73f8-b192-e755-83e86d2c31dc.png)

# 2. インスタンスのマイグレーション

## インスタンス管理画面の表示
以下のリンク先で、IBM Cloudのリソース一覧を表示させます。

https://cloud.ibm.com/resources

![スクリーンショット 2020-09-11 11.20.13.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/206130/7a2174c3-4de3-8201-3352-1a87c244c6e1.png)


次に検索窓に``pm-20-iw``を入力して該当インスタンスを絞り込みます。

最後に、インスタンス名のところがリンクになっているので、ここをクリックします。

## プランのマイグレーション

インスタンスの管理画面になったら、左側のメニューを「**プラン**」にします。

![スクリーンショット 2020-09-11 11.20.39.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/206130/a50af02c-7e5f-e334-110b-88c0e45b8197.png)

右の画面を下にスクロールすると、**v2 standard**というプランが出てくるので、これを選択します。

![スクリーンショット 2020-09-11 11.20.46.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/206130/4cf52368-a8af-59cb-ae74-1bdc86b6fa41.png)

最後に画面を一番下までスクロールさせて「変更」ボタンをクリックします。
下のような確認画面が出てくるのでOKをクリックして下さい。

![スクリーンショット 2020-09-11 11.20.59.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/206130/a2f14a01-89f0-8ae1-9823-3765dc1d6dcb.png)

これでインスタンスのマイグレーションが開始されます。
下の画面は、マイグレーションが完了した後の、設定タブの様子です。先ほど出ていた「マイグレーションが必要」というメッセージがなくなっていることがわかります。

![スクリーンショット 2020-09-11 11.22.34.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/206130/7eee9dcf-5647-ddbd-c710-8c85ea8252c0.png)

以上で、インスタンスのマイグレーションは完了です。

# マイグレーション後に必要なこと
新しいv2環境でWatson MLを利用するためには、デプロイメントスペースを新たに作ってWatson MLとの紐付けを行う必要があります。

# その他の注意点
基本的なマイグレーションは、今まで説明した方法で可能なのですが、一部の資産については、手動での対応が必要な場合があります。
詳細については、下記資料を参考として下さい。

https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/migrating-assets.html