Notebooks API を使用して以前のインスタンスを登録する

このページでは、以前のユーザー管理のノートブックインスタンスを Notebooks API に移行して登録する方法を説明します。Compute Engine API を使用して作成されたインスタンスを以前のインスタンスと呼びます。以前のインスタンスは、最新の機能を備えているわけではありません。

Notebooks API で使用可能な新機能を使用するには、Notebooks API に以前のインスタンスを登録する必要があります。以前のインスタンスを登録する前に、インスタンスが要件を満たしているかどうか確認してください。要件を満たしていないインスタンスを移行できます。

以前のインスタンスを登録する前に Notebooks API を有効にすると、Notebooks API のアクティベーションプロセスで以前のインスタンスが自動的に登録されます。

要件と制限事項

以前のインスタンスを Notebooks API に登録する前に、次の要件と制限事項を考慮してください。

移行元と移行先のゾーンは一致しており、Notebooks API の有効なゾーンであることが必要です。

たとえば、us-west1-a にあるユーザー管理のノートブックのレガシーインスタンスは、Notebooks API に登録されると us-west1-a に残ります。ただし、us-central1-f にある以前のユーザー管理のノートブックインスタンスは、Notebooks API に登録されません。これは、us-central1-f が Notebooks API の有効なゾーンではないためです。

Notebooks API ノートブックインスタンスの有効なゾーンを確認するには、任意のターミナルまたは Cloud Shell で Google Cloud CLI を使用して、次のコマンドを実行します。
```
gcloud notebooks locations list
```
以前のインスタンスのゾーンが Notebooks API で有効なゾーンでない場合は、サポートまたはアカウントマネージャーにお問い合わせください。以前のインスタンスを新しいユーザー管理のノートブックインスタンスに移行することもできます。
ユーザー管理のノートブックの機能を利用できるのは、デュアルディスクインスタンスのみです。

単一ディスクのユーザー管理のノートブックのレガシーインスタンスの一部は、Notebooks API に登録された後も、自動アップグレードなどの一部の Notebooks 機能を使用できません。単一ディスクの以前のインスタンスで利用可能なすべての機能を使用できるようにするには、単一ディスクのインスタンスをデュアルディスクインスタンスに移行する必要があります。

以前のインスタンスから Notebooks API に登録されたインスタンスに移行する際に、単一ディスクインスタンスをデュアルディスクインスタンスに移行できます。以前のインスタンスを Notebooks API に登録した場合も、インスタンスを新しいデュアルディスクインスタンスに移行して問題を解決できます。

ディスクの数を確認するには、次の手順を行います。
コンソール
1. Google Cloud コンソールで、[VM インスタンス] ページに移動します。
  
  [VM インスタンス] に移動
2. 現在のユーザー管理のノートブックの以前のインスタンスを探します。
3. インスタンス名をクリックして、[VM インスタンスの詳細] ページを開きます。
4. [ブートディスク] セクションと [追加ディスク] セクションで、VM にアタッチされているディスクの数を確認します。
gcloud
1. Cloud Shell、または Google Cloud CLI がインストールされている環境で、次の Google Cloud CLI コマンドを入力します。
  gcloud compute instances describe MY_INSTANCE_NAME \ --zone=MY_ZONE
  次のように置き換えます。
  - MY_INSTANCE_NAME: インスタンスの名前
  - MY_ZONE: インスタンスのゾーン
2. disks: の後の情報を確認し、VM にアタッチされているディスクの数を確認します。

以前のインスタンスを新しいユーザー管理のノートブックインスタンスに移行する

以前のユーザー管理のノートブックインスタンスが Notebooks API に無効なゾーンにある場合、または単一ディスクのインスタンスからデュアルディスクインスタンスに移行する場合は、ユーザー管理のノートブックインスタンスを作成して、以前のインスタンスから新しいインスタンスにユーザーデータをコピーする必要があります。

ユーザー管理のノートブックインスタンスを作成し、以前のインスタンスから新しいインスタンスにユーザーデータをコピーするには、次の手順を行います。

ssh を使用して以前のインスタンスに接続するには、Cloud Shell または Google Cloud CLI がインストールされている環境で、次の Google Cloud CLI コマンドを入力します。
```
export PROJECT_ID="MY_PROJECT_ID"
export ZONE="MY_ZONE"
export INSTANCE_NAME="MY_INSTANCE"
gcloud compute ssh \
    --project $PROJECT_ID \
    --zone $ZONE $INSTANCE_NAME \
    -- -L 8080:localhost:8080
```
次のように置き換えます。
- MY_PROJECT_ID: Google Cloud プロジェクトの ID
- MY_ZONE: インスタンスのゾーン
- MY_INSTANCE: インスタンスの名前とその関連情報
以前のインスタンスの内容を Cloud Storage バケットにコピーするには、gcloud storage を使用します。次のコマンドの例では、すべてのノートブック（.ipynb）ファイルをデフォルトのディレクトリ /home/jupyter/ から my-bucket/legacy-notebooks という Cloud Storage ディレクトリにコピーします。
```
gcloud storage cp /home/jupyter/*.ipynb gs://my-bucket/legacy-notebooks/ --recursive
```
以前のインスタンスと同じハードウェア仕様でユーザーマネージドインスタンスを作成します。インスタンスの作成は、Google Cloud コンソールまたは Google Cloud CLI を使用して作成できます。

この例では、Vertex AI Workbench は、最新の TensorFlow 2 イメージと us-west1-a ゾーンにある n1-standard-1 マシンタイプを使用して、example プロジェクト内に new-notebook というユーザー管理ノートブックインスタンスを作成します。

Cloud Shell、または Google Cloud CLI がインストールされている環境のいずれかで、次の Google Cloud CLI コマンドを入力します。
```
gcloud notebooks instances create new-notebook \
    --vm-image-project=example \
    --vm-image-family=tf-latest-cpu \
    --machine-type=n1-standard-1 \
    --location=us-west1-a
```
ユーザー管理のノートブックインスタンスはデュアルディスクです。デュアルディスクには、ブートディスクとデータディスクがあります。
ssh を使用して、作成したユーザー管理のノートブックインスタンスに接続します。
Cloud Storage バケットから以前のインスタンスの内容を新しいインスタンスにコピーするには、gcloud storage を使用します。次のコマンドの例では、すべてのノートブック（.ipynb）ファイルを Cloud Storage ディレクトリから新しいインスタンスの /home/jupyter/ ディレクトリにコピーします。
```
gcloud storage cp gs://my-bucket/legacy-notebooks/*.ipynb  /home/jupyter/ --recursive
```
新しいユーザー管理のノートブックインスタンスで JupyterLab を開き、ユーザーデータとアセットが正常にコピーされていることを確認します。
（省略可）以前のインスタンスを削除します。